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

ステージングが信用されなくなる理由と立て直し方

ステージングが信用されなくなる理由と立て直し方

「ステージングで通ったのに、本番で壊れた」。この経験が重なると、チームはステージングを信用しなくなります。そして「どうせ本番と違うから」と検証を省き、バグが本番に出ます。この記事はリリース工程の話です。ステージングが信用を失う典型的な理由と、立て直しの順番を整理します。

信用を失う4つのパターン

1. データが古い、または空っぽ

半年前のコピーのままで、新しい機能に必要なデータが存在しない。逆に空のままで、一覧や集計画面の挙動が一切確認できない。どちらも「検証したつもり」を生みます。

2. 落ちている、または誰かが占有している

朝に開いたら動かない、別の案件のブランチが載ったままで何が動いているか分からない。待たされた経験は、次から使わない理由になります。

3. 本番と構成が違う

インスタンスが1台だけ、外部サービスは全部モック、環境変数の一部が欠けている。違いが「何か」分からないまま使うと、通った結果の意味を誰も説明できません。

4. 結果が誰にも共有されない

確認した人の頭の中にしか結果がない。次の人は同じ確認をやり直すか、やらずに進めます。

立て直しの順番

全部を本番と同じにする必要はありません。コストがかかるので、次の順に手を付けます。

  1. 現状の差分を表にする。本番とステージングで違う点を書き出します。
  2. 許容する差分と許容しない差分を決める。台数やスペックは許容、DB のエンジンとバージョン、認証の仕組み、環境変数の項目は許容しない、といった線引きです。
  3. データの更新を運用に入れる。手作業ではなく定期ジョブにします。
  4. 占有のルールを決める。誰が何を載せているかが見える状態にします。
  5. 検証結果を残す場所を1つ決める。

本番との差分表のひな形

最初の一歩はこの表を埋めることです。

  • DB: エンジンとバージョン、データ件数の桁
  • 外部サービス: 実物につなぐか、サンドボックスか、モックか
  • 環境変数・設定: 項目の過不足(値ではなく項目名で比較)
  • インフラ: 台数・メモリ・タイムアウト値
  • 認証・権限: ロールの種類とテスト用アカウント
  • メール・通知: 実際の宛先に飛ばない設定になっているか

項目名の比較は、次のようなコマンドで機械的にできます。

# 本番とステージングの環境変数「名」だけを比べる(値は出さない)
diff <(cut -d= -f1 prod-vars.txt | sort) <(cut -d= -f1 staging-vars.txt | sort)

値が違うのは当然ですが、名前が片方にしか無い場合は、設定漏れというバグの種になります。

データを信用できる状態に保つ

本番データをそのまま持ち込むと、個人情報の漏えいという別の事故につながります。次のどちらかを選びます。

  • 匿名化した本番コピー: 氏名・メールアドレス・電話番号・自由記述欄を置き換えたうえで、週1回など定期的に再生成する
  • 生成データ: 件数・偏り・欠損を本番に近づけたデータを、スクリプトで毎回同じように作る

どちらでも、「最後に更新した日」を画面の隅かドキュメントに出しておくと、古いデータで検証してしまう事故が減ります。

コストとの折り合い

常時フル構成は高くつきます。折り合いの付け方は3つあります。

  • 夜間・休日は止め、朝に自動で起動する
  • リリース前の検証期間だけ本番相当に拡大する
  • 案件ごとの一時環境を作り、マージ後に自動で削除する

どれを選んでも、「いつ止まるか」を全員が分かる状態にしておくことが前提です。予告なく止まる環境は、落ちている環境と同じ扱いをされます。

失敗例: 「通ったはず」が本番で崩れた

ステージングは外部の決済サービスをモックにしていました。本番では実際のサービスがタイムアウトを返す場合があり、その処理が未実装でした。モックは常に成功を返すため、ステージングでは永遠に見つかりません。モックを使うなら、失敗・遅延を返すモードも用意するのが最低ラインです。

今週やること

  1. 差分表を作り、「許容しない差分」に印を付ける
  2. データの最終更新日をどこかに表示する
  3. 検証結果の置き場所(チケットなど)を決める

Bugoon での実践

立て直したステージングを使い続けてもらうには、見つけた問題を気軽に報告できる経路が必要です。Bugoon のウィジェットをステージングのサイトに埋め込むと、検証した人がその画面からスクリーンショット+アノテーション付きで報告でき、操作ステップも一緒に記録されます。報告は GitHub Issue に連携でき、カンバンボードで進み具合を追えるため、「確認した結果が頭の中にしか無い」状態を避けられます。報告にはブラウザや画面サイズなどの環境情報も付くので、本番との差分が原因かどうかの切り分けにも使えます。

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

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

無料で始める