ドキュメントExperience Cloud KCS

デプロイメント中にAEM Cloud Manager デプロイメントパイプラインが停止する

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

この記事では、ビルドまたはデプロイメント中に実行中またはブロック状態のままになるAdobe Experience Manager（AEM）as a Cloud Service デプロイメントパイプラインのトラブルシューティング方法について説明します。 ログは、無効なOak インデックス定義、FileVault パッケージ検証エラー、カスタムコードエラー、またはパブリッシュコンテナの準備問題を特定できます。 この問題を解決するには、パイプラインとデプロイメントログを確認し、ログが顧客の問題を特定する際にコードまたは設定を修正し、パッケージをローカルで検証し、パイプラインを再実行し、環境とポッドが正常に動作することを確認します。

説明 description

環境

  • Adobe Experience Manager as a Cloud Service
  • Adobe Experience Manager Cloud Manager
  • Cloud Manager デプロイメントパイプライン
  • プロジェクトコードベースのカスタム Oak インデックスとFileVault パッケージ定義
  • デプロイメントと準備状況チェックの対象となる公開環境

問題/症状

  • Cloud Manager デプロイメントを実行すると、「ビルド」または「ステージにデプロイ」の間、パイプラインは実行中の状態のままになり、進行しません。
  • ブロックされたパイプラインは、リリースアクティビティと上位環境へのプロモーションを防ぎます。
  • ビルドログには、「ValidationViolation: Mandatory child node missing」や「無効なノードタイプのエラー」などのエラーが設定ファイルに含まれています。
  • 公開コンテナは開始されますが、準備ができていないので、環境は必要な準備状態に達しません。

原因

ビルドまたはデプロイメントの検証で、無効なOak インデックス定義、不足している必須の子ノード、またはFileVault パッケージ内の無効なノードタイプが拒否された場合、パイプラインは進行しません。 パブリッシュコンテナが開始されますが、準備ができていない場合は、デプロイメントの準備状態が個別に発生するため、Cloud Managerで環境を準備完了としてマークすることはできません。 関連する原因は、パイプラインとデプロイメントログから判断されます。

解決策 resolution

問題を解決するには、次の手順に従います。

  1. 影響を受ける実行のCloud Manager パイプライン実行の詳細を確認します。

  2. ビルドとデプロイの手順に焦点を当てて、ビルドとデプロイメントのログをダウンロードして確認します。

  3. 次のようなOak インデックスまたはFileVault パッケージ検証エラーを探します。

    • ValidationViolation：必須の子ノードがありません
    • 構成ファイル （src/main/content/jcr_root/_oak_index/your-index-name/config.xmlなど）のノードタイプ エラーが無効です。

  4. プロジェクトコードベースのOak インデックス設定ファイルを更新して、AEM as a Cloud Service インデックスのルールとJCR/Oak ノードタイプに準拠するようにします。 注： Cloud Managerを使用して、Oak インデックス定義をコードとしてデプロイします。 実行中の環境でランタイムインデックスノードを手動で変更しないでください。

  5. 変更を確定する前に、FileVault Package Validatorをパッケージに対してローカルで実行します。 パッケージ定義が検証に合格することを確認します。

  6. 設定の問題を修正したら、Cloud Managerで新しいパイプラインの実行を開始します。

  7. パイプラインを監視し、以前にブロックしたステップを超えて進行することを確認します。

  8. パブリッシュ層がコンテナの準備ができていない状態でプログレッシブのままである場合：

    • コンテナ起動エラーについては、デプロイメントログを確認してください。
    • ログで特定されたランタイムエラーまたは設定ミスに対処します。

    メモ： ログでカスタマーコードまたはコンフィギュレーションの問題が特定されず、コンテナの準備ができていない場合は、Cloud Managerとデプロイメントのログを収集し、Adobe サポート ​にお問い合わせください。 AEM ポッドを直接管理しようとしない。

  9. デプロイメントパイプラインが正常に完了し、すべてのポッドがCloud Managerで正常であると報告されていることを確認します。

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