SuperAPI AI 工具集

launchdarkly-guarded-rollout

部署与运维

查看项目

更新于 10-15 23:49

技能介绍

用途:引导在 LaunchDarkly 中配置受控发布(Guarded Rollout),即通过多个阶段逐步增加新功能变体的流量,并在每阶段监控选定指标,发现回归时可暂停、通知或回滚。

前提:需在环境中配置远程托管的 LaunchDarkly MCP 服务器。必需工具:start-guarded-rollout(启动带监控的渐进发布)、get-flag(查看标志及其变体)、list-metrics(查找可监控指标)。可选工具:stop-guarded-rollout(立即停止发布)、toggle-flag(启动前确保标志已开启)、create-metric(创建指标)。

核心概念:测试变体为待发布的新变体,控制变体为基线变体;阶段包含递增的流量百分比与监控窗口;指标用于检测回归(如错误率、延迟);回归阈值定义指标可退化程度;触发后可选通知、回滚或两者。流量权重以千分之一为单位:1000=1%、10000=10%、50000=50%、100000=100%。监控窗口以毫秒计:3600000=1小时、86400000=24小时、604800000=7天。

工作流:先用 get-flag 查看标志并记录测试与控制变体 ID,用 list-metrics 找指标,确保目标环境中标志已开启且无进行中的受控发布;再设计阶段(如 1%/1小时、10%/24小时、50%/24小时、100%/24小时);选择指标并设置阈值与触发动作;调用 start-guarded-rollout 传入 projectKey、flagKey、environmentKey、testVariationId、controlVariationId、randomizationUnit、stages 与 metrics;最后用 get-flag 确认发布已激活。停止发布时调用 stop-guarded-rollout,传入项目、标志与环境键,会立即停止并将标志锁定在当前状态。

限制与注意:标志关闭时不能启动发布,需先用 toggle-flag 开启;已有活动发布需先停止;无合适指标需先用 create-metric 创建;环境要求审批时工具会返回审批 URL;不要将回归阈值设为 0;至少配置一个监控指标,否则只是普通发布。