Content last updated 2025-04-28

開発フィーチャーフラグのアーキテクチャ

This page contains information related to upcoming products, features, and functionality. It is important to note that the information presented is for informational purposes only. Please do not rely on this information for purchasing or planning purposes. The development, release, and timing of any products, features, or functionality may be subject to change or delay and remain at the sole discretion of GitLab Inc.
StatusAuthorsCoachDRIsOwning StageCreated
implementedayufanglopezfernandezkencjohnston craig-gomesdevops non_devops2020-06-10

フィーチャーフラグの使用は GitLab の開発において不可欠になっています。フィーチャーフラグは変更を早期にリリースし、機能が安定してパフォーマンスに優れることを確認しながら広い対象者に安全にロールアウトするための便利な方法です。

機能の存在が専用の条件で制御されるため、開発者は機能のテストに最適な時期を選択し、機能が時期尚早に有効にされないようにすることができます。

課題

フィーチャーフラグの広範な使用はいくつかの課題をもたらします

  • コードベースに追加するフィーチャーフラグは、設定の組み合わせマトリックスを追加するため、すべてが ~"technical debt" になります。
  • フィーチャーフラグのすべての組み合わせをテストすることはほぼ不可能なため、代わりに最も一般的なシナリオに対してフィーチャーフラグのテストを最適化しようとします。
  • 増え続けるフィーチャーフラグの保守という課題が増大しています。フィーチャーフラグの設定方法や、なぜまだ削除していないのかを忘れてしまうことがあります。
  • フィーチャーフラグの使用は、~"type::feature" や ~"type::bug" の修正がフィーチャーフラグにどのように依存しているか、またはこのフィーチャーフラグがどのように設定されているかを完全に理解していない可能性がある開発外の人々に混乱をもたらす可能性があります。あるいは、機能がリリース投稿の一部として発表されるべきかどうかも同様です。
  • フィーチャーフラグの保守は、異なる環境 / 対象での異なる設定を管理しなければならないという追加の課題をもたらします。テスト、開発、ステージング、本番用の異なるフィーチャーフラグ設定があり、オンプレミス向けとして顧客にリリースされるものもあります。

目標

フィーチャーフラグの使用に関する最大の課題は、その暗黙性です。フィーチャーフラグはコードベースの一部であり、開発機能の外から理解するのが難しくなっています。

フィーチャーフラグを使った開発を、関心のあるすべての当事者がアクセスできるようにすべきです。

  • 開発者 / エンジニア
    • 新しいフィーチャーフラグを簡単に追加し、その状態を設定できる
    • 別のフィーチャーフラグに触れる場合に誰に連絡すればよいかをすぐに見つけられる
    • 古くなったフィーチャーフラグをすぐに見つけられる
  • エンジニアリングマネージャー
    • 自分のグループが管理するフィーチャーフラグを理解できる
  • エンジニアリングマネージャーとディレクター
    • 管理しなければならないフィーチャーフラグの量による ~"technical debt" の量を理解できる
    • 各リリースで追加・削除されるフィーチャーフラグの数を理解できる
  • プロダクトマネージャーとドキュメントライター
    • どの機能がどのフィーチャーフラグによって制御されているかを理解できる
    • 機能とそのフィーチャーフラグが GitLab.com で一般公開されているかどうかを理解できる
    • 機能とそのフィーチャーフラグがオンプレミスインストールでデフォルトで有効かどうかを理解できる
  • デリバリーエンジニア
    • 連続するデプロイメント間で導入・変更されたフィーチャーフラグを理解できる
  • サポートおよびリライアビリティエンジニア
    • リリース間でフィーチャーフラグがどのように変化したかを理解できる: どのフィーチャーフラグが有効になり、何が削除されたか
    • 進行中のサポートリクエストやインシデントで助けになる可能性のある個人を知るための、フィーチャーフラグに関する関連情報をすぐに見つけられる

提案

上記の目標を実現するために、フィーチャーフラグの使用を明示的にし、すべての関係者が理解できるようにすべきです。

YAML で記述された feature-flags/<name-of-feature.yml> を導入し、以下を可能にします:

  1. すべてのフィーチャーフラグが文書化される中央の場所
  2. 特定のフィーチャーフラグが導入された理由の説明
  3. どの関連 Issue とマージリクエストによって導入されたか
  4. コードベース内のすべてのフィーチャーフラグを含む自動ドキュメントのビルド
  5. 特定のグループに属するフィーチャーフラグの数の追跡
  6. リリース間で追加・削除されるフィーチャーフラグの数の追跡
  7. この情報をすべての人が簡単にアクセスできるようにする
  8. 顧客が機能を有効にする方法を簡単に発見し、異なるリリース間で何が変わったかの情報をすぐに見つけられるようにする

YAML

---
name: ci_disallow_to_create_merge_request_pipelines_in_target_project
introduced_by_url: https://gitlab.com/gitlab-org/gitlab/-/merge_requests/40724
rollout_issue_url: https://gitlab.com/gitlab-org/gitlab/-/issues/235119
group: group::environments
type: development
default_enabled: false

理由

これらの変更が必要な理由:

  • 現在約 500 種類のフィーチャーフラグがある
  • その使用状況の追跡が困難
  • default_enabled: と actors が異なるフィーチャーフラグの曖昧な使用がある
  • 誰が何のフィーチャーフラグを所有し、関連情報をどこで見つけるかの明確な指示がない
  • フィーチャーフラグが実際には ~"technical debt" であることを示すフィーチャーフラグロールアウト Issue 作成の要求を強調していない
  • コードベースに正確にどのフィーチャーフラグがあるかわからない
  • 異なる環境でフィーチャーフラグがどのように設定されているかを正確に知らない: test に何が使用されているか、on-premise に何をリリースしているか、staging、qa、production の設定はどうか

イテレーション

この作業は専用の Epic: フィーチャーフラグの内部使用の改善 の一部として行われています。この Epic はこれらの変更を行うためのメタ理由を説明しています。

最終更新 July 30, 2026: Merge pull request #483 from kyama0/translation/batch-2026-07-29-1 (c955a93f)
ページのソースコードを見る - ページの編集 - please contribute. Creative Commons License