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狀況良好。