git - GitLab创建Tag时查找源分支(使用gitlab-ci.yml)

Question

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

我知道，标签(尤其是 release-tags)应该从 master 创建，但是因为我可能会得到一个 develop- 或其他分支，我想标记提交，我想保留能够标记给定的提交、构建、部署相应的工件(到 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>

注意:除了提交给 $CI_COMMIT_REF_NAME 似乎是个坏主意外，一切正常，因为它只包含标签(在上面的例子中)，但是不是创建标签的提交(因此是分支)。我在这里谈论这个特殊的值(value): .

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

感谢任何帮助!

Answer 1

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

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

使用提交 SHA

• CI_COMMIT_SHA
• CI_COMMIT_SHORT_SHA = CI_COMMIT_SHA 的前 8 位

CI_COMMIT_SHA 指的是您创建标签的分支上的提交。获得提交 ID 后，您可以使用 GitLab REST API(例如使用 cURL、python 请求或 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 请求自动压缩提交并将功能分支 merge 到开发时自动生成的提交消息的格式。此消息来自的标记是从 develop 创建的:

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 为您提供 merge 请求标题和 ID。您可以使用 GitLab REST API 从 MR ID 中获取几乎所有需要的信息。

要详细了解您可以从 merge 请求 ID 中获取哪些信息:

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

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