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容器記錄會顯示健康情況檢查失敗(例如,無法連線至localhost連線埠8080或遺失重新導向設定)。

原因

此問題通常是由預覽層上缺少必要的設定內容所導致。 即使預覽層級不用於提供流量,其Dispatcher初始化仍取決於與發佈層級相同的設定。 缺少設定可能會導致預覽Dispatcher初始化失敗,這會封鎖生產部署管道。

解決方法 resolution

請依照下列步驟解決問題:

  1. 使用您的Kubernetes或Argo轉出工具,確認生產轉出已達健全和已完成狀態。 確認所有預期的復本都已準備就緒。

  2. 在Cloud Manager中,檢閱管道執行詳細資訊,以找出部署步驟期間的錯誤。 請注意,如果錯誤為KubernetesDeploymentTimeoutException。

  3. 請確定所有必要的重新導向設定內容皆已發佈至預覽階層。 這包括任何Dispatcher初始化所需的設定或內容,即使預覽層級不用於提供流量。

    • 檢閱您的部署程式,以確認用於發佈的相同重新導向和Dispatcher設定也可用於預覽。
    • 如果您使用內容套件或設定管理,請確認這些已部署至發佈和預覽層級。
  4. 檢查預覽Pod的健康狀態。

    • 使用您的Kubernetes工具(例如kubectl logs)來檢閱「預覽Pod」的Dispatcher容器記錄檔。
    • 尋找健康情況檢查失敗或重複重新啟動,這可能表示缺少設定。
  5. 將所需的設定發佈到預覽層級後,在Cloud Manager中重新執行生產部署管道。

  6. 驗證部署是否成功完成,以及所有Pod (包括預覽Pod)是否狀況良好。

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