← 記事一覧に戻る
テクノロジー

段階リリースでバグの影響を小さく踏む

段階リリースでバグの影響を小さく踏む

バグを出さないことには限界があります。そこで考えたいのが「出てしまったバグを小さく踏む」ことです。全ユーザーに一気にリリースすると、1つのバグが全員に届きます。リリースの段階を刻めば、同じバグでも影響を数%のユーザーで止められます。この記事では、リリース工程で使う「カナリアリリース」と「feature flag」の使い分け、段階の刻み方、切り戻し設計を整理します。

カナリアと feature flag は守る対象が違う

混同されやすい2つですが、切り替える単位が違います。

  • カナリアリリース:新しいバージョンのサーバーやアプリを、一部のトラフィックにだけ流す。単位は「デプロイ(ビルド)」。インフラや依存ライブラリ、起動時の不具合を拾うのに向く
  • feature flag:コードは全員に配り、機能のオン・オフだけをユーザー単位で切り替える。単位は「機能」。デプロイと公開を分離でき、再デプロイなしで止められる

目安は次のとおりです。マイグレーションや設定変更などビルド全体に関わる変更はカナリア、画面や挙動など機能単位の変更は flag を使います。大きな変更は、カナリアで新ビルドの健全性を確認してから flag で機能を段階的に開く、と重ねるのが安全です。

段階の刻み方:例

最初の段階は「壊れても気にならない人数」にします。一例です。

  1. 社内メンバーのみ(dogfooding)
  2. 全体の1%
  3. 5%
  4. 25%
  5. 100%

各段階には「進む条件」と「戻す条件」を、あらかじめ数値で書いておきます。たとえば次のようにします。

進む条件: 30分間、エラー率が基準値+0.5pt以内、問い合わせ0件
戻す条件: エラー率が基準値+2pt超、または重大度「高」の報告が1件

観察時間は、利用の頻度に合わせます。1日1回しか使われない機能を30分見ても何も分かりません。「その機能が一巡するまで」が最低ラインです。

feature flag の寿命を管理する

flag は「消し忘れが次のバグになる」道具です。100%公開から数か月たった flag が残っていると、古い分岐が誰にも読まれないまま腐り、組み合わせの数だけテストが膨らみます。作る時点で次を決めてください。

  • 削除予定日(公開完了から2スプリント以内など)
  • 担当者
  • 種別:リリース用(短命)/運用スイッチ(長命)/実験用
// 期限をコードに残す例
const flags = {
  newCheckout: { owner: "pay-team", removeBy: "2026-12-15" },
};

CI で removeBy を過ぎた flag を検出して失敗させると、棚卸しを人に頼らずに済みます。

切り戻しを先に設計する

段階リリースは、戻せて初めて意味があります。次の3点を事前に確認します。

  • flag オフで本当に元の動作に戻るか:オフにした経路を、実際に1回テストする
  • データは戻せるか:新機能が書いたデータを旧コードが読めない場合、flag を戻しても壊れる。書き込み形式の変更は「広げる→移す→縮める」の段階に分ける
  • 誰が戻すか:夜間でも判断できる人と手順を決める。「戻す条件」を超えたら相談なしで戻してよい、と決めておくと速い

失敗例:段階はあるのに効かない

  • 1%に出したが、そのユーザーが偶然ほぼ誰も使わない地域・端末で、問題が見えなかった。対象は端末・地域・プランが偏らないように選ぶ
  • エラー率しか見ておらず、画面が崩れて操作できないだけの不具合を見逃した。利用者からの報告も「戻す条件」に入れる
  • flag がオフのときの経路が長年テストされておらず、切り戻した瞬間に別のバグが出た

Bugoon での実践

段階リリースでは、数値に出ない不具合を利用者や社内メンバーの声から拾えるかが鍵になります。Bugoon のウィジェットをサイトに埋め込んでおけば、1%公開の段階でも、気づいた人がその画面からスクリーンショットとアノテーション付きで報告できます。操作ステップの記録で再現手順も残り、GitHub Issue に連携されるので、「戻す条件」に当てはまるかをすぐ判断できます。カンバンボードで段階ごとの報告を並べて見る使い方もできます。レポートにリリースバージョンが自動で載るようになれば、どのリリースから増えたかをさらに追いやすくなるでしょう。

チームのバグ報告を、もっとスムーズに。

Bugoon は無料で始められます。サイトにタグを 1 行追加するだけで、QA と開発の往復がなくなります。

無料で始める