自管理连接器
编辑自管理连接器
编辑自管理的 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 索引权限。
要在自管理环境中使用连接器客户端，必须部署 连接器服务。
支持和许可要求
根据您使用自管理连接器的方式，支持和许可要求会有所不同。
请参阅以下订阅页面了解详情。在 客户端集成 下的 Elasticsearch 部分查找您感兴趣的连接器
请注意以下关于自管理连接器支持的信息
- 已转换但未修改的托管连接器受 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 连接器框架使您可以
- 自定义现有的自管理连接器。
- 构建您自己的自管理连接器。
有关更多信息，请参阅 构建和自定义连接器。