ステップごとの移行

安全に移行するには、段階的に進めます。開発環境で各部分を接続して確認している間も、公開ウェブサイトは変更されずに稼働し続けます。

安全を保つためのルール

• デザインを変えないこと。 Atlas にコンテンツがあってもなくても、すべてのページが同じ見た目でなければなりません。
• フォールバックは必須です。 Atlas に接続できない場合、またはページに公開済みコンテンツがない場合は、サイトが組み込みのコンテンツを提供します。
• HTML ではなくテキスト。 CMS の値はテキストとして、またはお客様のコンポーネントを通して表示します。
• まず開発環境。 リリースがチェックを通過し、担当者が承認するまで、何も本番環境には反映されません。

ステージ 1: 1 ページを接続する（約 1 日）

1. Studio でサイトを作成し、1 つのページタイプだけを持つ最小限のコントラクトを下書きします。
2. Next.js ウェブサイトを接続するに従います。
3. 開発環境でその 1 ページを公開し、稼働中のページと比較します。

完了の条件: ページが Atlas から表示され、見た目が同じで、Atlas をオフにしても動作すること。

ステージ 2: サイト全体をモデル化する

1. サイトが配信するすべてのルートを洗い出し、それぞれをページタイプに対応づけます。
2. コントラクトバンドルを作成します。型付きフィールドを持つコンポーネント、リージョンを持つページタイプ、コレクション、メディアプロファイル、ヘッダーとフッターのグローバルを含めます。リポジトリでは atlas/contract.bundle.json として保管してください。
3. 検証して提案します。サイト管理者が Studio（Site setup）で有効化します。
4. Atlas のセクションが順序と内容を決定するよう、各ページコンポーネントをリファクタリングし、組み込みのデータをフォールバックにします。

完了の条件: Studio に、ウェブサイトが In sync with the active contract と表示されること。

ステージ 3: コンテンツと画像を移行する

1. 適切なメディアプロファイルで画像をアップロードします。引き伸ばしやアップスケールは行わず、合わないものは一覧にします。
2. 繰り返し現れる項目ごとにエントリーを作成し、画像はアセット ID で参照して、代替テキストを付けます。
3. ヘッダーとフッターのグローバルに、現在のコンテンツを入力します。
4. 各ルートについて、そのページタイプからページを作成し、下書きが現在のページと一致するまでセクションを調整します。
5. 翻訳を下書きし、ネイティブスピーカーにレビューしてもらいます。

MCP 経由で接続した AI コーディングエージェントなら、これらの大部分を下書きとして実行できます。担当者が Preview on website で各ページを確認し、公開します。

ステージ 4: 更新、SEO、リダイレクト

• Webhook の受信処理を追加し、公開が数秒でサイトに反映されるようにします。
• SEO のタイトル、説明、noindex を Delivery API から読み取り、サイトマップは /routes から作成します。
• /redirects を読み込んで適用し、古い URL の検索順位を維持します。

ステージ 5: 公開する

1. 編集者に Studio、下書き、プレビュー、公開の使い方をトレーニングします。
2. リリースを作成します。Atlas は、コントラクトが同期していること、公開時の問題がないこと、ウェブサイトが正常であること、最新のバックアップがあることを確認します。
3. 承認権限を持つ担当者が承認します。サイト管理者が本番環境を有効にし、本番の配信トークンを作成します。
4. 本番トークンを使ってウェブサイトをデプロイします。フォールバックは残したままにします。

本番環境が配信するもの

本番環境は、ライブリリースに含まれるコンテンツ、フォーム、チャットボット、検索設定を配信します。プレビューは引き続き開発環境のみです。具体的な手順は公開するに従ってください。

ロールバック

• コンテンツの誤り: 以前のリビジョン、または以前の本番リリースにロールバックします。
• コードの誤り: 現在と同じように、以前のウェブサイトビルドを再デプロイします。
• Atlas が利用できない場合: Atlas が復旧するまで、フォールバックが組み込みのコンテンツを提供します。