ドキュメントExperience Cloud KCS

AEM as a Cloud ServiceのCloud Managerの信頼性をCからAに格上げ

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

この記事では、AEM Cloud Manager パイプラインの信頼性の評価がCとして報告される理由を説明し、コードスキャンの問題を解決し、Aに評価を改善するための手順を示します。

説明 description

環境

Adobe Experience Manager as a Cloud ServiceとCloud Managerのコード品質スキャン

症状

Cloud Manager パイプラインを実行する場合、信頼性の評価はCとしてレポートされます。コード品質レポートでは、次のような複数のOakPALの「バグ」調査結果が特定されます。

  • /contentまたは/content/experience-fragmentsのfilter.xmlでのmode="replace"の使用（FilterXmlModeAnalysis）
  • サードパーティ/ベンダーパッケージを含む、複数のパッケージ間のインストールパスの重複（PackageOverlaps）
  • カスタム Oak インデックス定義に必須のjcr:content ノードがありません（DiffIndexCheck）
  • OSGi設定ファイルの重複（DuplicateOsgiConfigurations）

これらの調査結果は、主要またはマイナーなバグとしてフラグが立てられ、Cloud Managerの信頼性の評価に直接影響します。 /contentの下のmode="replace"の使用は、Cloud ManagerのFilterXmlModeAnalysis ルールによって特に禁止されています。このルールは、すべてのデプロイメントで、そのパスの下にあるすべてのコンテンツを削除および再作成できます。

原因

Cの信頼性の評価は、Cloud ManagerのOakPAL分析で検出されたコード品質の問題によって引き起こされます。主な原因は、/contentの下のmode="replace"の使用、パッケージパスの重複、カスタム Oak インデックスのノードの欠落、および重複するOSGi設定です。

解決策 resolution

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

  1. 影響を受けるCloud Manager パイプラインの実行からコード品質レポートを確認し、主要およびマイナーなバグの調査結果をすべて特定します。

  2. ui.content パッケージのfilter.xml ファイルを更新します。

    • /contentまたは/content/experience-fragmentsの下のフィルタールートをmode="replace"からより安全なモード（mergeまたはupdate_propertiesなど）に変更します。
    • テストコンテンツの完全なリセットが必要な場合は、Cloud Managerのデプロイメント以外で手動でインストールしたパッケージまたはスクリプトを使用します。

  3. パッケージ間のインストールパスの重複を排除するために、フィルターのルートを調整することで、PackageOverlapsの結果を解決します。 必要に応じて、ベンダーパッケージの所有者と調整します。

  4. レポートで特定されたカスタム Oak インデックス定義に欠落しているjcr:content ノードを追加して、DiffIndexCheckの結果を解決します。

  5. 重複するOSGi設定ファイルの名前を変更または削除することで、DuplicateOsgiConfigurationsの結果を解決し、すべてのパッケージで各設定が1回だけ定義されるようにします。

  6. Cloud Manager パイプラインを再実行し、すべての主要およびマイナーなバグの調査結果が解決され、信頼性の評価が向上することを確認します。

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