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 功能,自动化构建流程,提高效率和可靠性。

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 功能,自动化构建流程,提高效率和可靠性。

Powered By Z-BlogPHP 1.7.2

备案号:蜀ICP备2023005218号