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
请按照以下步骤解决问题:
-
查看受影响运行的Cloud Manager管道执行详细信息。
-
下载并查看生成和部署日志,侧重于生成和部署步骤。
-
查找Oak索引或FileVault包验证错误,例如:
- ValidationViolation:缺少必需的子节点
- 配置文件中的节点类型错误无效,如
src/main/content/jcr_root/_oak_index/your-index-name/config.xml。
-
更新项目代码库中的Oak索引配置文件,以使其符合AEM as a Cloud Service索引规则和JCR/Oak节点类型。 注意:通过Cloud Manager将Oak索引定义部署为代码。 请勿在运行的环境中手动修改运行时索引节点。
-
在提交更改之前,对包在本地运行FileVault包验证器。 确认包定义通过验证。
-
更正配置问题后,在Cloud Manager中启动新的管道执行。
-
监测管道,并确认其进度超过了之前阻止的步骤。
-
如果发布层仍保留在进度中,且容器未就绪:
- 查看部署日志以了解容器启动错误。
- 解决日志中发现的运行时错误或配置错误。
注意:如果日志未识别客户代码或配置问题,并且容器仍然未准备就绪,请收集Cloud Manager和部署日志并联系Adobe支持。 请勿尝试直接管理AEM Pod。
-
验证部署管道是否成功完成,以及是否在Cloud Manager中将所有pod报告为运行正常。