機能フラグ

どのようなものか

機能フラグは、アプリを再ビルドせずにチームが変えられる設定を読む、
コード内の判断箇所です。その背後には、すでに本番へ配備されていても、
設定で有効にするまでは動かない、新しい処理経路があります。全員に有効
にすることも、選んだ利用者だけに有効にすることもできます。Pete
Hodgsonは、Martin
Fowlerのサイトで、2016年1月から連載形式で詳しく説明し、2017年10月に
改訂しました。Hodgsonはfeature
togglesと呼び、feature flags、feature bits、feature
flippersも、同じものの別名として挙げます。

Hodgsonは、フラグをいくつかの部分に分けます。トグルポイントは、新し
い経路が有効かを尋ねる、コード内の箇所です。トグルルーターが、トグル
設定から答えを決めます。誰が尋ねるかで答えが変わる場合は、トグルコン
テキストも使います。通常は現在の利用者で、利用者を表す特別なCookieや
HTTPヘッダーを使うこともあります。Hodgsonは、この二つを密結合させな
いよう警告します。トグルポイントのコードは、この注文確認に新しいキャ
ンセル用リンクを含めるか、といった、対象を絞った質問をするべきです。
答えを決める規則は、ルーターの背後の一か所へ置きます。すべての呼び出
し箇所に触れずに、規則を変えられるためです。

フラグは、存続する期間と答えが変わる頻度によって異なり、Hodgsonは四
種類に分けます。リリーストグルは、未完成で未テストのコードを、休眠状
態のまま本番へ配備できるようにします。「通常は、一、二週間を大きく超
えて残すべきではない」と述べます。実験トグルは、A/Bテストのために利
用者を分け、同じ利用者を毎回同じグループへ入れます。運用トグルは、本
番でのシステムの振る舞いを、運用担当者が変えられるようにします。多く
は短命ですが、一部の長く使う停止スイッチは、異常な高負荷のときに、な
くても動く機能を縮小します。生成にかかる処理の負担が大きい推薦パネル
などです。Hodgsonは、手動で管理するサーキットブレーカーに例えます。
権限トグルは、有料顧客向けのプレミアム機能や、自社従業員向けのアル
ファ版機能など、各利用者に見せる機能を決め、何年も残る場合がありま
す。

機能フラグとカナリアリリースは、よく併用されますが、別のものです。カ
ナリアは、サービスの二つのバージョンを並行して動かし、一部のトラ
フィックを新しい方へ送ります。フラグは、両方の経路を含む一つのバー
ジョンを配備し、リクエストごとに選びます。バージョン管理の長期ブラン
チも、新しい仕事を分けておきますが、本番へ届くのは、ブランチをマージ
したとき、一度にすべてです。

なぜ重要なのか

フラグを使う主な理由は、配備と公開を分けることです。Hodgsonは、リ
リーストグルを、継続的デリバリーの原則を実践する最も一般的な方法と説
明します。機能の公開と、そのコードの配備は、別の段階です。一つのメイ
ンブランチから毎日、本番へコードを出しながら、一か月かけて作る機能
は、準備できるまで無効にしておけます。これが、トランクベース開発を可
能にします。

フラグは、利用者によって答えを変えられるため、公開範囲を段階的に広げ
られます。Hodgsonは、まず社内の利用者へ有効にする方法を、Champagne
Brunchと呼びます。会社が先に、自分たちのシャンパンを飲むためです。次
は、カナリアの対象グループです。例では、利用者IDの剰余で無作為に1%を
選び、同じ人がグループに残るようにし、ほかの99%は従来の振る舞いを保
ちます。そのグループから問題の報告があれば、フラグを無効にすればよ
く、配備をロールバックする必要はありません。

代償もあります。フラグごとに、コードの分岐と、テストする組み合わせが
増えます。その設定も、ビルドなしに変えられる、本番の一部になります。
Hodgsonは、可能なフラグでは、設定をソース管理に置き、再配備を通じて
変えるよう勧めます。コードと同じパイプラインを通り、変更をレビュー
し、記録するためです。運用トグルなど、数分以内に変える必要のあるフラ
グでこそ、実行時の設定が役立ちます。

実際の活用例

flagdは、OpenFeature仕様に従う、オープンソースのフラグ評価エンジンで
す。利用者向けの画面を持たず、自分自身では何も保存しません。JSONファ
イルなどのソースからフラグの定義を読み、サイドカー、アプリのプロセス
内、中央のサービスのいずれかとして、リクエストへ答えます。約二十人に
一人を新しい購入手続きへ送るフラグは、次のようになります。

```json
{
  "$schema": "https://flagd.dev/schema/v0/flags.json",
  "flags": {
    "new-checkout": {
      "state": "ENABLED",
      "variants": {
        "on": true,
        "off": false
      },
      "defaultVariant": "off",
      "targeting": {
        "fractional": [
          ["on", 5],
          ["off", 95]
        ]
      },
      "metadata": {
        "owner": "checkout",
        "expires": "2027-01-31"
      }
    }
  }
}
```

各フラグには、状態と、すべて同じ型でなければならない選択肢の集合があ
ります。既定の選択肢の指定は任意です。`fractional`規則は、相対的な重
みで利用者をバケットへ分けるため、5と95なら、約二十人に一人が`on`に
なります。既定では、フラグのキーと、評価コンテキストの`targetingKey`
からバケットを計算します。同じ利用者は常に同じ答えを得ますが、フラグ
の名前を変えると、全員の振り分けが変わります。`metadata`には、チーム
がフラグへ付けたい情報を入れます。ここでは担当者と、削除すべき期限で
す。`state`を`DISABLED`にすると、flagdは値を返さず、呼び出し側が自分
の既定値へ戻ります。

そのファイルを使ってflagdを起動し、HTTPで答えを求めます。

```sh
flagd start --uri file:./flags.json
curl -X POST "localhost:8013/flagd.evaluation.v1.Service/ResolveBoolean" \
  -H "Content-Type: application/json" \
  -d '{"flagKey":"new-checkout","context":{"targetingKey":"user-4711"}}'
```

応答には、値、選択肢、理由の`TARGETING_MATCH`が入ります。アプリで
は、フラグのキー、既定値の`false`、評価コンテキストを、OpenFeatureク
ライアントへ渡します。トグルポイントが見るのは、真か偽だけです。対象
を5%から20%へ広げる変更は、フラグのファイルの編集で、アプリのビルド
の変更ではありません。

2025年からの職務で手がけた採用と船員のキャリア用ワークスペースは、記
録された実装時点でのリリースフラグの例です。採用側は稼働中で、キャリ
ア側は機能フラグの下にあり、公開が未完了と説明します。これは過去の実
装時点の記録で、現在の配備状態を示すものではありません。同じ年からの
職務で手がけた運用担当者用の管理画面で、このようなフラグを変えます。
技術者が本番データベースを手で編集する代わりに、運用担当者が画面から
切り替え、一部の利用者だけへ機能を有効にします。変更は、そこでのほか
の操作と同じように、認可し、記録します。

問題が起きるところ

フラグが、いつまでも残ります。
役目を終えたリリースフラグは、負担だけになります。不要な分岐、誰もテ
ストしない経路、誤って切り替えられる設定が残ります。Hodgsonは、保守
の負担がかかる在庫として扱い、小さく保つよう勧めます。導入した瞬間に
削除タスクをバックログへ入れる、期限を付ける、期限を超えたらテストを
失敗させるかアプリの起動を止める仕掛けを置く、総数に上限を設け、一つ
加えたら一つ消す、といった対処です。フラグを削除するときは、判定だけ
でなく、選ばれなくなった経路も消します。

古いフラグに、新しい意味を与えます。 2012年8月1日、Knight
Capitalの自動注文ルーター、SMARSは、45分間に何百万もの注文を市場へ送
り、同社は4億6,000万ドルを超える損失を出しました。SECの命令書が、経
緯を示します。New
York Stock ExchangeのRetail Liquidity
Program用の新しいコードは、受信する注文に含まれるフラグを再利用しま
した。かつては、2003年に使用をやめたものの削除していなかったPower
Pegという機能を、有効にするフラグでした。配備から八台中一台が漏れ、
そのサーバーでは、古い機能が動き出しました。その後、担当者がほかの七
台から新しいコードを消すと、そこでもPower
Pegが有効になりました。使い終えたフラグへ新しい意味を与えず、守って
いた不要なコードも一緒に消し、有効にする前に、全サーバーが同じビルド
で動くか確かめます。

誰も試していない組み合わせがあります。
二つのフラグで四通り、十個で千通りを超えます。Hodgsonは、組み合わせ
の爆発と呼びます。全通りをテストできることは、めったにありません。本
番へ届く組み合わせを試します。現在の本番設定で、公開予定のフラグを有
効にしたもの、それを無効にした代替設定、そして多くのチームが加える、
すべて有効の設定です。無効は常に既存の振る舞い、有効は新しい振る舞
い、と決めておくと役立ちます。

既定値を、誰も選んでいません。
OpenFeature仕様は、フラグの評価で例外を投げてはならないとします。問
題があれば、呼び出し側が渡した既定値を返し、詳細な結果には、エラー
コードが入ります。クライアントは、ログにも書くべきではありません。フ
ラグの定義より先に配備したアプリが、`FLAG_NOT_FOUND`でログを埋めるの
を避けるためです。アプリは動き続けますが、キーを打ち間違えると、全利
用者へ、気付かれないまま既定値が返ることにもなります。既存の安全な振
る舞いを既定値として渡し、仕様がログの記録場所とするフックを付けま
す。エラーで終わる評価を数え、発生したらアラートを出します。

誰でも設定できる上書きがあります。
特別なCookie、URLのパラメーター、HTTPヘッダーで、テスト担当者がフラ
グを強制的に有効にできると便利です。Hodgsonは、好奇心の強い利用者や
悪意のある利用者も同じ上書きを使い、自分のフラグ状態を変えられると指
摘します。内部のトラフィックだけで受け付けるか、暗号学的に署名しま
す。懸念は和らぎますが、Hodgsonが述べるように、複雑さと攻撃面も増え
ます。

参考資料

  * 機能トグル、別名機能フラグ — Martin FowlerのサイトにあるPete
Hodgsonの記事です。トグルの構成、四分類、テスト、在庫を小さく保つ方
法を扱います。

  * フラグ評価API — 既定値、エラーコード、評価で例外を投げない理由を
含む、OpenFeatureの評価仕様です。

  * flagd：フラグの定義 — flagdが読むJSON形式の、状態、選択肢、既定
の選択肢、対象の指定、メタデータです。

  * flagd：割合による操作 — 決定論的な割合の分割と、利用者が入るバ
ケットを決めるものです。

  * Knight Capital Americas LLCに関する件 —
再利用したフラグを含む、2012年8月の取引損失についての、SECの2013年の
命令書です。

hこのページのウェブ版	URL:https://engineer.company/ja/glossary/feature-flag/	engineer.company	70
