## Jenkins 全局变量### 简介Jenkins 全局变量是一组预定义的变量,它们在 Jenkins 环境中始终可用,可以用于在构建脚本、作业配置和插件中访问各种信息和配置。全局变量提供了一种便捷的方式来引用关键信息,例如构建环境、作业信息、Jenkins 配置和系统信息等。### 全局变量类型Jenkins 全局变量主要分为以下几类:#### 1. 环境变量
BUILD_NUMBER
: 构建编号,每次构建都会递增。
BUILD_ID
: 构建 ID,包含 BUILD_NUMBER 和时间戳。
BUILD_TAG
: 构建标签,用于区分不同版本的构建。
JOB_NAME
: Jenkins 作业的名称。
WORKSPACE
: Jenkins 作业的工作目录。
NODE_NAME
: 执行构建的节点名称。
EXECUTOR_NUMBER
: 执行构建的执行器编号。
JENKINS_URL
: Jenkins 服务器的 URL。
JENKINS_HOME
: Jenkins 安装目录。
JENKINS_USER
: Jenkins 用户名。#### 2. 系统信息
OS
: 运行 Jenkins 的操作系统。
ARCH
: 系统架构,例如 x86_64。
JAVA_HOME
: Java 安装目录。#### 3. 构建参数
参数名称
: 根据在 Jenkins 作业中定义的参数名称访问参数值。
参数类型
: 参数类型,例如字符串、布尔值、文件等。#### 4. 插件变量一些插件会定义自定义的全局变量,用于访问插件特定的功能和信息。### 使用方法#### 1. 构建脚本在 Jenkins 构建脚本(如 shell 脚本、批处理脚本、groovy 脚本等)中,可以直接使用全局变量名访问其值。例如:```sh echo "当前构建编号:$BUILD_NUMBER" echo "当前工作目录:$WORKSPACE" ```#### 2. 作业配置在 Jenkins 作业配置页面,可以通过 "构建后操作" 或 "构建环境" 选项,使用全局变量来配置构建行为。例如:
将构建结果发布到邮件列表:使用 `$BUILD_NUMBER` 作为邮件主题。
将构建输出文件保存到特定目录:使用 `$JOB_NAME` 和 `$BUILD_NUMBER` 组成目录名称。#### 3. 插件一些插件会使用全局变量来访问 Jenkins 环境信息,并提供更强大的功能。例如:
Git 插件
: 使用 `GIT_COMMIT` 访问当前提交的哈希值。
SonarQube 插件
: 使用 `SONAR_URL` 访问 SonarQube 服务器地址。### 注意事项
全局变量名称区分大小写。
一些全局变量可能在特定情况下不可用,例如未配置参数的构建参数变量。
某些插件可能会使用自定义全局变量,需要参考插件文档了解其使用方式。### 总结Jenkins 全局变量是构建和管理 Jenkins 作业的关键工具,它们简化了构建脚本编写、配置和插件使用,提高了代码复用性和可维护性。了解和使用这些变量可以帮助您更好地利用 Jenkins 功能,自动化构建流程,提高效率和可靠性。
Jenkins 全局变量
简介Jenkins 全局变量是一组预定义的变量,它们在 Jenkins 环境中始终可用,可以用于在构建脚本、作业配置和插件中访问各种信息和配置。全局变量提供了一种便捷的方式来引用关键信息,例如构建环境、作业信息、Jenkins 配置和系统信息等。
全局变量类型Jenkins 全局变量主要分为以下几类:
1. 环境变量* **BUILD_NUMBER**: 构建编号,每次构建都会递增。 * **BUILD_ID**: 构建 ID,包含 BUILD_NUMBER 和时间戳。 * **BUILD_TAG**: 构建标签,用于区分不同版本的构建。 * **JOB_NAME**: Jenkins 作业的名称。 * **WORKSPACE**: Jenkins 作业的工作目录。 * **NODE_NAME**: 执行构建的节点名称。 * **EXECUTOR_NUMBER**: 执行构建的执行器编号。 * **JENKINS_URL**: Jenkins 服务器的 URL。 * **JENKINS_HOME**: Jenkins 安装目录。 * **JENKINS_USER**: Jenkins 用户名。
2. 系统信息* **OS**: 运行 Jenkins 的操作系统。 * **ARCH**: 系统架构,例如 x86_64。 * **JAVA_HOME**: Java 安装目录。
3. 构建参数* **参数名称**: 根据在 Jenkins 作业中定义的参数名称访问参数值。 * **参数类型**: 参数类型,例如字符串、布尔值、文件等。
4. 插件变量一些插件会定义自定义的全局变量,用于访问插件特定的功能和信息。
使用方法
1. 构建脚本在 Jenkins 构建脚本(如 shell 脚本、批处理脚本、groovy 脚本等)中,可以直接使用全局变量名访问其值。例如:```sh echo "当前构建编号:$BUILD_NUMBER" echo "当前工作目录:$WORKSPACE" ```
2. 作业配置在 Jenkins 作业配置页面,可以通过 "构建后操作" 或 "构建环境" 选项,使用全局变量来配置构建行为。例如:* 将构建结果发布到邮件列表:使用 `$BUILD_NUMBER` 作为邮件主题。 * 将构建输出文件保存到特定目录:使用 `$JOB_NAME` 和 `$BUILD_NUMBER` 组成目录名称。
3. 插件一些插件会使用全局变量来访问 Jenkins 环境信息,并提供更强大的功能。例如:* **Git 插件**: 使用 `GIT_COMMIT` 访问当前提交的哈希值。 * **SonarQube 插件**: 使用 `SONAR_URL` 访问 SonarQube 服务器地址。
注意事项* 全局变量名称区分大小写。 * 一些全局变量可能在特定情况下不可用,例如未配置参数的构建参数变量。 * 某些插件可能会使用自定义全局变量,需要参考插件文档了解其使用方式。
总结Jenkins 全局变量是构建和管理 Jenkins 作业的关键工具,它们简化了构建脚本编写、配置和插件使用,提高了代码复用性和可维护性。了解和使用这些变量可以帮助您更好地利用 Jenkins 功能,自动化构建流程,提高效率和可靠性。