如何将Python脚本生成的递增版本号传递给Jenkinsfile的description字段？

方案一：用临时文件传递版本号（推荐） #

这种方式能让Python脚本的执行日志正常输出到Jenkins控制台，同时把版本号单独存入文件，Jenkinsfile直接读取文件即可，逻辑清晰且异常处理符合预期。

Python脚本修改： #

在脚本完成版本号递增后，把版本号写入一个临时文件（比如version.txt），正常日志仍用print输出：

# 正常打印执行步骤
print("开始读取当前版本号...")
# 这里替换成你的版本递增逻辑
current_version = "1.0.0"
new_version = f"{current_version.split('.')[0]}.{current_version.split('.')[1]}.{int(current_version.split('.')[2])+1}"
# 写入临时文件
with open("version.txt", "w") as f:
    f.write(new_version)
# 继续打印执行结果
print(f"版本号已成功递增为：{new_version}")

Jenkinsfile修改： #

先执行Python脚本（不用捕获stdout，控制台直接显示所有日志），再读取临时文件的内容设置构建描述：

// 执行Python脚本，控制台实时输出执行步骤
sh "python test.py"
// 读取版本文件内容，去除首尾空白字符
def newVersion = readFile("version.txt").trim()
// 设置构建描述
currentBuild.description = "递增后版本号：${newVersion}"

如果Python脚本执行出错，sh步骤会直接返回失败，Jenkins构建自动终止，逻辑正常。

方案二：用标记提取版本号 #

如果不想生成临时文件，可以让Python脚本把版本号用唯一标记包裹输出，Jenkinsfile捕获所有输出后通过正则提取，同时把输出打印到控制台。

Python脚本修改： #

在输出版本号时加上唯一标记（比如###VERSION###:）：

print("正在校验版本号格式...")
new_version = "1.0.1"
// 带标记输出版本号
print(f"###VERSION###:{new_version}")
print("版本号递增流程完成")

Jenkinsfile修改： #

// 捕获脚本所有输出
def scriptOutput = sh(returnStdout: true, script: "python test.py")
// 把输出打印到控制台，保留执行步骤
echo scriptOutput
// 用正则匹配提取版本号
def versionMatcher = scriptOutput =~ /###VERSION###:(.*)/
if (versionMatcher.find()) {
    def newVersion = versionMatcher.group(1).trim()
    currentBuild.description = "递增后版本号：${newVersion}"
} else {
    // 未找到版本号时抛出错误终止构建
    error "未从Python脚本中获取到有效版本号"
}

这种方式同样能保留控制台日志，异常时scriptOutput会包含错误信息，echo后能定位问题，同时sh步骤会返回非零码终止构建。

方案三：类Unix环境下用环境变量传递（局限性较强） #

仅适用于Linux/macOS环境，Python脚本输出环境变量赋值语句，Jenkinsfile执行后加载该变量：

Python脚本修改： #

new_version = "1.0.2"
// 输出环境变量赋值语句
print(f"export NEW_VERSION={new_version}")

Jenkinsfile修改： #

def envCmd = sh(returnStdout: true, script: "python test.py")
echo envCmd
// 执行赋值语句，把版本号存入环境变量
sh envCmd
// 从环境变量中获取版本号
def newVersion = env.NEW_VERSION
currentBuild.description = "递增后版本号：${newVersion}"

注意：如果Python脚本有其他输出，需要确保只有最后一行是export语句，否则会执行失败，通用性不如前两个方案。

内容的提问来源于stack exchange，提问作者gozheng