jenkins 内置变量

Posted 2021-03-15 lgj8

${BUILD_NUMBER}， 唯一标识一次build，例如11；

${BUILD_ID}，基本上等同于BUILD_NUMBER，但是是字符串，例如20111115160621；

${JOB_NAME}， job的名字，例如JavaHelloWorld；

${BUILD_TAG}，作用同BUILD_ID,BUILD_NUMBER,用来全局地唯一标识一此build，例如jenkins-JavaHelloWorld-11；

${EXECUTOR_NUMBER}， 例如0；

${NODE_NAME}，slave的名字，例如MyServer01；

${NODE_LABELS}，slave的label，标识slave的用处，例如JavaHelloWorld MyServer01；

${JAVA_HOME}， java的home目录，例如C:Program Files (x86)Javajdk1.7.0_01；

${WORKSPACE}，job的当前工作目录，例如c:jenkinsworkspaceJavaHelloWorld；

${HUDSON_URL} = ${JENKINS_URL}， jenkins的url，例如http://localhost:8000/ ；

${BUILD_URL}，build的url 例如http://localhost:8000/job/JavaHelloWorld/23/；

${JOB_URL}， job的url，例如http://localhost:8000/job/JavaHelloWorld/；

${FAILED_TESTS} #如果任何测试失败，则显示失败的单元测试信息。
　　showStack #在失败的测试输出中显示堆栈跟踪。默认为true。
　　showMessage #在测试输出失败时显示错误消息。默认为true。
　　maxTests #最多显示这么多测试。默认情况下不设置限制。
　　onlyRegressions #仅显示与先前构建不同的失败测试。默认为false。

${TEST_COUNTS,var="TYPE"} #根据传入的类型（var）显示测试数（总计，通过，失败，跳过）。默认为总计。

${GIT_BRANCH} #扩展为已构建的分支的名称。

　　Parameters
　　all #如果指定，则列出指向给定提交的所有分支。默认情况下，令牌会扩展为其中一个。
　　fullName #如果指定，则此标记将扩展为完整的分支名称，例如“origin / master”。否则，它只会扩展为短名称，例如“master”。

${GIT_REVISION} #扩展为指向已构建的提交的Git SHA1提交ID。

　　Parameters
　　length=N (optional, default to 40) #指定提交ID长度。完整的SHA1提交ID长度为40个字符，但通常会将其剪切为8或12，因为它通常提供足够的唯一性并且更加清晰。

${ADMIN_EMAIL} #显示Jenkins管理员的电子邮件地址

${BUILD_CAUSE} ${CAUSE} #显示构建的原因。

${BUILD_LOG_EXCERPT} #显示构建日志的摘录。
　　start #正则表达式匹配摘录起始行（排除匹配行）。
　　end #正则表达式匹配摘录结束行（排除匹配行）。

${BUILD_LOG} #显示构建日志结尾。
　　maxLines #最多显示这么多行的日志。默认为250。
　　escapehtml #如果为true，则HTML将被转义。默认为false。

${BUILD_LOG_MULTILINE_REGEX} #显示与正则表达式匹配的构建日志段。
　　regex #java.util.regex.Pattern包含与此正则表达式匹配的构建日志的段。另请参见null。没有默认值。必需参数
　　maxMatches #要包含的最大匹配数。如果为0，则将包括所有匹配。默认为0。
　　showTruncatedLines #如果为true，则包括[...截断的### lines ...]行。默认为true。
　　substText #如果为非null，请将此文本插入电子邮件而不是整个段。默认为null。
　　escapeHtml #如果为true，则转义HTML。默认为false。
　　matchedSegmentHtmlStyle #如果为非null，则输出HTML。匹配的行将变为<b style =“your-style-value”> html转义匹配行</ b>。默认为null。

${BUILD_LOG_REGEX} #显示构建日志中与正则表达式匹配的行。
　　regex #包含与此正则表达式匹配的行。另请参见java.util.regex.Pattern.Defaults to“（？i）\ b（error | exception | fatal | fail（ed | ure）| un（defined | resolved））\ b”
　　linesBefore #匹配行之前要包含的行数。与另一个匹配或linesAfter重叠的行仅包含一次。默认为0。
　　linesAfter #匹配行后要包含的行数。与另一个匹配或linesBefore重叠的行只包含一次。默认为0。
　　maxMatches #要包含的最大匹配数。如果为0，则将包括所有匹配。默认为0。
　　showTruncatedLines #如果为true，则包括[...截断的### lines ...]行。默认为true。
　　substText #如果为非null，请将此文本插入电子邮件而不是整行。默认为null。
　　escapeHtml #如果为true，则转义HTML。违约是假的。
　　matchedLineHtmlStyle #如果为非null，则输出HTML。匹配的行将变为<b style =“your-style-value”> html转义匹配行</ b>。默认为null。
　　addNewline #如果为true，则在subsText之后添加换行符。默认为true。
　　defaultValue #如果没有替换任何内容，将使用此值。

${BUILD_NUMBER} #扩展为当前内部版本号，这是一个标识构建的顺序自动递增唯一编号，例如“125”

${BUILD_STATUS} #显示当前构建的状态。（failing, success等......）

${BUILD_URL} #显示当前构建的URL

${CHANGES_SINCE_LAST_BUILD} ${CHANGES} #显示自上次构建以来的更改。并非所有修订系统都支持％d和％r。如果指定showPaths参数被忽略。默认为“[％a]％m \ n”
　　showDependencies #如果为true，则显示此构建所依赖的项目的更改。默认为false
　　showPaths #如果为true，则显示由提交修改的路径。默认为false
　　format #对于列出的每个提交，包含％X的字符串，其中％x是以下之一：%a（作者）、%d(日期）、%m(信息)、%p(路径)、%r(版本)
　　pathFormat #包含％p的字符串，指示如何打印路径。Defaults to "\t%p\n"
　　regex #正则表达式。
　　replace #替换与给定正则表达式匹配的更改消息的所有子字符串。
　　default #未检测到更改时使用的消息。默认为“无更改 n”

${CHANGES_SINCE_LAST_SUCCESS} #显示自上次成功构建以来的更改。默认为#%n %c
　　reverse #如果为true，则将最新版本显示在顶部而不是底部。默认为false。
　　format #对于列出的每个构建，包含％X的字符串，其中％X是其中之一
　　%c #变化
　　%n #编号
　　changesFormat #对于构建中的每个更改。

${CHANGES_SINCE_LAST_UNSTABLE} #扩展到自上次不稳定或成功构建以来的更改。参数跟上面一样

${ENV,var="VARIABLENAME"} #从构建环境扩展到环境变量（此处指定为VARIABLENAME）。请注意，这不包括构建脚本本身设置的任何变量，只包括由Jenkins和其他插件设置的变量。

${JENKINS_URL} #显示Jenkins服务器的URL。 （您可以在系统配置页面上更改此设置。）

${JOB_DESCRIPTION} #显示作业的说明。

${LOG_REGEX} #使用正则表达式查找单个日志条目，并使用其中的捕获组生成新输出。这部分基于description-setter插件（https://github.com/jenkinsci/description-setter-plugin）。

${PROJECT_NAME} #显示项目的全名。 （参见AbstractProject.getFullDisplayName）

${PROJECT_DISPLAY_NAME} #显示项目的显示名称。 （参见AbstractProject.getDisplayName）

${PROJECT_URL} #显示项目页面的URL。

${PROPFILE,file="FILENAME",property="PROPERTYNAME"} #扩展为属性文件中的属性值。文件名相对于构建工作区根目录。

${FILE,path="PATH"} #扩展为文件的内容。文件路径相对于构建工作空间根目录。

${XML,file="FILE",xpath="XPATH"} #扩展到针对给定XML文件运行的XPath表达式的结果。如果XPath求值为多个值，则返回以分号分隔的字符串。文件路径相对于构建工作空间根目录。