CODING DevOps 环境变量

这里说明如何在构建计划设置中设置环境变量。

一、进入项目

1. 登录 CODING 控制台，单击团队域名进入 CODING 使用页面。

2. 进入目标项目后，选择左侧导航栏的持续集成。

二、功能介绍

持续集成过程中，我们总会将一些配置（如：账号密码/版本号等）信息以环境变量的形式注入到构建过程中。CODING 持续集成支持多种环境变量使用形式，你可以同时使用以下几种方式来为构建过程注入环境变量，其优先级为从上到下（排在前面的配置优先级最高）：

·Jenkinsfile 中的 withEnv。

·Jenkinsfile 中的 environment。

·构建计划（Job）中的启动参数。

·构建计划（Job）设置中的环境变量。

·构建过程中系统内置的环境变量。

下文将详细介绍这几种方式的详细说明。

三、withEnv 与 environment

1. 你可以在 Jenkinsfile 中使用 environment 来定义环境变量（如下所示）：

pipeline { agent any environment { MY_PROJECT = 'project-1' MY_TEAM = 'team-1' } stages { stage('Build') { steps { echo "MY_PROJECT is ${MY_PROJECT}" echo "MY_TEAM is ${MY_TEAM}" // 输出内容如下所示： // MY_PROJECT is project-1 // MY_TEAM is team-1 } } }}

2. 在构建过程中，可能需要在不同的阶段使用同名的环境变量。可以使用 withEnv 来针对部分操作设置环境变量，避免全局的环境变量污染。 withEnv 中所执行的 step ，都将优先使用 withEnv 设置的环境变量。具体效果可以参考以下例子：

pipeline { agent any environment { MY_PROJECT = 'project-1' MY_TEAM = 'team-1' } stages { stage('Build') { steps { echo "MY_PROJECT is ${MY_PROJECT}" echo "MY_TEAM is ${MY_TEAM}" // 输出内容如下所示： // MY_PROJECT is project-1 // MY_TEAM is team-1 // withEnv 中设置的环境变量只对作用域下的 step 有效，优先级高于 environment withEnv(['MY_PROJECT=project-2']) { echo "MY_PROJECT is ${MY_PROJECT}" echo "MY_TEAM is ${MY_TEAM}" // 输出内容如下所示： // MY_PROJECT is project-2 // MY_TEAM is team-1 } } } }}

如果你想了解更多 Jenkinsfile 环境变量相关内容，请参见 使用环境变量。

四、构建计划中的启动参数

优先级仅次于 Jenkinsfile 中配置的环境变量，你可以在启动构建计划时，选择或填写对应的环境变量值。

五、添加环境变量

除了在 Jenkinsfile 中硬编码环境变量，还可以在构建计划的配置中进行设置。目前 CODING 支持添加以下四种类别的环境变量：字符串、单选、多选、CODING 凭据。你还可以将构建计划中的环境变量配置视为启动参数的默认值。

六、系统内置的环境变量

CODING 持续集成在构建过程中，会为每一个构建任务注入对应的环境变量，默认注入的环境变量列表你可以在构建快照中查看：

所有环境变量汇总如下，按照不同的触发规则（代码更新时触发、定时触发、合并请求时触发）进行分类介绍：