AEM Cloud Manager部署管道在部署期间卡住

本文介绍如何对Adobe Experience Manager (AEM) as a Cloud Service部署管道在生成或部署期间保持运行或阻止状态进行故障排除。 日志可以识别无效的Oak索引定义、FileVault包验证失败、自定义代码错误或发布容器准备情况问题。 要解决此问题,请查看管道和部署日志,在日志发现客户问题时更正代码或配置,在本地验证包,重新运行管道,并验证环境和pod是否正常。

描述 description

环境

  • Adobe Experience Manager as a Cloud Service
  • Adobe Experience Manager Cloud Manager
  • Cloud Manager部署管道
  • 项目代码库中的自定义Oak索引和FileVault包定义
  • 发布环境正在进行部署和准备情况检查

问题/症状

  • 运行Cloud Manager部署时,管道在“生成”或“部署到暂存”期间保持运行状态,并且无法继续。
  • 受阻的管道阻止发布活动和升级到更高环境。
  • 生成日志包含错误,如​ ValidationViolation:配置文件中缺少强制子节点 ​或节点类型错误。
  • 发布容器开始但未准备就绪,因此环境未达到所需的准备状态。

原因

当生成或部署验证拒绝无效的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包验证器。 确认包定义通过验证。

  6. 更正配置问题后,在Cloud Manager中启动新的管道执行。

  7. 监测管道,并确认其进度超过了之前阻止的步骤。

  8. 如果发布层仍保留在进度中,且容器未就绪:

    • 查看部署日志以了解容器启动错误。
    • 解决日志中发现的运行时错误或配置错误。

    注意:如果日志未识别客户代码或配置问题,并且容器仍然未准备就绪,请收集Cloud Manager和部署日志并联系Adobe支持。 请勿尝试直接管理AEM Pod。

  9. 验证部署管道是否成功完成,以及是否在Cloud Manager中将所有pod报告为运行正常。

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