段階リリースでバグの影響を小さく踏む
バグを出さないことには限界があります。そこで考えたいのが「出てしまったバグを小さく踏む」ことです。全ユーザーに一気にリリースすると、1つのバグが全員に届きます。リリースの段階を刻めば、同じバグでも影響を数%のユーザーで止められます。この記事では、リリース工程で使う「カナリアリリース」と「feature flag」の使い分け、段階の刻み方、切り戻し設計を整理します。
カナリアと feature flag は守る対象が違う
混同されやすい2つですが、切り替える単位が違います。
- カナリアリリース:新しいバージョンのサーバーやアプリを、一部のトラフィックにだけ流す。単位は「デプロイ(ビルド)」。インフラや依存ライブラリ、起動時の不具合を拾うのに向く
- feature flag:コードは全員に配り、機能のオン・オフだけをユーザー単位で切り替える。単位は「機能」。デプロイと公開を分離でき、再デプロイなしで止められる
目安は次のとおりです。マイグレーションや設定変更などビルド全体に関わる変更はカナリア、画面や挙動など機能単位の変更は flag を使います。大きな変更は、カナリアで新ビルドの健全性を確認してから flag で機能を段階的に開く、と重ねるのが安全です。
段階の刻み方:例
最初の段階は「壊れても気にならない人数」にします。一例です。
- 社内メンバーのみ(dogfooding)
- 全体の1%
- 5%
- 25%
- 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 に連携されるので、「戻す条件」に当てはまるかをすぐ判断できます。カンバンボードで段階ごとの報告を並べて見る使い方もできます。レポートにリリースバージョンが自動で載るようになれば、どのリリースから増えたかをさらに追いやすくなるでしょう。