AEM Cloud Manager DEV部署因XML和ClientLib錯誤而失敗

本文說明在Adobe Experience Manager (AEM) Cloud Manager DEV環境中,XML語法錯誤和使用者端程式庫編譯問題導致部署失敗和部署時間增加的原因和解決步驟。

說明 description

環境

  • Adobe Experience Manager (AEM) Cloud Manager (所有版本)

問題/症狀

  • 開發部署需要的時間比平常長很多(超過兩個小時),最終會在部署階段失敗。

  • 部署管道通過驗證、建置、單元測試、計畫碼掃描和影像建置階段,但在部署到開發階段失敗。

  • 部署記錄顯示與內容套件中缺少XML結束標籤相關的錯誤,例如:

    專案型別「content」必須以相符的結尾標籤「< /content> 」終止。

    專案型別「header」必須以相符的結束標籤「< /header> 」終止。

  • 由於XML剖析錯誤,發佈套件匯入失敗。

  • 發生使用者端程式庫(ClientLib) LESS編譯錯誤,例如未定義的變數(例如@white)和遺失mixin。

  • 未解析的自訂模型類別會發生Java編譯錯誤。

  • 這些錯誤之前已存在,但不會導致部署失敗。 它們現在會導致管道故障。

原因

由於XML語法錯誤(遺失結束標籤)、未解析的使用者端程式庫變數或mixin以及遺失自訂Java模型類別,因此會發生部署失敗。 最近的管道或環境變更可能會導致這些問題使部署失敗,即使這些問題之前沒有封鎖。

解決方法 resolution

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

  1. 存取失敗部署的Cloud Manager管道執行記錄檔。
  2. 識別所有XML剖析錯誤和使用者端程式庫編譯錯誤。
  3. 找出參照的XML檔案,例如,在/conf/.../settings/wcm/templates/底下。
  4. 請確定所有XML元素(例如<content><header>)都包含相符的結束標籤,例如</content></header>
  5. 在認可變更之前,使用XML驗證器驗證XML結構。
  6. 檢閱LESS和CSS檔案以取得未定義的變數,例如@white@mid-blue,以及遺失mixin,例如.label-small-style().media()
  7. 定義缺少的變數和mixin,或更新匯入以包含必要的定義。
  8. 在本機重建使用者端程式庫,以確認編譯成功。
  9. 確認元件參考的所有自訂Sling模型類別都存在,並正確匯入程式碼基底中。
  10. 解決任何遺失的相依性或不正確的套件參照。
  11. 完成必要的更正後,將變更提交至存放庫。
  12. 在Cloud Manager中觸發新部署,並監視管道以確認其成功完成。
recommendation-more-help
experience-cloud-kcs-help-kbarticles