提高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下的filter.xml中使用mode="replace" (FilterXmlModeAnalysis)
  • 多个包(包括第三方/供应商包)之间重叠的安装路径(包重叠)
  • 自定义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