› ›

Самоуправляемые соединители

Самоуправляемые Elastic коннекторы выполняются на вашей собственной инфраструктуре. Это означает, что они работают вне вашего развертывания Elastic.

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

У нас также есть вариант быстрого запуска с использованием Docker Compose, для одновременного запуска всех необходимых служб: Elasticsearch, Kibana и службы коннекторов. Дополнительную информацию см. в разделе Быстрый старт Docker Compose.

Доступны следующие коннекторы в качестве самоуправляемых коннекторов:

Требования к доступности и Elastic

Самоуправляемые коннекторы в настоящее время не поддерживают Windows. Используйте эту матрицу совместимости, чтобы проверить, какие операционные системы поддерживаются самоуправляемыми коннекторами. Найдите эту информацию на этой странице в разделе самоуправляемые коннекторы.

Развернуть для получения информации о предварительных требованиях Elastic

Ваше развертывание Elastic должно включать следующие службы Elastic:

Elasticsearch
Kibana

(Новое развертывание Elastic Cloud по умолчанию включает эти службы.)

Для работы самоуправляемых коннекторов версия вашей самостоятельно развернутой службы коннекторов должна соответствовать версии Elasticsearch. Например, если вы используете Elasticsearch 8.10.1, ваша служба коннекторов должна быть версии 8.10.1.x. Elastic не поддерживает развертывания с несовпадающими версиями (кроме случаев обновления).

Начиная с версии 8.10.0, новые самоуправляемые коннекторы больше не требуют службы Enterprise Search. Однако, если вы обновляете коннекторы из версий, предшествующих 8.9, вам нужно будет один раз запустить Enterprise Search, чтобы мигрировать ваши коннекторы в новый формат. В будущих выпусках вам, возможно, все равно потребуется запустить Enterprise Search для целей миграции или обновления.

У вас должен быть доступ к Kibana и иметь write права доступа к индексам для .elastic-connectors индекса.

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

Требования к поддержке и лицензированию

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

Для получения подробной информации обратитесь к следующим страницам подписок. Найдите интересующий вас коннектор в разделе Elastic Search в подразделе Интеграции клиентов:

Обратите внимание на следующую информацию о поддержке самоуправляемых коннекторов:

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

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

Первое решение, которое вам нужно принять перед развертыванием коннектора, — это выбор сторонней службы (источника данных), которую вы хотите синхронизировать с Elasticsearch. Обратите внимание, что у каждого источника данных будут свои конкретные предварительные требования, которые вам необходимо выполнить, чтобы разрешить коннектору доступ к данным. Например, некоторые источники данных могут потребовать от вас создания приложения OAuth или создания учетной записи службы.

Вам необходимо проверить документацию по отдельному коннектору для получения этих деталей.

Разверните службу коннекторов

Служба коннекторов — это приложение Python, которое необходимо запустить на вашей собственной инфраструктуре при использовании самоуправляемых коннекторов. Исходный код размещен в репозитории elastic/connectors.

Вы можете запустить службу коннекторов из исходного кода или использовать Docker:

Запуск коннекторов из исходного кода. Используйте этот вариант, если вы работаете с Python и хотите быстро выполнить итерации локально.
Запуск коннекторов из Docker. Используйте этот вариант, если вы хотите развернуть коннекторы на сервере или использовать платформу оркестрации контейнеров.
- Ознакомьтесь с нашим быстрым запуском Docker Compose для быстрого запуска всех необходимых служб одновременно.

Учебники

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

Эти примеры используют коннектор PostgreSQL, но основной процесс одинаков для всех самоуправляемых коннекторов.

Тестирование коннекторов

Фреймворк коннекторов позволяет выполнять end-to-end (E2E) тесты на ваших самоуправляемых коннекторах, по отношению к реальному источнику данных.

Для предотвращения вмешательства в реальный экземпляр Elasticsearch, E2E-тесты запускают изолированный экземпляр Elasticsearch в Docker. Значения конфигурации задаются в вашем файле docker-compose.yml. Docker Compose управляет настройкой среды разработки, включая как имитационный экземпляр Elastic, так и имитационный источник данных.

E2E-тесты используют стандартные значения конфигурации для коннектора. Инструкции по тестированию см. в документации каждого коннектора.

Фреймворк коннекторов

Фреймворк коннекторов Elastic позволяет:

Настраивать существующие самоходные коннекторы.
Создавать собственные самоходные коннекторы.

Дополнительную информацию см. в Создание и настройка коннекторов.

© 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-build-connector.html