10分钟搞定让你困惑的 Jenkins 环境变量过程详解

介绍 Jenkins 环境变量：十分钟快速上手

目录：

前言

Jenkins，作为 DevOps 技术栈的核心组件之一，在 CI/CD 流程中发挥着举足轻重的作用。编写 Pipeline 脚本时，如何高效利用环境变量，是每位 Jenkins 使用者必须掌握的技能。本文将带你快速通关 Jenkins 环境变量，让你的 Jenkins 使用体验更上一层楼。

准备

想要一边阅读本文一边实践？没有问题！即使没有 Jenkins 服务，也能通过 Docker 快速搭建一个 Jenkins 服务。只需一个命令，就能轻松启动 Jenkins 服务。打开终端，输入以下命令：

docker container run --rm -p 8080:8080 -p 50000:50000 --name=jenkins -v $(pwd):/var/jenkins_home jenkins/jenkins

然后，在浏览器中输入 localhost:8080，就能访问 Jenkins 了。接下来，我们就可以开始 Jenkins 环境变量的奥秘了。

认识 Jenkins 环境变量

Jenkins 环境变量是通过 env 关键字暴露出来的全局变量，可以在 Jenkins 文件的任何位置使用。它们就像编程语言中的全局变量一样，方便我们在 Pipeline 脚本中快速使用。

查看 Jenkins 系统内置环境变量

Jenkins 系统内置了许多环境变量，方便我们快速使用。查看这些环境变量有两种方式：

方式一：直接在浏览器中访问 ${YOUR_JENKINS_HOST}/env-vars.html 页面，比如

方式二：通过执行 printenv shell 命令来获取。在 Pipeline 脚本中，可以添加一个 stage，执行 sh "printenv" 命令，就能在终端日志中看到所有的环境变量以及它们的当前值。

通常，这两种方式可以结合使用，以便更全面地了解 Jenkins 的环境变量。

读取环境变量

在 Jenkins Pipeline 脚本中，使用 env 关键字可以读取环境变量。对于 Jenkins 系统内置的环境变量，env 关键字是可选的，但读取其他自定义环境变量时，必须使用 ${x} 包围起来。例如，${env.BUILD_NUMBER} 表示当前构建的编号。

本文详细介绍了 Jenkins 环境变量的相关知识，包括如何查看系统内置环境变量、如何读取环境变量等。通过本文的学习，相信读者能够轻松掌握 Jenkins 环境变量的使用方法，提高 Jenkins 的使用效率。希望本文能对读者在学习或工作中使用 Jenkins 有所帮助。在 Jenkins 中，环境变量的值通常被当作字符串处理，这意味着你不能直接设置布尔值或对象类型。你可以通过一些技巧来模拟这些类型的行为。例如，你可以使用字符串来表示布尔值，通过特定的字符串来表示真或假。对于对象类型，你可能需要将对象序列化为字符串，然后在时将其反序列化。

对于大多数用例来说，Jenkins 环境变量的值作为字符串已经足够满足需求了。Jenkins 的主要目的是构建和部署软件，环境变量通常用于存储配置信息或者状态信息，这些信息大多数情况下都是字符串类型。如果你需要在 Jenkins 脚本中使用更复杂的类型，你可能需要考虑使用其他机制，如使用 Jenkins 共享库来管理和共享复杂的配置和数据。

在 Jenkins 的 pipeline 中，我们经常需要处理各种数据类型，其中之一就是 Boolean 值。当我们在 Jenkins 中设置一个变量为 false 时，它会被自动转换为字符串 "false"。如果我们想对这个值进行布尔逻辑判断，就需要将其转换为真正的 Boolean 类型。这可以通过调用 toBoolean() 方法来实现。

以下是一个简单的 Jenkins pipeline 示例，展示了如何使用 Boolean 值：

```groovy

pipeline {

agent any

environment {

IS_BOOLEAN = false // 这个值被设置为 false

}

stages {

stage("环境变量操作") {

steps {

script {

// 由于非空字符串都被视为 Boolean.True，所以 "Hello" 会被打印出来

if (env.IS_BOOLEAN) {

echo "Hello"

}

// 通过 toBoolean() 方法进行真正的 Boolean 比较

if (env.IS_BOOLEAN.toBoolean() == false) {

echo "这是假值" // 当 IS_BOOLEAN 为 false 时，此消息会被打印出来

}

// 使用 ! 进行逻辑非操作，进一步验证 Boolean 值

if (!env.IS_BOOLEAN.toBoolean()) {

echo "这是另一种表示方式" // 当 IS_BOOLEAN 为 false 时，此消息同样会被打印出来

}

}

}

}

}

}

```

在 Jenkins 中，我们经常需要将 shell 命令的执行结果赋值给环境变量。这可以通过使用 sh 步骤并结合 returnStdout 参数来实现。以下是一个简单的示例：

```groovy

pipeline {

agent any

environment {

// 使用 trim() 去除结果中的空格，确保结果的准确性

LS_RESULT = sh(script: 'ls -lah', returnStdout: true).trim() // 执行 ls 命令并将结果赋值给 LS_RESULT 环境变量

}

stages {

stage("处理环境变量") {

steps {

echo "LS_RESULT 的值为：${env.LS_RESULT}" // 打印环境变量 LS_RESULT 的值

}

}

}

}

```

关于环境变量的使用，了解这些基本内容后，你应该能够解决大部分与 Jenkins 环境变量相关的问题。如果你有任何疑问或困惑，不妨回头查看一下这篇文章，或者搜索更多关于 Jenkins 环境变量的资料。希望这篇文章能帮助你更好地理解和使用 Jenkins 中的环境变量。狼蚁SEO博客也会持续更新更多关于 Jenkins 的优质内容，请大家多多关注和支持！