由于自定义验证中的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