由於自訂驗證中的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

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

  1. 修改自訂驗證邏輯,透過檢查CM_BUILD=true環境變數來偵測它在Cloud Manager中執行的時機。
  2. 設定CM_BUILD=true時,略過需要分支資訊或Git歷程記錄的驗證邏輯。
  3. 或者,當分支資訊不可用時,更新驗證以正常處理分離的HEAD狀態並退出而不導致建置失敗。
  4. 在本機測試組建並設定CM_BUILD=true,以確認已略過或正確處理自訂驗證。
  5. 將更新的驗證邏輯提交到存放庫並推送變更。
  6. 在Cloud Manager中觸發新的管道執行。
  7. 確認建置通過自訂驗證步驟。
recommendation-more-help
experience-cloud-kcs-help-kbarticles