SuperAPI AI 工具集

glean-multi-env-setup

数据与分析

查看项目

更新于 10-15 23:26

技能介绍

用途:为 Glean 企业搜索搭建多环境隔离配置,防止测试数据污染生产搜索结果。每个环境使用各自的数据源名称、API 令牌和连接器配置。

主要能力:提供按环境返回配置的 gleanConfig 函数(development/staging/production 分别对应 sandbox/staging/app 的 baseUrl 与 _sandbox/_staging/_prod 数据源后缀);提供 validateGleanEnv 校验必需环境变量;给出晋升工作流,包括在 sandbox 索引测试文档、在 staging 验证搜索质量、对比相关性基线、将连接器配置晋升到生产并触发抓取。

使用方式:按环境维护 .env.development、.env.staging、.env.production,设置 GLEAN_API_TOKEN_{DEV|STG|PROD}、GLEAN_BASE_URL、GLEAN_DATASOURCE_SUFFIX、GLEAN_INSTANCE。晋升步骤示例:curl -X POST "$GLEAN_BASE_URL/indexing/datasources/wiki_sandbox/documents" -H "Authorization: Bearer $GLEAN_API_TOKEN_DEV" -d @test-docs.json;node scripts/compare-search-quality.js --env staging --baseline baseline.json;cp connectors/staging/*.json connectors/production/。

适用场景:需要将连接器变更先在 staging 验证再晋升到生产、并保持搜索相关性的团队。

限制与前提:需为 sandbox、staging、production 准备独立凭据、不透明数据源名称和网络目标;每环境需有密钥管理器引用、受保护的晋升审批和可回滚的生产版本;sandbox 使用合成数据,staging 使用经所有者批准的最小样本,禁止将生产凭据或无限制文档复制到 CI。输出晋升回执时排除凭据、文档、查询和真实身份。