改善AEM as a Cloud Service中Cloud Manager可靠性評等(從C到A)

本文說明為什麼AEM Cloud Manager管道中的可靠性評等會回報為C,並提供步驟來解決程式碼掃描問題並改善評等至A。

說明 description

環境

Adobe Experience Manager as a Cloud Service搭配Cloud Manager程式碼品質掃描

症狀

執行Cloud Manager管道時,可靠性評等會回報為C。計畫碼品質報表可識別多個OakPAL「錯誤」發現,例如:

  • 在/content或/content/experience-fragments (FilterXmlModeAnalysis)下的filter.xml中使用mode="replace"
  • 多個套件之間的重疊安裝路徑,包括第三方/廠商套件(PackageOverlaps)
  • 自訂Oak索引定義缺少必要的jcr:content節點(DiffIndexCheck)
  • 重複的OSGi設定檔案(DuplicateOsgiConfigurations)

這些發現專案會標示為主要或次要錯誤,並直接影響Cloud Manager中的可靠性評等。 Cloud Manager的FilterXmlModeAnalysis規則明確禁止使用/content下的mode="replace",因為它可以在每次部署中刪除並重新建立該路徑下的所有內容。

原因

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. 將遺失的jcr:content節點新增至報表中識別的任何自訂Oak索引定義,以解析DiffIndexCheck發現。

  5. 透過重新命名或刪除重複的OSGi設定檔案來解決DuplicateOsgiConfigurations發現,使得每個設定在所有套件中僅定義一次。

  6. 重新執行Cloud Manager管道,並確認所有主要和次要錯誤發現已解決,且可靠性評等已改善。

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