用途:该技能用于指导开发者使用 Contentstack Releases 进行协调、原子的内容部署,适用于需要将多条相关内容一起上线的场景,如营销活动上线、站点改版或协同内容更新,也可用于发布日期安排与 CI/CD 内容部署咨询。不适于日常单条内容的例行发布。
主要能力:提供发布工作流建议;说明 Webhook 风暴风险与缓解方式;在适用时给出 CI/CD 集成模式;明确发布功能限制;提供预发布验证建议。
推荐用法:创建具有描述性名称的发布;将相关条目和资源加入发布,可跨多个内容类型和语言区域;先部署到预发布环境验证,再部署到生产;必要时指定每个条目要部署的版本。CI/CD 方面,可用流水线创建发布、加入变更条目、部署到预发布、运行测试,成功后再部署到生产,并结合分支与别名实现自动化内容部署。
Webhook 风暴:一次发布部署会为每个条目触发一个 Webhook 事件,需提醒防护接收端并做去抖,并检查负载中的 source key;接收端具体处理可参考 Webhooks 技能。
限制:单次 API 调用向发布添加条目最多 100 个;发布标题最长 50 字符;把发布条目更新到最新版本不会自动添加更新条目中的新引用;发布是分支专属的。
定位与安全:该技能仅提供只读建议,不创建、部署或修改发布,仅使用只读工具。不得暴露管理令牌或 API 密钥;示例代码中的凭据应使用环境变量和占位符;浏览器应用须通过服务端代理调用 CMA,不得在客户端硬编码 Stack API 密钥。