› › ›

Запуск из исходного кода

Основной способ запуска соединителей — это клонирование репозитория и запуск кода локально. Это хороший вариант, если вы знакомы с Python и хотите быстро итерировать.

Начальная настройка в Kibana

Следуйте пошаговой инструкции Соединителя в интерфейсе Kibana, чтобы выбрать метод ввода Соединителя.

Далее выполните следующие шаги:

Выберите сторонний сервис, который вы хотите использовать, выбрав источник данных.
Создайте и задайте имя нового индекса Elasticsearch.
Сгенерируйте новый ключ API и сохраните его в безопасном месте.
Назовите соединитель и укажите (необязательно) описание.
Преобразовать управляемый соединитель в соединитель под собственным управлением (Применимо только если соединитель также доступен в родной форме). Это действие невозможно отменить.

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

# ...
connectors:
  - connector_id: <CONNECTOR-ID>
    api_key: <API-KEY> # Scoped API key for this connector (optional). If not specified, the top-level `elasticsearch.api_key` value is used.
    service_type: gmail # example

Клонировать репозиторий и изменить `config.yml`

После создания индекса и ввода данных доступа к источнику данных вы готовы развернуть службу соединителя.

Сначала вам необходимо клонировать elastic/connectors репозиторий.

Выполните следующие шаги:

Клонируйте или создайте форк connectors репозитория локально с помощью следующей команды: git clone https://github.com/elastic/connectors.
Запустите make config, чтобы сгенерировать ваш начальный config.yml файл
Откройте файл конфигурации config.yml в вашем редакторе.
Замените значения для host (ваш конечный пункт Elasticsearch), api_key, connector_id и service_type.
Развернуть чтобы увидеть пример config.yml файла
Замените значения для api_key, connector_id и service_type на значения, которые вы скопировали ранее.
```
elasticsearch:
  api_key: <key1> # Used to write data to .elastic-connectors and .elastic-connectors-sync-jobs
                # Any connectors without a specific `api_key` value will default to using this key
connectors:
  - connector_id: 1234
    api_key: <key2> # Used to write data to the `search-*` index associated with connector 1234
                    # You may have multiple connectors in your config file!
  - connector_id: 5678
    api_key: <key3> # Used to write data to the `search-*` index associated with connector 5678
  - connector_id: abcd # No explicit api key specified, so this connector will use <key1>
```
Ключи API для соединителей

Вы можете настроить несколько соединителей в файле config.yml.

Интерфейс Kibana позволяет создавать ключи API, которые ограничены конкретным индексом/соединителем. Если вы не создаете ключ API для конкретного соединителя, используется значение верхнего уровня elasticsearch.api_key или elasticsearch.username:elasticsearch.password.

Если эти учетные данные Elasticsearch верхнего уровня не обладают достаточными привилегиями для записи в отдельные индексы соединителей, вам потребуется создать эти дополнительные, ограниченные ключи API.

Используйте приведенный выше пример в качестве руководства.

Запуск службы соединителя

Для запуска службы соединителей из исходного кода требуется версия Python 3.10 или 3.11.

После настройки кода соединителя вы можете запустить службу соединителя.

В вашей терминале или IDE:

cd в корневой папке вашего connectors клонирования/форка.
Запустите следующие команды, чтобы скомпилировать и запустить службу соединителя:
```
make install
make run
```

Служба соединителя теперь должна работать. Интерфейс позволит вам узнать, что соединитель успешно подключился к вашей Elasticsearch установке.

Напоминание: здесь мы работаем локально. В производственной среде вы развернете службу соединителя на вашей собственной инфраструктуре.

© 2023-2025 Elasticsearch
As of September 2024, Elasticsearch is available under a choice of three licenses: the Server Side Public License (SSPL), the Elastic License, or the AGPLv3 (OSI approved).
Elasticsearch and the Elasticsearch logo are trademarks of Elasticsearch B.V., registered in the U.S. and in other countries.
https://www.elastic.co/guide/en/elasticsearch/reference/8.17/es-connectors-run-from-source.html

Запуск из исходного кода

Начальная настройка в Kibana

Клонировать репозиторий и изменить config.yml

Запуск службы соединителя

Клонировать репозиторий и изменить `config.yml`