Jenkins中使用TF_VAR_传递Terraform变量失败，求排查

你遇到的问题核心是Jenkins的每个sh步骤都是独立的Shell进程，进程之间的环境变量不共享。你之前单独用sh 'export TF_VAR_xxx=xxx'设置的环境变量，只在当前那一个Shell进程里有效，后面执行terraform init、terraform apply的sh步骤是全新的进程，根本拿不到这些变量，所以Terraform会提示缺少必填变量。

有三种可行的修改方式，任选其一即可：

方式1：将所有相关命令放在同一个sh块中 #

把环境变量导出和Terraform命令放在同一个Shell会话里，这样变量能持续生效：

withCredentials([usernamePassword(credentialsId: 'containerregistryCreds', passwordVariable: 'AZURE_CLIENT_SECRET', usernameVariable: 'AZURE_CLIENT_ID')]) {
    sh '''
        export TF_VAR_clientid=$AZURE_CLIENT_ID
        export TF_VAR_clientsecret=$AZURE_CLIENT_SECRET
        export TF_VAR_subscriptionid=$AZURE_SUBSCRIPTION_ID
        export TF_VAR_tenantid=$AZURE_TENANT_ID
        
        terraform init
        terraform fmt
        terraform validate
        terraform apply -auto-approve -no-color
        terraform show
        terraform state list
    '''
}

注意这里用三个单引号'''包裹多行Shell命令，保证所有命令在同一个进程中执行。

方式2：通过Jenkins的environment块定义TF_VAR变量 #

直接在withCredentials内部或者pipeline的environment里定义TF_VAR开头的环境变量，Jenkins会自动把这些变量注入到后续的所有sh步骤中：

withCredentials([usernamePassword(credentialsId: 'containerregistryCreds', passwordVariable: 'AZURE_CLIENT_SECRET', usernameVariable: 'AZURE_CLIENT_ID')]) {
    environment {
        TF_VAR_clientid = "$AZURE_CLIENT_ID"
        TF_VAR_clientsecret = "$AZURE_CLIENT_SECRET"
        TF_VAR_subscriptionid = "$AZURE_SUBSCRIPTION_ID"
        TF_VAR_tenantid = "$AZURE_TENANT_ID"
    }
    steps {
        sh 'terraform init'
        sh 'terraform fmt'
        sh 'terraform validate'
        sh 'terraform apply -auto-approve -no-color'
        sh 'terraform show'
        sh 'terraform state list'
    }
}

这种方式更符合Jenkins声明式流水线的风格，变量管理更清晰。

方式3：用withEnv包裹Terraform步骤 #

通过withEnv直接设置环境变量列表，作用范围仅限包裹的步骤：

withCredentials([usernamePassword(credentialsId: 'containerregistryCreds', passwordVariable: 'AZURE_CLIENT_SECRET', usernameVariable: 'AZURE_CLIENT_ID')]) {
    withEnv([
        "TF_VAR_clientid=${AZURE_CLIENT_ID}",
        "TF_VAR_clientsecret=${AZURE_CLIENT_SECRET}",
        "TF_VAR_subscriptionid=${AZURE_SUBSCRIPTION_ID}",
        "TF_VAR_tenantid=${AZURE_TENANT_ID}"
    ]) {
        sh 'terraform init'
        sh 'terraform fmt'
        sh 'terraform validate'
        sh 'terraform apply -auto-approve -no-color'
        sh 'terraform show'
        sh 'terraform state list'
    }
}

这三种方式都能让Terraform正确读取到TF_VAR_前缀的环境变量，和你用-var参数传递的效果完全一致。你可以根据自己的流水线风格选择合适的方式。

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