# 検証環境とは

システムの変更を実際の業務へ反映する前に、機能や連携を試験するための環境です。本番との構成差によって確認できる範囲が変化し、外部サービスと連携する試験では決済やメールの接続先も分離します。

## 検証環境とは

検証環境はシステムの変更を実際の業務へ反映する前に、機能や他のシステムとの連携を試験するための環境です。本番に近い構成で最終確認する環境は、ステージング環境とも呼びます[^safe-deployment]。

例えば通販サイトの決済機能を変更する際、別の確認用サイトで注文を登録し、決済の成功・失敗に応じた表示や注文状態を試験します。実際の顧客が取引する本番環境とは、注文や顧客情報などのデータと、決済やメールの接続先を分離します。

開発環境では開発途中の機能を試行し、検証環境では本番へ反映する予定の複数の変更を同時に適用した状態で確認します。サーバーの台数、データベースのバージョン、接続先などの構成が本番と異なるほど、試験に合格しても本番で同じ結果になるとは限りません[^parity]。

![本番へ反映する予定の変更を検証環境で確認し、確認した変更を本番環境へ反映する。検証環境の対象は試験用のデータと接続先で、本番環境の対象は実際の取引と顧客](https://media.marketing.kdotdev-tunnel.org/glossary-staging-environment-d0000fb9deb74b55afbdaee472ef29611a3a3f853464fe88d0c570d28235558a.png)

## 本番への反映前に環境差を確認する

開発者のパソコンで機能ごとに成功した試験だけでは、本番の構成で正常に稼働するかは確認できません。データベースの種類やバージョンが異なると、処理の互換性の差により、開発環境や検証環境で成功した処理が本番で失敗することがあります[^parity]。検証環境では本番へ反映するプログラムと設定を本番に近い条件で確認します。試験後にプログラムや設定を変更した場合は、影響する範囲を再確認します[^safe-deployment]。

架空の通販サイトを例にすると、注文登録の画面だけでなく、決済に失敗した注文が発送対象から除外されるかまで確認します。画面の表示は正常でも、後続の処理が不適切な注文状態を参照する不具合は別に検出する必要があります。

| 試験の目的 | 再現を重視する条件 | 試験結果で確認できない範囲 |
|---|---|---|
| 表示文言や画面の確認 | 公開予定のプログラム、対象のブラウザ、商品名や価格などの表示用データ | 本番と同等の処理能力までは確認できない |
| 注文から発送までの連携確認 | 本番と同じ種類・バージョンのデータベース、注文状態、連携先の試験用機能 | 実際の決済や配送そのものの成功は保証しない |
| 同時注文に対する性能確認 | 本番相当の構成・容量・データ量・アクセス条件 | 小規模な環境での成功だけでは本番の処理能力を確認できない |

![画面の確認には公開予定のプログラム、連携の確認には同じ種類・バージョンのデータベース、性能の確認には本番相当の構成と容量を再現する](https://media.marketing.kdotdev-tunnel.org/glossary-staging-environment-3e8710aa739eeb2397aab07a6850ccf40a54eaad1e57e5f716df4bd91b1c481b.png)

画面の文言確認のために、本番と同じ台数のサーバーを常時稼働させる必要はありません。一方、性能を評価する試験では本番相当の条件を再現します[^load-test]。

外部サービスの試験用機能には、負荷試験での使用を認めないものがあります。例えばStripeの試験用機能では決済の成功・拒否を確認し、負荷試験には使用しません[^stripe-test]。

## 決済と通知の接続先を本番から分離する

決済やメールの接続先が本番のままなら、試験操作で本番へ決済要求やメールを送信してしまい、実際の請求や顧客への通知を発生させるおそれがあります。画面のURLだけでなく、外部サービスの認証情報と送信先を試験用に設定します。

![確認用サイトは試験用の決済と確認用の送信先だけに接続し、本番の決済と顧客のアドレスには接続しない](https://media.marketing.kdotdev-tunnel.org/glossary-staging-environment-33dadb0a5a9c280f453c52d3ed7e11a4dbd1ad9354a1b44f166d8bd5b4e56fbb.png)

例えばStripeの試験用機能では、試験用の認証情報とテストカードで、資金を移動させずに決済の成功や拒否を再現できます[^stripe-test]。試験メールの送信先は顧客のアドレスではなく確認用のアドレスに限定します。外部サービスへの操作を伴わない社内の売上集計表の表示確認なら、実際の決済や通知を再現する必要はありません。

試験データには原則として架空の顧客情報を使用します。本番から氏名やメールアドレスを複製すると、それらの保管場所が増加します。実データが必要な試験では複製する顧客情報の項目と利用者を限定し、試験後の削除まで管理します。

検証環境にも公開範囲と利用者の制限が必要です。

## 環境の維持にも費用と作業が発生する

検証環境では本番とは別に、サーバーの稼働や試験データの保管に費用を要することがあります。通販サイトの例では本番との構成差が拡大しないよう、ソフトウェアの更新、設定の変更、返品や決済失敗などの試験データの準備も継続します。

![本番の変更に対応した構成と設定の更新、試験内容の変更に対応した試験データの維持、担当者の交代に伴う引継ぎ](https://media.marketing.kdotdev-tunnel.org/glossary-staging-environment-2adfe5cda847f43929448c470979fb8b667b62b95f634db62cc5dbc0b79845ad.png)

通販サイトの例での維持作業と、省略した場合の影響は次のとおりです。

| 負担 | 省略した場合の影響 |
|---|---|
| 本番の変更に応じた構成・設定の更新 | 更新前の条件での試験結果だけでは、変更後の本番で同じ結果になるか確認できない |
| 返品・決済失敗などの試験データの維持 | 注文が正常に完了する場合だけで確認が終了し、返品や決済失敗の処理を未検証 |
| 環境と外部接続の担当者の確保と引継ぎ方法の整備 | 担当者の不在時に変更や接続先を確認できないおそれ |

使用機会が限定される環境は、必要な期間だけ稼働する構成も選択肢です。再作成に必要な設定と、返品や決済失敗などの試験データを保存し、確認のたびに同じ条件を再現できることを優先します。

## よくある誤解

### 検証環境のデータは本番へ自動で反映される

試験データは本番への転送対象とは限りません。例えば、確認用に登録した注文や顧客情報は本番の取引データと区別します。試験データと公開するプログラムは区別します。記事や商品情報を本番へ転送する運用では、対象と操作を別に定義します。

[^safe-deployment]: [Architecture strategies for safe deployment practices](https://learn.microsoft.com/en-us/azure/well-architected/operational-excellence/safe-deployments)（Microsoft Learn）
[^parity]: [X. Dev/prod parity](https://12factor.net/dev-prod-parity)（The Twelve-Factor App）
[^load-test]: [OPS05-BP08 Use multiple environments](https://docs.aws.amazon.com/wellarchitected/latest/operational-excellence-pillar/ops_dev_integ_multi_env.html)（AWS Well-Architected、旧版資料）。負荷試験で本番相当の環境を使用する推奨を参照しています。
[^stripe-test]: [テスト](https://docs.stripe.com/testing)（Stripeドキュメント）
