在GitLab中创建Tag时查找源分支（使用gitlab-ci.yml）

Question

我目前正在尝试自动递增版本，追加SNAPSHOT到它并提交到使用 GitLab 12.9.2 和 GitLab-Shell 12.0.0 创建的给定标签的分支。

我知道，标签（尤其是发布标签）应该是从 master 创建的，但由于我可能会得到一个开发分支或其他分支，我想在其上标记提交，所以我想保留标记的能力给定的提交、构建、部署相应的工件（到 Nexus）、自动递增版本（例如从0.1.3到0.1.4-SNAPSHOT）并将其提交到创建标签的分支。

虽然所有其他步骤都有效，但我在最后一个步骤失败了，因为我找不到正确的环境变量，它引用了创建标签的提交（和分支）。

以下是 CI 文件的摘录：

build-release:
  extends: .build-template

  only:
    - tags

  before_script:
# Setup git
    - git config http.sslVerify false
    - git config user.email "git-bot@base/gitlab"
    - git config user.name "$GIT_CI_USER"
    - git remote set-url origin https://$GIT_CI_USER:$GIT_CI_PASSWORD@base/gitlab/development/particles/particles-front.git
    - git fetch
#    - git config http.sslCAInfo /etc/gitlab-runner/certs/base.crt ?
#    - git config http.sslCert /etc/gitlab-runner/certs/base.crt ? 

    - cd $CI_BUILDS_DIR/$SUB_PATH
# Install node_modules
    - npm install
# Show versions
    - node --version
    - npm --version
    - npm run ng version
# Save version for artifact-name
    - echo -n $CI_COMMIT_TAG > $CI_BUILDS_DIR/$SUB_PATH/version
# Set version back via npm in order to display it possibly on the user interface
    - npm version $(cat $CI_BUILDS_DIR/$SUB_PATH/version)

  after_script:
# Auto-Increment (patch-)version, append SNAPSHOT, commit & push
    - git checkout $CI_COMMIT_REF_NAME
    - cd $CI_BUILDS_DIR/$SUB_PATH
    - cat $CI_BUILDS_DIR/$SUB_PATH/version
    - npm version patch | cut -c 2-30 | tr -d '\n' > $CI_BUILDS_DIR/$SUB_PATH/version
    - echo -n -SNAPSHOT >> $CI_BUILDS_DIR/$SUB_PATH/version
    - npm version $(cat $CI_BUILDS_DIR/$SUB_PATH/version)
    - npm run prestart
    - git add ./package*.json ./src/_versions.ts
    - git status -sb
    - git commit -m "New Snapshot ($(cat $CI_BUILDS_DIR/$SUB_PATH/version))"
    - git push

我收到的错误（在最后一个命令中，如作业的输出控制台中所示）：

$ git push
fatal: You are not currently on a branch.
To push the history leading to the current (detached HEAD)
state now, use
    git push origin HEAD:<name-of-remote-branch>

注意：一切正常，除了提交 a$CI_COMMIT_REF_NAME似乎是一个坏主意，因为它只包含标签（在上面的情况下），但不包含创建标签的提交（因此是分支）。我在这里谈论这个特殊的值： 。

我已经阅读了各种其他与主题相关的 SO 问题（例如：How do I Push to a repo from inside a gitlab CI pipeline?），但它们似乎没有解决我的问题。使用另一个解决方案--points-at似乎很有趣，但我不知道如何以某种方式使用它，这将帮助我解决我的问题。

任何帮助表示赞赏！

Answer 1

printenv我喜欢使用的一个有用技巧是从管道作业运行Linux 命令。这会将所有环境变量（包括 GitLab 内置变量）打印到 stdout。然后你可以浏览这些并选择你想要的。

据我所知，可能对您有帮助的是提交 SHA 或提交消息。

使用提交 SHA

• CI_COMMIT_SHA
• CI_COMMIT_SHORT_SHA = CI_COMMIT_SHA 的前 8 位数字

CI_COMMIT_SHA指的是您创建标签的分支上的提交。获得提交 ID 后，您可以使用 GitLab REST API（例如使用 cURL、python requests 或 python-gitlab）来提取您需要的信息。请记住，一次提交可能属于多个分支，因此您需要弄清楚要针对哪个分支。

curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/5/repository/commits/$CI_COMMIT_SHA/refs?type=all"

[
  {"type": "branch", "name": "'test'"},
  {"type": "branch", "name": "add-balsamiq-file"},
  {"type": "branch", "name": "wip"},
  {"type": "tag", "name": "v1.1.0"}
 ]

要了解有关可以从提交 SHA 获取的信息的更多信息：

• https://docs.gitlab.com/ee/api/commits.html#get-a-single-commit
• https://docs.gitlab.com/ee/api/commits.html#get-references-a-commit-is-pushed-to

使用提交消息

• CI_COMMIT_MESSAGE = CI_COMMIT_TITLE + CI_COMMIT_DESCRIPTION
• CI_COMMIT_TITLE
• CI_COMMIT_DESCRIPTION

如果您遵循特定的 git 流程，提交消息可能会有所帮助。例如，当合并请求自动压缩提交并将功能分支合并到开发中时，这是自动生成的提交消息的格式。该消息来自的标签是由开发创建的：

Merge branch 'feature-branch-name' into 'develop'
Merge request title
See merge request group/project!123

注：第一行是CI_COMMIT_TITLE，后两行是CI_COMMIT_DESCRIPTION。CI_COMMIT_TITLE为您提供源分支和目标分支，同时CI_COMMIT_DESCRIPTION为您提供合并请求标题和 ID。您可以使用 GitLab REST API 从 MR ID 获取所需的几乎所有信息。

要详细了解您可以从合并请求 ID 获取哪些信息：

• https://docs.gitlab.com/ee/api/merge_requests.html#get-single-mr

不幸的是，如果您从功能分支创建标签，则COMMIT_MESSAGE只会向您提供由推送提交的用户编写的正常提交消息 - 可能不是很有趣。COMMIT_DESCRIPTION在这种情况下是空白的，所以也没有用。