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 コマンドリファレンスを参照してください。