企業AIプロジェクトWiki · 環境・バージョン・リリース
ステージング環境
別名Pre-production environment · プリプロダクション環境 · Stage
ステージング環境とは、本番投入前に、本番候補の成果物、環境設定、正式なデプロイ経路を最終確認する管理された非本番環境です。リリースリスクに関係する本番条件をできる限り再現しながら、実ユーザー、本番データ、不可逆な業務操作から分離し、設定、権限、通信、依存、移行、起動、観測の問題を稼働前に発見します。
ステージング環境を分ける理由
機能テスト合格だけでは、同じ成果物が正式経路で本番へ入ることを証明できません。最後のリスクは設定、ID、通信、証明書、DB移行、資源制限、起動順序、監視、配備自動化に残ります。
ステージングでは、問いを「機能が動くか」から「この本番候補を正式手順で配備し、本番を代表する条件で稼働できるか」へ進めます。一般テストより本番に近く、変更、アクセス、配備を強く管理します。
それでも非本番です。本番に似せるとはリスクを再現することであり、不要な本番データ、秘密、顧客通信、実業務操作を許可することではありません。
本番に近づける条件
すべてを同じ費用で複製するのではなく、今回のリリース判断に影響する条件を再現し、意図した差を記録します。
構成とサービス種類
主要な計算、通信、DB、キャッシュ、メッセージ、保存、ゲートウェイの種類と関係を本番経路に合わせます。
ランタイムと成果物
同じ不変の本番候補または等価性を証明できる成果物を使い、OS、基盤イメージ、ランタイム、主要依存を互換にします。
配備と設定方法
正式パイプライン、IaC、設定注入、秘密参照、DB移行、起動順序を使い、手作業で問題を隠しません。
ID、権限、通信制御
本番の役割、サービス権限、入口出口、DNS、証明書、ファイアウォールを代表しつつ、アカウントと秘密は分離します。
観測とヘルス判定
本番方式のログ、メトリクス、トレース、ヘルスチェック、アラートで障害を発見・対応できるか確認します。
資源と負荷
性能・容量を判断するなら資源、データ量、同時実行、外部上限を代表させます。小規模構成では証明できない結論を明記します。
既知差異一覧
本番データ、ドメイン、決済、通知、リージョン、規模の差について、理由、リスク、補足確認、担当を記録します。
本番前に確認すること
- 候補版を一意に識別できるか
アプリ、設定、DB変更、モデル、プロンプト、知識索引の版を固定します。
記録：ダイジェスト、候補ID、設定・移行版。
- 正式な配備経路を完走できるか
成果物取得、設定、移行、起動、ウォームアップ、ヘルス確認を本番方式で行います。
記録：パイプライン、配備ログ、移行、起動結果。
- 主要スモークテストが通るか
ログイン、参照、書込み、権限、連携、主要状態遷移を少数の高価値シナリオで確認します。
記録：ケース、入力、実結果、実施者。
- 環境境界が正しいか
ドメイン、証明書、通信、ID、秘密、最小権限、本番データや実操作端点への誤接続を確認します。
記録：アクセス試験、差異、端点、アカウント。
- 障害を検知できるか
管理されたエラーを起こし、ログ、指標、トレース、通知先、手順書を確認します。
記録：障害、通知、診断経路。
- 停止・復元できるか
旧成果物、設定復元、移行互換・回復、不可逆処理前の停止点を確認します。
記録：ロールバック演習、復旧結果、制約、担当。
本番判断までの流れ
候補を固定
通常テスト済み成果物と、含まれる設定、移行、依存変更を固定します。
既知状態へ戻す
基盤、アカウント、通信、データ、監視をリセットし、本番との差を登録します。
正式経路で配備
本番用の自動化と承認を使い、環境内再ビルドや隠れた手修正を行いません。
最終確認
起動、ヘルス、スモーク、主要連携、必要な性能、安全、移行、復旧を確認します。
承認または差戻し
監視、連絡先、時間帯、観測指標、停止条件、ロールバックを確認し、権限者が判断します。
成果物の連続性を保つ
検証済み成果物を本番へ進めます。再ビルド、修正、重要設定変更は影響する確認を再実施します。
データ、外部サービス、企業AI
代表データは本番全量コピーではない
合成・匿名化データを優先し、必要な量、関係、境界、履歴を残します。本番例は許可、最小範囲、アクセス制限、削除が必要です。
テスト端点と実端点を分ける
決済、通知、署名、認証、企業システムがSandbox、模擬、制限済み実端点のどれかを明示し、実副作用を防ぎます。
代表的なモデルサービスを使う
モデル名、版・別名、リージョン、フィルター、パラメータ、上限、代替経路を記録します。別モデルでは本番品質や遅延を証明できません。
知識状態を候補へ結び付ける
文書、権限、分割、索引、検索、リランキングを版管理し、最終確認中の無記録変更を止めます。
ツールの実副作用を遮断
注文、通知、チケット、承認、支払はテスト端点や制限アカウントで、引数、確認、冪等、監査、失敗、人への引継ぎを確認します。
汚染と費用を管理
デモ、負荷試験、共有利用後に状態を戻し、本番類似資源とモデル利用の保持、上限、自動停止、担当を記録します。
ステージングと混同しやすい概念
| 関連概念 | 違い |
|---|---|
| テスト環境 | 広い機能・結合・回帰を頻繁に行います。ステージングは固定した候補と正式配備経路を本番近傍で確認します。 |
| UAT環境 | 業務利用者が業務結果を受け入れる場です。ステージングは本番類似の技術条件とリリースリスクを確認します。資源を共有しても証拠は別です。 |
| 本番環境 | 実業務と正式運用責任を担います。設定が似ていても、ステージングへ不要な本番データ、秘密、実操作権限を与えません。 |
| リリース候補 | 本番へ進めるソフトウェア、設定、内容の状態です。ステージングはそれを配備し確認する環境です。 |
| ブルーグリーンの新環境 | 実トラフィックを受ける本番リリース面です。スロット交換で技術的に接続しても、非本番ステージングとは責任が異なります。 |
| デモ環境 | 安定した展示を優先します。ステージングはリリースリスク発見を優先し、長期デモのため固定しません。 |
出典と適用範囲
本項目ではステージング環境を、本番リリース直前の最終技術確認に使う非本番環境として扱います。stage、pre-productionなどの名称に世界共通の規模や試験範囲はありません。ステージングは自動的にUAT環境を意味せず、本番データ、容量、実外部操作をすべて複製する必要もありません。独立構成、再現する本番条件、データ、試験は案件リスクに応じて決定します。