从 Docker 容器运行

您可以不用从源代码运行连接器服务，而是使用官方 Docker 镜像在容器中运行该服务。

作为前提条件，您需要运行一个 Elasticsearch 和 Kibana 实例。从您的 Kibana UI 内部，您需要按照与从源代码运行服务相同的方式进行初始设置。

当您准备好运行连接器时

步骤 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.0.0 \
/app/bin/elastic-ingest \
-c /config/config.yml

在官方注册表中查找所有可用的 Docker 镜像。

连接器服务运行后，就可以回到 Kibana UI 完成连接器配置。在这一步中，您需要添加有关数据源实例的特定连接详细信息，例如 URL、授权凭据等。如上所述，这些详细信息将根据您连接的第三方数据源而有所不同。

例如，PostgreSQL 连接器需要以下详细信息

现在您已准备好运行同步。在 Kibana UI 中选择 完全同步 按钮开始将文档提取到 Elasticsearch 中。