自管理连接器
编辑自管理连接器
编辑自管理 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，并且对 .elastic-connectors 索引具有 write 索引权限。
要在自管理环境中使用连接器客户端，您必须部署连接器服务。
支持和许可要求
根据您使用自管理连接器的方式，支持和许可要求会有所不同。
有关详细信息，请参阅以下订阅页面。在客户端集成下的Elastic Search部分中找到您感兴趣的连接器
请注意有关自管理连接器支持的以下信息
- Elastic 支持转换但未修改的托管连接器。
- Elastic 不支持转换但自定义的托管连接器。
部署连接器服务
编辑连接器服务是一个 Python 应用程序，使用自管理连接器时，您必须在自己的基础设施上运行它。源代码托管在elastic/connectors存储库中。
您可以从源代码运行连接器服务或使用 Docker
- 从源代码运行连接器。如果您对使用 Python 感到舒适并希望在本地快速迭代，请使用此选项。
-
从 Docker 运行连接器。如果您想将连接器部署到服务器或使用容器编排平台，请使用此选项。
- 有关快速启动所有必需服务的方法，请参阅我们的Docker Compose 快速启动。
教程
编辑- 按照我们的基于 UI 的教程学习如何运行自管理连接器服务并设置自管理连接器，使用 UI。
- 按照我们的基于 API 的教程学习如何设置自管理连接器使用 连接器 API。
这些示例使用 PostgreSQL 连接器，但基本过程对于所有自管理连接器都是相同的。
连接器测试
编辑连接器框架使您能够针对真实数据源对自管理连接器运行端到端 (E2E) 测试。
为了避免篡改真实的 Elasticsearch 实例，E2E 测试在 Docker 中运行一个隔离的 Elasticsearch 实例。配置值在您的 docker-compose.yml 文件中设置。Docker Compose 管理开发环境的设置，包括模拟 Elastic 实例和模拟数据源。
E2E 测试使用连接器的默认配置值。在每个连接器的文档中查找有关测试的说明。
连接器框架
编辑Elastic 连接器框架使您能够
- 自定义现有的自管理连接器。
- 构建您自己的自管理连接器。
有关更多信息，请参阅构建和自定义连接器。