ローカル · ステージング · 運用環境
Local / Staging / Production
ローカルとは?
- ローカル(自分のPC)→ステージング(テスト)→本番(実利用)
- 段階を分けて安全にデプロイ
- 本番環境は実利用者向け
環境を分ける本当の理由は、テストを一回余計に行うためではなく、問題を見つける時点を前倒しするためです。ローカルで見つけたバグは開発者一人が10分で直せますが、同じバグが本番で発生すると、カスタマーサポートへの問い合わせ、返金処理、事後報告書までついてきます。環境が一つしかないチームは直せる機会が一度しかなく、三段階に分けたチームは同じミスを三回ふるい落とせる機会を持ちます。デプロイが遅くなるのではなく、やり直しのコストが安くなる仕組みです。
組織の規模によって段階の数は変わります。開発者が3〜5名ならローカル・ステージング・本番の3段階で十分ですが、20名を超えると開発(dev)・QA・ステージングを分けた4〜5段階が一般的です。ただ大切なのは段階の数ではなく、ステージングが本番とどれだけ似ているかです。サーバーの仕様、DBのバージョン、決済・配送のような外部APIのテスト用アカウント、データ件数が違うと、ステージングの通過はハンコを押すだけの形式的な手続きに成り下がります。本番データを複製して使うときは住民登録番号・連絡先・カード情報をマスキングしてから移すのが原則で、APIキーとDB接続情報はコードではなく環境変数やシークレット保管庫に置きます。
現場でいちばんよく聞く言葉が「私のローカルでは動いたのですが」です。たいていはローカルにだけあった設定ファイルや一時データに頼っていた、という意味なので、ローカルで成功しても検証にはなりません。さらに危ないのは、急ぎだからと今回だけ本番で直接直そうという判断です。その一行は次のデプロイで上書きされ、原因の追跡もできなくなります。ステージングを作っておきながら管理しないことも、よくある落とし穴です。ライブラリのバージョンが半年も遅れたままのステージングは、通過しても何も保証できません。最後に、ローカルPCから本番DBへ直接接続する習慣は、条件式のタイプミス一つで実データを消す事故につながります。
ソフトウェアのデプロイに伴うリスクを減らすため、開発・テスト・本番の環境を分ける慣行から確立され、クラウドやCI/CDとともに標準となりました。
仮の事例で見ていきます。役職員320名規模のオンライン食材流通会社A社です。開発チーム6名がステージングなしで本番サーバー上のコードを直接修正する方式で、3年間を乗り切ってきました。直近の四半期だけで決済障害が4回起き、そのうち金曜の夜の障害は復旧まで2時間20分かかり、注文1,100件がキャンセルされました。
- CTOが障害報告書を広げ、「原因を誰も説明できないことのほうが問題だ」と述べたうえで、本番サーバーの直接修正をその日から禁止しました。
- バックエンドリーダーが2週間かけて、運用と同じスペックのステージングサーバーを構築し、決済・配送会社との連携はテストアカウントで、顧客データ12万件は氏名と連絡先をマスキングして移行しました。
- コードに埋め込まれていた運用DBのパスワードとAPIキー17件を取り除き、環境変数に分離しました。また、ローカルPCから運用DBに接続していたアカウントは、DBA1名を残して全て回収しました。
- QA担当者がステージングで決済・返金・精算のシナリオ32件を実行し、合格の記録を残さないと運用デプロイのボタンが開かないよう、デプロイパイプラインを変更しました。
- 6か月後、決済障害は四半期に4回から0回へ減り、平均復旧時間は2時間20分から18分に短縮されました。デプロイ回数は週1回から週3回へむしろ増えています。
ク・ジャリョン
金鍾赫