在 jenkins 中通过 global properties 配置 version_prefix 和 release_repo_url 两个全局环境变量,可实现跨 job 复用版本号与仓库地址;自由风格项目中直接引用 $version_prefix,pipeline 中用 ${env.version_prefix},maven 需启用环境变量注入选项。

在 Linux 系统中,通过 Jenkins 的 Global Properties → Environment Variables 定义构建版本号与发布仓库地址,是实现跨 Job 复用配置、避免硬编码的关键一步。核心在于:变量要可被所有流水线或自由风格任务直接引用,且值需稳定、易维护。
一、进入全局环境变量配置界面
登录 Jenkins 后,按顺序操作:
- 点击左栏 Manage Jenkins
- 选择 Configure System
- 向下滚动至 Global Properties 区域
- 勾选 Environment variables
- 点击 Add 添加变量对
二、定义两个关键全局变量
推荐添加以下两项(变量名区分大小写,建议全大写):
在无 root/sudo 权限的环境(云容器、VPS、隔离主机)中安装并配置 OpenClaw 浏览器工具的 headless Chrome。适用场景:...
-
VERSION_PREFIX → 值如:
1.2.0(主版本基线,手动维护) -
RELEASE_REPO_URL → 值如:
https://nexus.example.com/repository/maven-releases/(Nexus 或 Artifactory 的发布仓库地址)
注意:不要包含空格或特殊字符;URL 末尾斜杠建议保留,避免后续拼接出错。
三、在构建中正确引用这些变量
不同上下文引用方式略有差异,但都无需前缀 ${env.}(仅在 Pipeline 脚本中需显式写):
-
自由风格项目(Freestyle)的 Shell 构建步骤中:直接使用
$VERSION_PREFIX和$RELEASE_REPO_URL -
Pipeline(Jenkinsfile)中:写成
${env.VERSION_PREFIX}或env.VERSION_PREFIX(Groovy 语法) -
Maven Goals 中(如
deploy):可通过-Dversion=${VERSION_PREFIX}.${BUILD_NUMBER}传参,前提是 Maven 插件已启用“Inject environment variables to the build process”选项
四、增强实用性的小技巧
单纯静态值不够灵活?可搭配以下方式提升可用性:
- 用
BUILD_NUMBER动态补全版本:例如工件名写成app-${VERSION_PREFIX}-${BUILD_NUMBER}.jar,BUILD_NUMBER是 Jenkins 内置变量,无需额外定义 - 敏感信息(如仓库密码)不放这里:全局变量明文可见,应改用 Credentials Binding 插件注入
- 若需自动递增 minor/patch 版本,建议用 Pipeline 脚本读取 Git tag 或调用外部服务生成,而非依赖全局变量硬编码










