Jenkins 内置变量

 

BRANCH_NAME

　　对于多分支项目，这将设置为正在构建的分支的名称，例如，如果您希望master从功能分支而不是从功能分支部署到生产；如果对应于某种更改请求，则名称通常是任意的（参见CHANGE_ID和CHANGE_TARGET）。

BRANCH_IS_PRIMARY

　　对于多分支项目，如果 SCM 源报告正在构建的分支是主分支，这将设置为"true"; 否则未设置。一些 SCM 来源可能将多个分支报告为主要分支，而其他来源可能不提供此信息。

CHANGE_ID

　　对于对应于某种变更请求的多分支项目，如果支持，这将设置为变更 ID，例如拉取请求编号；否则未设置。

CHANGE_URL

　　对于对应于某种变更请求的多分支项目，如果支持，这将被设置为变更 URL；否则未设置。

CHANGE_TITLE

　　对于对应于某种变更请求的多分支项目，如果支持，这将被设置为变更的标题；否则未设置。

CHANGE_AUTHOR

　　对于对应于某种变更请求的多分支项目，如果支持，这将被设置为提议变更的作者的用户名；否则未设置。

CHANGE_AUTHOR_DISPLAY_NAME

　　对于对应于某种变更请求的多分支项目，如果支持，这将设置为作者的人名；否则未设置。

CHANGE_AUTHOR_EMAIL

　　对于对应于某种变更请求的多分支项目，如果支持，这将设置为作者的电子邮件地址；否则未设置。

CHANGE_TARGET

　　对于对应于某种变更请求的多分支项目，如果支持，这将设置为目标或基础分支，变更可以合并到该分支；否则未设置。

CHANGE_BRANCH

　　对于对应于某种更改请求的多分支项目，这将设置为源代码控制系统上实际负责人的名称，该名称可能与BRANCH_NAME. 例如，在 GitHub 或 Bitbucket 中，这将具有源分支的名称，而BRANCH_NAME类似于PR-24.

CHANGE_FORK

　　对于对应于某种变更请求的多分支项目，如果变更源自一个分支，这将被设置为分叉存储库的名称；否则未设置。

TAG_NAME

　　对于对应于某种标签的多分支项目，如果支持，这将被设置为正在构建的标签的名称；否则未设置。

TAG_TIMESTAMP

　　对于对应于某种标签的多分支项目，如果支持，这将设置为自 Unix 纪元以来以毫秒为单位的标签时间戳；否则未设置。

TAG_UNIXTIME

　　对于对应于某种标签的多分支项目，如果支持，这将被设置为自 Unix 纪元以来以秒为单位的标签时间戳；否则未设置。

TAG_DATE

　　对于对应于某种标签的多分支项目，如果支持，这将被设置为java.util.Date#toString()定义的格式的时间戳（例如，Wed Jan 1 00:00:00 UTC 2020） ; 否则未设置。

JOB_DISPLAY_URL

　　将重定向到首选用户界面中的作业的 URL

RUN_DISPLAY_URL

　　将重定向到首选用户界面中的构建的 URL

RUN_ARTIFACTS_DISPLAY_URL

　　将重定向到首选用户界面中的构件的 URL

RUN_CHANGES_DISPLAY_URL

　　将重定向到首选用户界面中构建的变更日志的 URL

RUN_TESTS_DISPLAY_URL

　　将重定向到首选用户界面中构建的测试结果的 URL

CI

　　静态设置为字符串“true”以指示“持续集成”执行环境。

BUILD_NUMBER

　　当前内部版本号，例如“153”。

BUILD_ID

　　当前构建 ID，与 1.597+ 中创建的构建的 BUILD_NUMBER 相同，但旧构建的 YYYY-MM-DD_hh-mm-ss 时间戳。

BUILD_DISPLAY_NAME

　　当前构建的显示名称，默认类似于“#153”。

JOB_NAME

　　此构建的项目名称，例如“foo”或“foo/bar”。

JOB_BASE_NAME

　　剥离文件夹路径的此构建项目的短名称，例如“bar/foo”的“foo”。

BUILD_TAG

　　“jenkins- ${JOB_NAME} - ${BUILD_NUMBER} ”的字符串。JOB_NAME 中的所有正斜杠（“/”）都替换为破折号（“-”）。方便放入资源文件、jar文件等，方便识别。

EXECUTOR_NUMBER

　　标识执行此构建的当前执行程序（在同一台机器的执行程序中）的唯一编号。这是您在“构建执行程序状态”中看到的数字，只不过数字从 0 开始，而不是从 1 开始。

NODE_NAME

　　如果构建在代理上，则代理的名称，如果在主服务器上运行，则为“主”。

NODE_LABELS

　　为节点分配的以空格分隔的标签列表。

WORKSPACE

　　作为工作区分配给构建的目录的绝对路径。

WORKSPACE_TMP

　　工作区附近的临时目录，不可浏览且不会干扰 SCM 签出。最初可能不存在，所以一定要根据需要创建目录（例如，mkdir -p在 Linux 上）。当常规工作区是驱动器根时未定义。

JENKINS_HOME

　　Jenkins在master节点上分配的存放数据的目录的绝对路径。

JENKINS_URL

　　Jenkins 的完整 URL，如http://server:port/jenkins/（注意：仅当Jenkins URL在系统配置中设置时可用）。

BUILD_URL

　　此构建的完整 URL，例如http://server:port/jenkins/job/foo/15/（必须设置Jenkins URL）。

JOB_URL

　　此作业的完整 URL，例如http://server:port/jenkins/job/foo/（必须设置Jenkins URL）。

GIT_COMMIT

　　被检出的提交哈希。

GIT_PREVIOUS_COMMIT

　　最后在此分支上构建的提交的哈希值（如果有）。

GIT_PREVIOUS_SUCCESSFUL_COMMIT

　　上次在此分支上成功构建的提交的哈希值（如果有）。

GIT_BRANCH

　　远程分支名称（如果有）。

GIT_LOCAL_BRANCH

　　被检出的本地分支名称（如果适用）。

GIT_CHECKOUT_DIR

　　存储库将被检出到的目录。这包含在 Checkout 中设置到子目录的值（如果使用）。

GIT_URL

　　远程 URL。如果有多个，会GIT_URL_1，GIT_URL_2等等。

GIT_COMMITTER_NAME

　　配置的 Git 提交者名称（如果有），将用于当前工作区的 FUTURE 提交。它是从Jenkins配置系统页面的全局配置用户名值字段中读取的。

GIT_AUTHOR_NAME

　　配置的 Git 作者姓名（如果有），将用于当前工作区的 FUTURE 提交。它是从Jenkins配置系统页面的全局配置用户名值字段中读取的。

GIT_COMMITTER_EMAIL

　　配置的 Git 提交者电子邮件（如果有），将用于当前工作区的 FUTURE 提交。它是从Jenkins配置系统页面的全局配置 user.email 值字段中读取的。

GIT_AUTHOR_EMAIL

　　配置的 Git 作者电子邮件（如果有），将用于当前工作区的 FUTURE 提交。它是从Jenkins配置系统页面的全局配置 user.email 值字段中读取的。

SVN_REVISION

　　当前检出到工作区的 Subversion 修订号，例如“12345”

SVN_URL

　　当前检出到工作区的 Subversion URL。