SuperAPI AI 工具集

hubspot-prod-checklist

部署与运维

查看项目

更新于 10-15 23:26

技能介绍

用途:该技能提供一套完整的 HubSpot CRM 集成生产部署清单与 go-live 流程,帮助团队在正式上线前完成校验,并在部署后确认服务健康。适用于将 HubSpot 集成部署到生产、准备发布或做上线前检查的场景。

前置条件(资料列为):已在预发环境测试并验证;已创建使用最小权限范围的生产私有应用令牌;已配置部署流水线;已准备好监控与告警。

主要能力与步骤:

  1. 部署前验证:确认生产私有应用使用最小权限;访问令牌存放在密钥管理器而非 .env 文件;.env 已加入 .gitignore;源码中无硬编码令牌(可用 grep -r "pat-na1" src/ 检查);Webhook 端点仅使用 HTTPS 并实现 v3 签名校验;错误处理覆盖 401、403、404、409、429、5xx;实现限流与退避(numberOfApiCallRetries: 3);尽可能使用批量操作(每批最多 100);针对开发者测试账号的测试全部通过。
  2. 健康检查端点:提供基于 @hubspot/api-client 的 hubspotHealthCheck 函数与 /health 路由示例,通过最省的调用(读取 1 条联系人)判断 connected、延迟与限流余量,健康返回 200,degraded 返回 200,unhealthy 返回 503。
  3. 监控告警:定义告警项与严重级别,如 HubSpot 不可达(健康检查连续 3 次失败)、5xx 错误超过 10/分钟、任何 401/403、429 超过 5/分钟(P2)、p95 延迟超过 3000ms(P2)、每日配额剩余低于 10%(P3)。
  4. 优雅降级:提供 withHubSpotFallback 包装函数,调用失败时记录状态、消息与 correlationId,并返回兜底数据,同时标记 degraded。
  5. 部署后验证:给出 post-deploy-verify.sh 脚本,依次检查健康端点、CRM 访问状态码、每日限流余量(x-hubspot-ratelimit-daily-remaining)以及 HubSpot 平台状态页。

限制与注意(资料列为):上线后健康检查失败应立即回滚;生产出现 401 通常表示令牌被重新生成,需更新密钥并重新部署;出现 429 激增说明新代码调用过多,应加入批处理或缓存;HubSpot 返回 5xx 时应查看 status.hubspot.com 并启用降级模式。版本升级见 hubspot-upgrade-migration。其他细节资料暂未提供。