用途:把使用 Klaviyo 的应用部署到 Vercel、Fly.io 或 Google Cloud Run,并正确配置密钥与健康检查。三个平台流程一致,仅 CLI 命令不同。
主要能力:通过平台密钥存储注入 KLAVIYO_PRIVATE_KEY 与 KLAVIYO_WEBHOOK_SIGNING_SECRET;生成平台配置文件(vercel.json、fly.toml 或 Dockerfile);提供统一的 src/health.ts 健康检查端点;部署后验证 Klaviyo 连通性;Webhook 端点使用 HMAC-SHA256 校验签名。
使用方式:先阅读 references/platform-deployments.md 中目标平台章节,然后依次存储密钥、编写配置、添加健康检查、部署、验证。Vercel 示例:vercel env add KLAVIYO_PRIVATE_KEY production,随后 vercel --prod,再 curl 健康端点。Fly.io 示例:fly secrets set KLAVIYO_PRIVATE_KEY=pk_*** KLAVIYO_WEBHOOK_SIGNING_SECRET=whsec_***,然后 fly deploy。Cloud Run 使用 gcloud secrets create 与 gcloud run deploy --set-secrets。健康检查路径:Vercel 为 /api/health,Fly.io 与 Cloud Run 为 /health。
适用场景:需要将 Klaviyo 集成投入生产、管理生产密钥、验证 Webhook 签名的部署任务。
限制与前提:需 Klaviyo 生产 API 密钥(pk_*)、已安装对应平台 CLI、应用已用 klaviyo-api SDK 测试,并完成 klaviyo-prod-checklist。密钥不得提交到仓库。常见问题包括运行时找不到密钥、冷启动超时(可设 min_instances=1)、Webhook 401(签名密钥不匹配)、健康检查失败(环境密钥混用)。完整配置与代码见 references/platform-deployments.md。