用途:该技能面向 Hex 编排服务的生产部署,通过 Web 端点或定时任务触发 Hex 项目运行,支持 Vercel、Fly.io 和 Cloud Run 三类平台。
主要能力:在 Vercel 上实现按需数据刷新;在 Cloud Run 上以定时编排器方式部署,并可挂载密钥与设置超时。资料中给出的示例包括 Vercel 的 api/refresh.ts 处理器,调用 Hex API 的 /api/v1/project/{projectId}/run 接口并传入 inputParams 与 updateCacheResult,以及添加环境变量命令:
vercel env add HEX_API_TOKEN production
vercel env add HEX_PROJECT_ID production
Cloud Run 部署示例:
gcloud run deploy hex-orchestrator
--image gcr.io/$PROJECT_ID/hex-orchestrator
--set-secrets=HEX_API_TOKEN=hex-api-token:latest
--timeout=600
前置条件:需要已批准的部署变更、密钥引用、项目/目标允许列表,以及不可变的客户端/配置版本;还需安全金丝雀项目、健康/延迟/配额/输出断言基线,以及经过测试的回滚或取消产物。
输出:生成部署回执,包含制品摘要、环境、金丝雀项目、健康/延迟/配额/聚合断言结果、负责人批准、发布状态与回滚引用,但不包含 SQL、输出和密钥。
错误处理:遇到未知项目/目标、未授权范围、金丝雀断言失败、无界重试或遥测中泄露输出时应停止;取消受影响的执行并恢复上一版本,而不是绕过门禁。
适用场景:把 Hex 项目集成到生产数据刷新链路或定时编排任务中。限制:平台细节、收费与更多操作步骤暂未提供。