Cloudflare changelogs | Flagship

Flagship - 通过 Wrangler 从命令行管理 Flagship

Thu, 16 Jul 2026 00:00:00 GMT

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

创建一个应用，如果您在 Worker 中使用它，可将其作为绑定（binding）添加到 wrangler.json 或 wrangler.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

对于发布工作流，使用 rollout、split 和 rules 在不重新部署 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 命令参考获取完整的命令指南。

Flagship - Flagship API 参考现已上线

Wed, 10 Jun 2026 00:00:00 GMT

Flagship API 参考 现已上线。您可以使用 Cloudflare API 创建和更新应用，以及在不使用仪表板的情况下创建、更新、删除和列出功能标志。

例如，使用 API 创建一个新的布尔标志：

curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/flagship/apps/$APP_ID/flags \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
  -d '{
    "key": "new-checkout",
    "enabled": true,
    "default_variation": "off",
    "variations": {
      "off": false,
      "on": true
    },
    "rules": []
  }'

要创建 API token，请前往 Cloudflare 仪表板中的账户 API Tokens ↗ 并搜索 Flagship。

API 参考包含 Flagship 应用、标志、更新日志条目和标志评估的端点。Agent 还可以使用 Cloudflare skill 中的 Flagship 参考 ↗ 创建和管理 Flagship 资源。

请参阅 Flagship 文档以了解有关从应用程序评估功能标志的更多信息。

Flagship - Flagship 现已进入公开 Beta

Tue, 26 May 2026 00:00:00 GMT

Flagship 现已进入公开 Beta。无需出站 HTTP 调用，即可直接在 Cloudflare Workers 中评估功能标志，使用由 Workers KV 和 Durable Objects 支持的全球分布式标志配置。Flagship 支持类型化标志值、定向规则、百分比灰度发布、审计历史记录，以及兼容 OpenFeature 的 SDK。

只需几行代码，即可在 Worker 中评估标志：

src/index.jsjs

export default {
	async fetch(request, env) {
		const showNewCheckout = await env.FLAGS.getBooleanValue(
			"new-checkout",
			false,
		);

		return new Response(showNewCheckout ? "New checkout" : "Standard checkout");
	},
};

src/index.tsts

export default {
	async fetch(request: Request, env: Env): Promise<Response> {
		const showNewCheckout = await env.FLAGS.getBooleanValue("new-checkout", false);

		return new Response(
			showNewCheckout ? "New checkout" : "Standard checkout",
		);
	},
} satisfies ExportedHandler<Env>;

立即在 Cloudflare 仪表板中开始创建标志。请参阅 Flagship 文档以快速入门。