Запуск из контейнера Docker

Вместо запуска службы соединителей из исходного кода, вы можете использовать официальный образ Docker для запуска службы в контейнере.

В качестве предварительного условия вам необходимо иметь работающий экземпляр Elasticsearch и Kibana. Из интерфейса Kibana вам необходимо выполнить начальную настройку так же, как если бы вы запускали службу из исходного кода.

Когда вы готовы запустить соединители:

Шаг 1: Скачать файл конфигурации образца

Загрузите файл конфигурации образца. Вы можете загрузить его вручную или выполнить следующую команду:

curl https://raw.githubusercontent.com/elastic/connectors/main/config.yml.example --output </absolute/path/to>/connectors-config/config.yml

Не забудьте изменить значение аргумента --output на путь, куда вы хотите сохранить файл config.yml на вашем локальном компьютере. Но запомните, где вы сохранили этот файл, так как он потребуется на шаге docker run ниже.

Шаг 2: Обновить файл конфигурации для вашего управляемого пользователем соединителя

Обновите файл конфигурации с настройками, соответствующими вашей среде:

Если вы запускаете службу соединителя с Docker-изображениями Elasticsearch и Kibana, ваш конфигурационный файл будет выглядеть так:

# When connecting to your cloud deployment you should edit the host value
elasticsearch.host: http://host.docker.internal:9200
elasticsearch.api_key: <ELASTICSEARCH_API_KEY>

connectors:
  -
    connector_id: <CONNECTOR_ID_FROM_KIBANA>
    service_type: Zoom # sharepoint_online (example)
    api_key: <CONNECTOR_API_KEY_FROM_KIBANA> # Optional. If not provided, the connector will use the elasticsearch.api_key instead

Шаг 3: Запустить Docker-образ

Запустите Docker-образ со службой соединителей с помощью следующей команды:

docker run \
-v "</absolute/path/to>/connectors-config:/config" \ # NOTE: you must change this path to match where the config.yml is located
--rm \
--tty -i \
--network host \
docker.elastic.co/enterprise-search/elastic-connectors:8.17.3 \
/app/bin/elastic-ingest \
-c /config/config.yml

Найдите все доступные Docker-изображения в официальном реестре.

После запуска службы соединителя пора вернуться в интерфейс Kibana, чтобы завершить настройку соединителя. На этом шаге вам нужно добавить конкретные данные подключения к вашему экземпляру источника данных, такие как URL, учетные данные для авторизации и т. д. Как упоминалось выше, эти данные будут различаться в зависимости от стороннего источника данных, к которому вы подключаетесь.

Например, для подключения PostgreSQL требуются следующие данные:

Теперь вы готовы запустить синхронизацию. Выберите кнопку Полная синхронизация в интерфейсе Kibana, чтобы начать импорт документов в Elasticsearch.