SuperAPI AI 工具集

hex-prod-checklist

部署与运维

查看项目

更新于 10-15 23:26

技能介绍

用途:帮助团队把 Hex(协作式数据分析平台,用于构建笔记本、仪表盘和定时数据管道)的集成安全地部署到生产环境,覆盖部署前检查与回滚流程。

主要能力:认证与密钥方面,要求 HEX_API_KEY 存放在密钥管理器而非配置文件中,令牌仅授予“Run projects”权限,设置超过 90 天的有效期并安排轮换,开发、预发、生产工作区使用独立令牌。API 集成方面,配置生产基址 https://app.hex.tech/api/v1,遵守速率限制(20 次/分钟、60 次/小时),触发运行前确保编排项目已发布,校验输入参数,按可配置间隔轮询运行状态(默认 5 秒),处理大数据集并固定项目版本。错误与韧性方面,配置熔断、对 429/5xx 使用指数退避重试、对 ERRORED 与 KILLED 状态告警并重新入队、检测超时、暴露数据库连接错误、API 不可用时降级返回缓存结果。监控方面,跟踪每次运行的延迟、错误率、运行时长回归、定时运行完成率与配额使用。

使用方式:先确认受保护的生产审批、指定的事件与回滚负责人,以及在沙箱和预发验证过的固定版本;再确认环境、密钥引用、项目范围、产物版本与审批,用有界参数运行金丝雀项目并验证健康状态与聚合输出断言,在观察窗口内监控错误、延迟、配额与取消信号,随后分阶段推广或取消并恢复上一版本,最后在负责人接受脱敏凭据并撤销临时访问后关闭。资料中提供了一段 TypeScript 验证脚本,用于检查 API 连通性、密钥是否存在和剩余速率限制。

限制:上述速率限制、配额、超时与度量阈值均来自该清单的示例设定,实际应以自身计划与工作区情况为准;相关资料未提供具体定价、平台支持范围等信息。数据连接安全与访问控制参见 hex-security-basics。