# Cloudflare Flagship のフィーチャーフラグ、ターミナルで思いのままに操れるようになったよ！

やっほー、しぃちゃんだよ！今日は Cloudflare の Wrangler がまたひとつ便利になったっていうニュースを見つけたよ！フィーチャーフラグの管理が、ターミナルからサクサクできるようになったんだって！

## なにが発表されたの？

Cloudflare の Changelog で、Wrangler に新しく `wrangler flagship` というコマンド一式が追加されたことが発表されたよ！これを使うと、Flagship のアプリやフィーチャーフラグの管理を、ターミナルから直接できるようになるの。

## なぜ重要なの？

こういうフィーチャーフラグの操作って、ダッシュボードでポチポチ設定するイメージが強いよね。でも今回 Wrangler にコマンドとして入ったことで、CI/CD パイプラインやスクリプト、それに AI エージェントからも Flagship の状態を確認したり、フラグの挙動を更新したり、変更をロールバックしたりできるようになったんだって。

## これで何が変わるの？

手動でダッシュボードを開かなくても、デプロイフローの中にフラグ操作を組み込めるようになるのが嬉しいポイントだよ！CI/CD の中でロールアウトの割合を自動調整したり、異常を検知したスクリプトが自動でフラグを disable してキルスイッチとして使ったり、なんてこともできちゃうの。しかも rollout や split はパーセンテージ単位で細かく制御できるから、新機能をいきなり全員に見せるんじゃなくて、少しずつ安全に広げていけるんだよ。

## 深く潜ってみよう

まずはアプリを作るところから始まるよ。

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

このコマンドで Flagship アプリを作って、Worker から使うときのバインディングも一緒に `wrangler.json`（または `wrangler.jsonc`）に設定できちゃうの。

アプリができたら、次はフラグを作る番だよ。フラグは次の型に対応してるよ。

- Boolean（真偽値）
- 文字列
- 数値
- JSON 値

```bash
wrangler flagship flags create {APP_ID} new-checkout
```

```bash
wrangler flagship flags create {APP_ID} checkout-flow \
  --variation control=old-checkout \
  --variation treatment=new-checkout \
  --default control \
  --type string
```

フラグができたあとは、デフォルトの見せ方を変えたり、キルスイッチとして無効化・有効化したりもできるよ。

```bash
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 を再デプロイしなくても公開範囲を変えられるのがポイントだよ！

```bash
wrangler flagship flags rollout {APP_ID} new-checkout \
  --to on \
  --percentage 25 \
  --by user_id
```

これで `new-checkout` フラグを、user_id 単位で 25 パーセントのユーザーにだけ有効にできるよ。

```bash
wrangler flagship flags split {APP_ID} checkout-flow \
  --weight control=80 \
  --weight treatment=20 \
  --by user_id
```

こっちは `checkout-flow` フラグを、control に 80 パーセント・treatment に 20 パーセントの比率で振り分けるコマンドだよ。

```bash
wrangler flagship flags rules update {APP_ID} checkout-flow \
  --priority 1 \
  --when "country equals US"
```

条件付きのターゲティングルールも作れて、この例だと国が US のユーザーだけに向けたルールを、優先度 1 で設定してるの。

## まとめ

- Wrangler に `wrangler flagship` コマンドが追加されて、Flagship アプリとフィーチャーフラグをターミナルから管理できるようになったよ
- フラグは Boolean・文字列・数値・JSON 値に対応してる
- rollout はパーセンテージ指定、split は重み付け、rules は優先度付きの条件でターゲティングできる
- CI/CD パイプラインやスクリプト、AI エージェントからも呼び出せて、Worker を再デプロイせずに公開範囲を変えられる

Wrangler で Workers を運用してる開発者さんや、feature flag を使った段階的リリースに興味がある人にきっと刺さる発表だよ！