尽管转出正常,AEM as a Cloud Service部署仍失败并出现KubernetesDeploymentTimeoutException

本文介绍了如何在Adobe Experience Manager (AEM) as a Cloud Service中解决以下问题:生产部署因KubernetesDeploymentTimeoutException而失败,即使转出成功完成。 问题通常与预览层上缺少配置有关。

描述 description

环境

Adobe Experience Manager (AEM) as a Cloud Service(所有版本)

问题/症状

  • 通过Cloud Manager进行的生产部署在具有KubernetesDeploymentTimeoutException的部署步骤期间失败。
  • 部署步骤可能会运行几个小时,然后才会失败。
  • Cloud Manager UI将部署报告为错误。
  • 基础生产转出(例如aem-publish)在超时之前达到正常和已完成状态,所有副本都已就绪。
  • 转出正常后,AEM应用程序日志中没有出现崩溃、内存不足或关闭错误。
  • 在Cloud Manager保持等待状态时,应用程序将继续正常提供流量。
  • 可能会看到预览Pod不断重新启动,Dispatcher容器日志显示运行状况检查失败(例如,未能连接到本地主机端口8080或缺少重定向配置)。

原因

此问题通常是由预览层上缺少所需的配置内容导致的。 即使预览层不用于提供流量,其Dispatcher初始化也依赖于与发布层相同的配置。 缺少配置可能会导致预览Dispatcher初始化失败,进而阻止生产部署管道。

解决方法 resolution

请按照以下步骤解决问题:

  1. 使用您的Kubernetes或Argo转出工具验证生产转出是否已达到健康且已完成的状态。 确认所有预期的复制副本都已就绪。

  2. 在Cloud Manager中,查看管道执行详细信息以了解部署步骤中出现的错误。 如果错误为KubernetesDeploymentTimeoutException,请注意这一点。

  3. 确保所有必需的重定向配置内容都已发布到预览层。 这包括调度程序初始化所需的任何配置或内容,即使未使用预览层提供流量也是如此。

    • 查看您的部署过程,以确认用于发布的同一重定向和Dispatcher配置在“预览”中也可用。
    • 如果您使用内容包或配置管理,请验证是否同时将这些内容包部署到发布层和预览层。
  4. 检查预览Pod的运行状况。

    • 使用Kubernetes工具(如kubectl logs)查看“预览Pod”的Dispatcher容器日志。
    • 查找运行状况检查失败或重复重新启动,这可能表示缺少配置。
  5. 将所需的配置发布到预览层后,在Cloud Manager中重新运行生产部署管道。

  6. 验证部署是否成功完成,以及所有pod(包括预览pod)是否正常。

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