Pipeline git 全局变量

• Environment Variables
  • Branch Variables
  • Commit Variables
  • System Configuration Variables
  • Token Macro Variables

Environment Variables

git 插件在多个上下文中为环境变量赋值。环境变量在 Freestyle、Pipeline、Multibranch Pipeline 和 Organization Folder 项目中分配。

Branch Variables

变量名	作用
GIT_BRANCH	远程分支名称（如果有）
GIT_LOCAL_BRANCH	正在检出的本地分支机构名称（如果适用）。
GIT_CHECKOUT_DIR	存储库将检出到的目录。这包含在 Checkout 中设置到子目录的值（如果使用）。

Commit Variables

变量名	作用
GIT_COMMIT	此构建中使用的提交的 SHA-1
GIT_PREVIOUS_COMMIT	此项目先前构建中使用的提交的 SHA-1
GIT_PREVIOUS_SUCCESSFUL_COMMIT	该项目最近一次成功构建中使用的提交的 SHA-1

System Configuration Variables

变量名	作用
GIT_URL	此工作区中第一个 git 存储库的远程 URL
GIT_URL_n	此工作区中其他 git 存储库的远程 URL（如果有）
GIT_AUTHOR_EMAIL	将用于此工作区中的新提交的作者电子邮件地址
GIT_AUTHOR_NAME	将用于此工作区中的新提交的作者姓名
GIT_COMMITTER_EMAIL	将用于此工作区中的新提交的提交者电子邮件地址
GIT_COMMITTER_NAME	将用于此工作区中的新提交的提交者名称

Token Macro Variables

一些 Jenkins 插件（如：email extension、build name setter 和 description setter）允许参数化引用重新格式化支持的变量的文本。支持参数化引用以重新格式化其文本的变量称为 “令牌宏”。git 插件为以下内容提供令牌宏：

变量名	作用
GIT_REVISION	扩展到 Git SHA1 提交 ID，该 ID 指向构建的提交
length	应显示的提交 ID 的整数长度。${GIT_REVISION} 可能会扩大到 a806ba7701bcfc9f784ccb7854c26f03e045c1d2，而 ${GIT_REVISION, length=8} 会扩大到 a806ba77
GIT_BRANCH	扩展为已构建的分支的名称
all	布尔值，在启用时扩展到指向当前提交的所有分支名称。默认情况下，令牌仅扩展为一个分支名称
fullName	扩展为完整分支名称的布尔值，例如：remotes/origin/masteror 或 origin/master。否则，它会扩展为短名称，例如：master

令牌宏最常见的用途是在 Freestyle 项目中。Jenkins Pipeline 支持丰富的字符串操作集，因此在 Pipelines 中通常不使用令牌宏。

当与 Pipeline 一起使用时，令牌宏基值通常由 Pipeline 中执行的第一次检出分配。随后的检出操作不会修改管道中令牌宏的值。