DocsDigest
Back to listLanguage: JA
OpenAICloudflare Developer PlatformJul 16, 2026, 12:00 AM

Flagship - Manage Flagship from the command line with Wrangler

A condensed section focused on the key takeaways first.

Original Post
OpenAIClaude

Quick Digest

Summary

A condensed section focused on the key takeaways first.

openaienmodel: gpt-5-mini-2025-08-07

Flagship - Manage Flagship from the command line with Wrangler

wranglerflagshipclifeature-flagsworkersci/cd

Key Points

  • wrangler flagship CLI for app and flag management
  • create flags (boolean, string, number, JSON) and update defaults
  • rollout, split, and rules for gradual exposure without redeploy

Summary

Wrangler now includes wrangler flagship, a CLI command suite for creating and managing Flagship apps and feature flags directly from your terminal or CI/CD pipelines. You can add a Worker binding in wrangler.json/wrangler.jsonc, create flags (boolean, string, number, or JSON), change defaults, toggle flags as kill switches, and perform gradual rollouts without redeploying your Worker.

Key Points

  • Create an app and add a Worker binding: wrangler flagship apps create "My Worker App" --binding FLAGS --update-config.
  • Create flags with different types: wrangler flagship flags create <APP_ID> <flag-key> --type <boolean|string|number|json>.
  • Change defaults and use kill switches: wrangler flagship flags update <APP_ID> <flag-key> --default <variation>; wrangler flagship flags disable <APP_ID> <flag-key>; wrangler flagship flags enable <APP_ID> <flag-key>.
  • Control exposure and rollout strategies without redeploying: wrangler flagship flags rollout <APP_ID> <flag-key> --to on --percentage 25 --by user_id, wrangler flagship flags split <APP_ID> <flag-key> --weight control=80 --weight treatment=20 --by user_id, and wrangler flagship flags rules update <APP_ID> <flag-key> --priority 1 --when "country equals US".
  • Existing targeting rules remain active unless you explicitly change or clear them.
  • Commands are scriptable and suitable for CI/CD pipelines and automation (including AI agents); see the wrangler flagship command reference for full usage.

Actionable Tips

  • Add the binding to your Worker config with --update-config to make flags available at runtime.
  • Use rollout and split to gradually increase user exposure and test changes safely.
  • Keep rules and priorities documented so disabling or changing defaults doesn't unintentionally override targeting logic.

Full Translation

Translations

A translation section that keeps the flow of the original article.

openaijamodel: gpt-5-mini-2025-08-07

Flagship - WranglerでコマンドラインからFlagshipを管理する

Flagship — WranglerでコマンドラインからFlagshipを管理する

Flagship Wranglerには現在 wrangler flagship コマンド群が含まれており、ターミナルからFlagshipアプリやフィーチャーフラグを管理できます。

概要

  • wrangler flagship を使うと、アプリの作成、フラグの作成・更新、ロールアウトや分割（split）、ルールの編集などをCLIで実行できます。
  • フラグは boolean、string、number、JSON 値などを取れます。
  • これらのコマンドはCI/CDパイプライン、スクリプト、AIエージェントなどからも利用可能です。

アプリの作成とWorkerへのバインド

アプリを作成し、Workerから利用する場合は wrangler.json または wrangler.jsonc にバインディングとして追加できます。例：

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

フラグの作成

制御したい振る舞いごとにフラグを作成します。例：

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

既存フラグの管理（デフォルト変更 / 有効化・無効化）

フラグ作成後はデフォルトバリエーションを変更したり、キルスイッチとして enable / disable を使えます。既存のターゲティングルールは、明示的に変更またはクリアしない限り継続して適用されます。例：

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"

使いどころと参照

  • これらのコマンドは、Flagshipの状態確認、フラグ挙動の更新、変更のロールバックなどにCI/CDやスクリプト経由で組み込めます。
  • 詳細なコマンドガイドは wrangler flagship コマンドリファレンスを参照してください。