Jenkins矩阵作业中如何读取含轴值的嵌套变量凭据？

可以实现，核心思路是通过字符串拼接生成对应凭据ID，再结合Jenkins的withCredentials安全读取凭据。以下是具体实现方案：

实现步骤 #

假设你的矩阵轴DEPLOY_LOCATIONS取值为X、Y、Z，对应凭据ID为TEST_X_TOKEN、TEST_Y_TOKEN、TEST_Z_TOKEN，可在Pipeline中这么写：

pipeline {
    agent any
    matrix {
        axes {
            axis {
                name 'DEPLOY_LOCATIONS'
                values 'X', 'Y', 'Z'
            }
        }
        stages {
            stage('执行部署') {
                steps {
                    script {
                        // 动态拼接当前矩阵轴对应的凭据ID
                        def targetCredentialId = "TEST_${DEPLOY_LOCATIONS}_TOKEN"
                        
                        // 安全读取凭据，避免明文泄露
                        withCredentials([string(credentialsId: targetCredentialId, variable: 'DEPLOY_TOKEN')]) {
                            echo "当前部署位置: ${DEPLOY_LOCATIONS}"
                            echo "读取到的令牌已存入变量: DEPLOY_TOKEN"
                            
                            // 在这里编写你的部署逻辑，直接使用DEPLOY_TOKEN变量即可
                            // 例如: sh "deploy-script --token ${DEPLOY_TOKEN} --location ${DEPLOY_LOCATIONS}"
                        }
                    }
                }
            }
        }
    }
}

关键说明 #

• 动态凭据ID生成：通过Groovy字符串插值"TEST_${DEPLOY_LOCATIONS}_TOKEN"，自动匹配当前矩阵步骤的轴值，生成对应的凭据ID。
• 安全读取凭据：必须使用withCredentials步骤，它会将凭据值注入到指定变量中，且不会在日志中泄露明文。
• 凭据类型适配：如果你的凭据是其他类型（如用户名密码），只需修改withCredentials内的类型，例如：

  withCredentials([usernamePassword(credentialsId: targetCredentialId, usernameVariable: 'USER', passwordVariable: 'PASS')]) {
      // 使用USER和PASS变量
  }
  

注意事项 #

• 确保所有目标凭据已在Jenkins凭据管理中创建，且ID与拼接后的字符串完全一致（大小写敏感）。
• 要给执行Pipeline的用户配置对应凭据的读取权限，否则会出现权限报错。
• 声明式Pipeline中，动态逻辑必须放在script块内执行。

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