用途:将容器化 Glean 集成服务部署为定时任务,用于管理文档写入、自定义数据源连接器与搜索查询。
主要能力:提供 Docker 多阶段构建配置,连接 Glean Indexing 与 Search API;通过环境变量配置多数据源索引;/health 端点会调用 Glean getdatasourceconfig 校验 API 连通性与索引状态;提供滚动更新步骤避免打断进行中的索引任务;并给出常见错误(401、403、400、429、结果陈旧)的成因与修复方向。
使用方式:
- 构建镜像:docker build -t glean-integration:latest .
- 运行:docker run -d --name glean-integration -p 3000:3000 -e GLEAN_API_KEY -e GLEAN_BASE_URL -e GLEAN_DATASOURCE -e GLEAN_DOMAIN glean-integration:latest
- 验证:curl -s http://localhost:3000/health | jq . 所需环境变量包括 GLEAN_API_KEY、GLEAN_BASE_URL、GLEAN_DATASOURCE、GLEAN_DOMAIN、LOG_LEVEL、PORT、NODE_ENV。健康检查通过 fetch 调用 Glean 接口并返回状态。
适用场景:需要在 Cloud Run、Lambda 或 Fly.io 上以计划任务方式运行 Glean 自定义连接器,进行受控发布、灰度数据源验证与分级推广的团队。
限制:需前置条件包括已批准部署变更、按环境引用密钥、区分沙箱/预发/生产的目的地允许列表、健康与新鲜度基线、可测试的回滚产物,以及独立金丝雀数据源。需要先创建并注册数据源,否则会返回 403。密钥与索引内容不得写入部署回执。具体收费、价格与各平台详细配置暂未提供。