由於自訂驗證中的HEAD分離,AEM Cloud Manager建置失敗
✨ 此內容是AI產生的,可能不準確。 產生AI辭彙
本文說明當自訂驗證步驟因存放庫處於分離的HEAD狀態而失敗時,如何解決Adobe Experience Manager Cloud Manager管道中的建置失敗。
說明 description
環境
- Adobe Experience Manager (AEM) as a Cloud Service (所有版本)
症狀
在模組中的自訂驗證步驟期間,Cloud Manager管道建置失敗。 當自訂驗證嘗試確定目前的Git分支,但存放庫處於分離的HEAD狀態(這是Cloud Manager組建中的標準狀態)時,就會發生錯誤。
建置記錄檔中出現下列錯誤:
java.lang.IllegalStateException: Unable to determine current Git branch. Repository is in detached HEAD state.
建置記錄也顯示指示淺層出庫和分離的HEAD狀態的命令:
git fetch --depth 1 origin <commit-hash>
git checkout FETCH_HEAD
You are in 'detached HEAD' state.
當自訂驗證需要分支資訊和Git記錄時,在Cloud Manager中執行的每個管道都會發生此問題。
原因
自訂驗證步驟會失敗,因為它需要Git分支資訊和歷史記錄,這些在Cloud Manager的淺層、分離的HEAD結帳中無法使用。
解決方法 resolution
請依照下列步驟解決問題:
- 修改自訂驗證邏輯,透過檢查
CM_BUILD=true環境變數來偵測它在Cloud Manager中執行的時機。 - 設定
CM_BUILD=true時,略過需要分支資訊或Git歷程記錄的驗證邏輯。 - 或者,當分支資訊不可用時,更新驗證以正常處理分離的HEAD狀態並退出而不導致建置失敗。
- 在本機測試組建並設定
CM_BUILD=true,以確認已略過或正確處理自訂驗證。 - 將更新的驗證邏輯提交到存放庫並推送變更。
- 在Cloud Manager中觸發新的管道執行。
- 確認建置通過自訂驗證步驟。
recommendation-more-help
experience-cloud-kcs-help-kbarticles