Jenkins声明式流水线：VERSION变量声明及脚本/邮件注入问题

我来帮你梳理下问题并给出解决方案：

核心问题分析 #

你当前的代码里，在Prepare & Checkout阶段定义的是局部Groovy变量VERSION，没有把它注入到Jenkins的全局环境变量（env对象）中，这就导致：

1. 构建脚本build.sh无法读取到这个变量（因为shell环境看不到Groovy局部变量）
2. 后续stage和post块可能因为作用域问题无法访问该变量

另外你之前遇到的MissingPropertyException，本质原因是在声明式流水线的steps块中直接写了Groovy控制流语句（if），声明式流水线要求所有自定义Groovy逻辑必须包裹在script步骤里，否则会被当作Jenkins内置步骤解析，从而报错。

正确实现方案 #

1. 全局设置环境变量env.VERSION

修改Prepare & Checkout阶段的代码，直接操作env.VERSION，确保变量全局可用：

stage('Prepare & Checkout') {
  steps {
    script {
      // 优先使用传入的VERSION参数，为空则用git describe生成版本号
      env.VERSION = params.VERSION ?: sh(script: "git describe", returnStdout: true).trim()
      echo "** version: ${env.VERSION} **"
    }
  }
}

这里用Groovy的?:（Elvis操作符）简化了if-else判断，逻辑和你原本的需求完全一致：如果params.VERSION非空就用它，否则执行git describe并赋值给env.VERSION。

2. 让构建脚本读取VERSION

当你把变量设置到env对象后，Jenkins会自动将其导出到shell执行环境中，所以你的build.sh脚本可以直接通过$VERSION读取这个值，比如在脚本里写：

echo "Building version: $VERSION"
# 其他构建逻辑...

3. 在后续stage和邮件通知中使用VERSION

所有后续的stage、post块都可以直接通过${env.VERSION}引用这个全局变量：

stage('Build') {
  steps {
    sh "./build.sh"
    echo "** version2: ${env.VERSION} **"
  }
}

post {
  always {
    mail to: 'foo@example.com', 
         subject: "SUCCESS: ${env.VERSION}", 
         body: """<html><body><p>SUCCESS - Build Version: ${env.VERSION}</p></body></html>""", 
         mimeType: 'text/html', 
         charset: 'UTF-8'
    deleteDir()
  }
}

4. 移除多余的environment块

你之前添加的environment { def VERSION = "${params.VERSION}" }是多余的，而且写法不符合声明式流水线规范（environment块里不需要用def声明变量），直接删除即可。

完整可运行流水线代码 #

pipeline {
  agent any
  parameters {
    string(name: 'VERSION', defaultValue: '')
  }
  stages {
    stage('Prepare & Checkout') {
      steps {
        // 先执行代码checkout，确保git describe能正常运行
        checkout scm
        script {
          env.VERSION = params.VERSION ?: sh(script: "git describe", returnStdout: true).trim()
          echo "** version: ${env.VERSION} **"
        }
      }
    }
    stage('Build') {
      steps {
        sh "./build.sh"
        echo "** version2: ${env.VERSION} **"
      }
    }
  }
  post {
    always {
      mail to: 'foo@example.com', 
           subject: "SUCCESS: ${env.VERSION}", 
           body: """<html><body><p>SUCCESS - Build Version: ${env.VERSION}</p></body></html>""", 
           mimeType: 'text/html', 
           charset: 'UTF-8'
      deleteDir()
    }
  }
}

注意：我在Prepare & Checkout阶段添加了checkout scm步骤，确保代码已经拉取到工作目录，这样git describe才能正常执行（如果你的流水线已经有checkout逻辑，可以忽略这一步）。

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