Jenkinsfile中向Kubernetes添加环境变量的语法问题求助

嘿，这个错误我太熟悉了——你这是踩了Jenkins Kubernetes插件环境变量配置的语法坑！

报错信息说得很直白：containerTemplate的setEnvVars()方法需要的是java.util.List<org.csanchez.jenkins.plugins.kubernetes.model.TemplateEnvVar>类型的参数，但你传了字符串，所以直接触发了类型转换异常。

你大概率是像下面这样错误编写的（直接传字符串格式的环境变量）：

stage("build") {
    agent {
        kubernetes {
            label 'kubernetes'
            containerTemplate {
                name 'builder'
                image 'your-image:latest'
                // 错误写法：直接传字符串
                envVars 'MY_ENV=hello'
            }
        }
    }
}

正确的写法有两种，核心都是要构造插件要求的TemplateEnvVar对象：

方式1：逐个定义环境变量 #

用envVar方法单独声明每个环境变量，这是最常用的写法：

stage("build") {
    agent {
        kubernetes {
            label 'kubernetes'
            containerTemplate {
                name 'builder'
                image 'your-build-image:latest'
                // 正确：用envVar构造键值对
                envVar(key: 'MY_ENV_VAR', value: 'my-custom-value')
                envVar(key: 'BUILD_VERSION', value: '1.0.0')
            }
        }
    }
    steps {
        sh 'echo $MY_ENV_VAR' // 这里就能正确读取到环境变量了
    }
}

方式2：批量传入环境变量列表 #

如果有多个环境变量，也可以把它们放到列表里传给envVars：

stage("build") {
    agent {
        kubernetes {
            label 'kubernetes'
            containerTemplate {
                name 'builder'
                image 'your-build-image:latest'
                // 正确：传入TemplateEnvVar对象的列表
                envVars([
                    envVar(key: 'VAR1', value: 'val1'),
                    envVar(key: 'VAR2', value: 'val2'),
                    envVar(key: 'VAR3', value: 'val3')
                ])
            }
        }
    }
    steps {
        sh 'echo $VAR1 $VAR2 $VAR3'
    }
}

核心就是别直接传KEY=VALUE格式的字符串，必须用插件提供的envVar方法来构造符合要求的对象，这样就不会再报类型转换的错误啦！

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