ドキュメントExperience Cloud KCS

AEM Cloud Manager：コンテンツパッケージのDocView XMLの形式が正しくないため、「Devにデプロイ」でフルスタックパイプラインが失敗する

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

この記事では、コンテンツパッケージ内のDocView XMLの形式が正しくないことが原因で「開発用にデプロイ」ステージで発生する、Adobe Experience Manager Cloud フルスタックパイプラインの一貫したエラーについて説明します。

説明 description

環境

Adobe Experience Manager（AEM）as a Cloud Service（すべてのバージョン）

問題/症状

Cloud Full Stack Pipelineは、開発へのデプロイ 段階で一貫して失敗します。 複数のパイプライン実行は同じ動作を示し、デプロイメントプロセスが失敗するか、進行することなく長期間（1.5時間以上など）停止します。 デプロイメントログに実用的なエラー情報が表示されません。

  • 問題は、影響を受ける環境のフルスタックパイプラインをトリガーすることで再現できます。
  • ログに特定のエラーメッセージは表示されません。パイプラインは、デプロイメントステップでサイレントにハングまたは失敗するように見えます。

解決策 resolution

  1. 問題のあるコンテンツパッケージの特定

    • 最近追加または変更されたパッケージに焦点を当てて、パイプラインに含まれるコンテンツパッケージを確認します。
    • 形式が正しくないXMLを導入する可能性のある自動ツールによって生成されたパッケージを確認します。

  2. DocView XML ファイルの検証

    • コンテンツパッケージを抽出し、すべての.content.xml ファイルを見つけます。
    • xmllintなどのXML検証ツールを使用して、各.content.xml ファイルの形式が適切かどうかを確認します。
    code language-none 
    find . -name '*.content.xml' -exec xmllint --noout {} \;
    • バリデータによって報告されたXML構文エラーを修正します。

  3. ビルドプロセスを更新して、今後の問題を防ぎます

    • ui.content モジュールがFileVault パッケージ Maven プラグインを使用してビルドされていることを確認します。
    • コミットまたはデプロイする前に、mvn clean verifyを実行して、パッケージ構造とXMLの正確性を検証します。
    • 参照：AEM プロジェクト コンテンツ パッケージ構造

  4. CI パイプラインへのXML検証の追加

    • CI プロセスにXML検証ステップを統合して、デプロイメント前にすべての.content.xml ファイルが整形式であることを自動的に確認します。

  5. パイプラインを再実行する

    • 形式が正しくないXMLを修正し、ビルドプロセスを更新した後、パイプラインを再トリガーしてデプロイメントが正常に行われたことを確認します。

原因：

パイプラインのエラーは、可変コンテンツパッケージ内の形式が正しくないDocView XML ファイルが原因で発生しました。 この問題は、Adobeのアナライザーまたはプラグインツールの変更ではなく、デプロイメントステップ中に問題のあるパッケージが処理された場合にのみ表示されます。

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