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