跳转到内容
搜索文档

更新日志

Cloudflare 的最新更新与改进。

Back to all posts

通过 Wrangler 从命令行管理 Flagship

Wrangler 现在包含 wrangler flagship,这是一套用于在终端中管理 Flagship 应用和功能标志的命令套件。

创建一个应用,如果您在 Worker 中使用它,可将其作为绑定(binding)添加到 wrangler.jsonwrangler.jsonc 文件中:

wrangler flagship apps create "My Worker App" \
  --binding FLAGS \
  --update-config

然后为您要控制的行为创建标志。标志可以是布尔值、字符串、数字或 JSON 值:

wrangler flagship flags create <APP_ID> new-checkout

wrangler flagship flags create <APP_ID> checkout-flow \
  --variation control=old-checkout \
  --variation treatment=new-checkout \
  --default control \
  --type string

标志创建后,可以更改其默认变体,或使用启用和禁用命令作为开关。除非您明确更改或清除,否则现有的定向规则将继续适用:

wrangler flagship flags update <APP_ID> checkout-flow --default treatment
wrangler flagship flags disable <APP_ID> checkout-flow
wrangler flagship flags enable <APP_ID> checkout-flow

对于发布工作流,使用 rolloutsplitrules 在不重新部署 Worker 的情况下更改曝光量:

wrangler flagship flags rollout <APP_ID> new-checkout \
  --to on \
  --percentage 25 \
  --by user_id

wrangler flagship flags split <APP_ID> checkout-flow \
  --weight control=80 \
  --weight treatment=20 \
  --by user_id

wrangler flagship flags rules update <APP_ID> checkout-flow \
  --priority 1 \
  --when "country equals US"

这些命令也可以在 CI/CD 流水线、脚本和 AI Agent 中使用,通过 Wrangler 检查 Flagship 状态、更新标志行为或回滚更改。

请参阅 wrangler flagship 命令参考 获取完整的命令指南。