ドキュメントExperience Cloud KCS

Cloud Manager デプロイメント用のAEM実稼動コードのロールバック手順

最終更新日： 2026年6月30日

Adobe Experience Manager（AEM）実稼動デプロイメントでは、デプロイメントタイプ、デプロイメントの年齢、ホスティングモデルに応じて、異なるロールバック方法が必要になります。 この問題は、Cloud Managerが対象となるフルスタックのデプロイメントに対してのみロールバックをサポートするのに対し、フロントエンドのみのデプロイメント、古いデプロイメント、および特定のAMS シナリオでは別の回復方法が必要になるために発生します。 この問題を解決するには、ロールバックの実施要件を特定し、コードを復元し、デプロイメントを検証します。

説明 description

環境

Adobe Experience Manager as a Cloud Service （AEMaaCS）

問題/症状

  • 実稼動環境へのデプロイメントでは、リグレッションが発生し、すぐにロールバックする必要があります。
  • 前回の正常なデプロイメントが30日を超えているため、前回のコードのデプロイを復元 オプションは使用できません。
  • フロントエンドのみのデプロイメントでは、CSSまたはJavaScriptの誤った変更が発生し、Cloud Managerの復元機能を使用してロールバックできません。
  • Git同期またはブランチの問題により、以前のコミットを再デプロイできなくなります。
  • AMS環境のリストアでは、リカバリ中にダウンタイムが延長されます。

根本原因

この問題は、AEMでプラットフォームコード、カスタマーカスタムコード、可変コンテンツが分離されるために発生します。 Cloud Managerで復元できるアーティファクトを生成するのは、フルスタックのデプロイメントのみです。 フロントエンドのみのデプロイメントでは、復元可能なAEM イメージは作成されず、30日を超えるデプロイメントは復元操作に保持されません。 ブルーグリーンデプロイメント機能を備えていないAMS環境は、再デプロイメントまたは環境の復元に依存するため、ダウンタイムが発生する可能性があります。

解決策 resolution

次の手順に従って、適切なロールバック戦略を決定し、本番環境の安定性を回復します。

  1. 展開がフルスタック展開、フロントエンドのみの展開、AMS展開、またはサポートされている復元ウィンドウ外の古い展開であるかどうかを判断することで、ロールバックシナリオを特定します。
  2. Cloud Managerに移動して、対象となるAEM as a Cloud Service フルスタックデプロイメントを復元します > 環境 > 実稼動環境 > 復元 > 前回のデプロイがサポートされている保持期間に入ると、前回のデプロイ済みコード がデプロイされました。
  3. Git ベースのロールバックを実行するには、正常なコミットに戻し、復元オプションが使用できない場合に、復元されたコードを実稼動パイプラインを通じて再デプロイします。
  4. フロントエンドのみのデプロイメントは、Cloud Manager restoreでフロントエンドのみのデプロイメントがサポートされていないため、Gitでフロントエンドコードを元に戻し、フロントエンドのデプロイメントパイプラインを再実行して、フロントエンドのみのデプロイメントをロールバックします。
  5. 以前のコードバージョンを再デプロイするか、必要に応じて環境の復元をリクエストすることで、AEM Managed Servicesのデプロイメントを復元します。
  6. パイプラインが正常に完了し、想定されるコミットバージョンがアクティブとして表示されることを確認して、デプロイメントの完了を確認します。
  7. 実稼動スモークテストを実行し、アプリケーションの安定性を確認し、復元されたコードが期待どおりに動作することを確認して、解決策を検証します。

エスカレーションするタイミング

  • デプロイメントが復元適格要件を満たしているにもかかわらず、復元オプションは使用できません。
  • 前のコミットに戻った後、デプロイメントは繰り返し失敗します。
  • ロールバックによって、誤ったコードバージョンが復元されるか、追加の不安定性が生じます。
  • リポジトリーの同期の問題により、ロールバックやGitからの再デプロイメントが妨げられます。

関連トピックス

recommendation-more-help
experience-cloud-kcs-help-kbarticles