如何在Jenkins Pipeline中实现可选凭据？

我来帮你搞定这个Jenkins Pipeline里可选凭据的问题！你遇到的核心问题是credentials()函数必须找到对应的有效凭据，不管是手动传入的还是默认值，一旦找不到就直接报错。下面给你两种实用的解决方案：

方案一：用字符串参数配合脚本逻辑动态处理 #

这种方法不需要预先创建额外凭据，灵活性更高：

1. 修改参数定义：把原来的credentials类型参数改成字符串类型，允许用户留空（默认值设为空字符串），让用户输入Jenkins中已有的凭据ID：

parameters {
  string(
    name: 'API_TOKEN_ID',
    description: '输入API令牌对应的Jenkins凭据ID（留空则不使用令牌）',
    defaultValue: ''
  )
}

2. 在环境变量中动态判断：用script块根据参数是否为空，决定是获取真实凭据还是设置默认值：

pipeline {
  agent any
  parameters {
    string(
      name: 'API_TOKEN_ID',
      description: '输入API令牌对应的Jenkins凭据ID（留空则不使用令牌）',
      defaultValue: ''
    )
  }
  environment {
    MY_TOKEN = script {
      params.API_TOKEN_ID ? credentials(params.API_TOKEN_ID) : 'dummy'
      // 如果不需要默认值，也可以设为空字符串：''
    }
  }
  stages {
    stage('Test') {
      steps {
        echo "当前使用的令牌：${MY_TOKEN}"
        // 后续逻辑可以根据MY_TOKEN是否为空来决定是否执行需要令牌的操作
      }
    }
  }
}

方案二：预先创建dummy凭据作为默认值 #

如果你更倾向于保留credentials类型的参数，可以提前在Jenkins中创建一个名为dummy-api-token的字符串凭据（值设为你需要的默认内容，比如'dummy'），然后修改参数的默认值为这个dummy凭据的ID：

1. 在Jenkins中创建dummy凭据：

   • 进入Jenkins的「凭据」页面，创建一个「字符串凭据」，ID设为dummy-api-token，值设为'dummy'。

2. 修改Pipeline参数：

parameters {
  credentials(
    name: 'API_TOKEN',
    description: 'API访问令牌（可选，默认使用dummy令牌）',
    defaultValue: 'dummy-api-token',
    credentialType: "org.jenkinsci.plugins.plaincredentials.impl.StringCredentialsImpl"
  )
}

3. 正常使用环境变量：

pipeline {
  agent any
  parameters {
    credentials(
      name: 'API_TOKEN',
      description: 'API访问令牌（可选，默认使用dummy令牌）',
      defaultValue: 'dummy-api-token',
      credentialType: "org.jenkinsci.plugins.plaincredentials.impl.StringCredentialsImpl"
    )
  }
  environment {
    MY_TOKEN = credentials('API_TOKEN')
  }
  stages {
    stage('Test') {
      steps {
        echo "当前使用的令牌：${MY_TOKEN}"
      }
    }
  }
}

两种方案里，方案一更灵活，不需要预先配置凭据；方案二更贴合你原来的参数定义习惯。你可以根据自己的需求选一个～

备注：内容来源于stack exchange，提问作者aerion