如何在Jenkins声明式流水线的parameters与options块中实现环境差异化配置？

针对声明式流水线里parameters{}和options{}块的条件化调整，这里提供两种场景的具体实现方案：

一、动态增减流水线参数（parameters） #

声明式流水线的parameters块本身不支持直接的条件判断，但可以通过运行时动态设置properties结合全局环境变量实现参数的增减，或者用共享库封装逻辑提升复用性。

方案1：直接在流水线中动态生成参数 #

pipeline {
  agent any
  stages {
    // 初始化阶段优先设置参数
    stage('Init') {
      steps {
        script {
          def pipelineParams = []
          
          // 添加所有环境通用的参数
          pipelineParams.add(
            string(name: 'APP_VERSION', defaultValue: '1.0.0', description: '待部署版本号')
          )
          
          // 根据全局环境变量ENVIRONMENT添加差异化参数
          if (env.ENVIRONMENT == 'ISOLATED') {
            // 隔离环境专属参数
            pipelineParams.add(
              booleanParam(name: 'SKIP_QA_CHECK', defaultValue: true, description: '是否跳过QA校验（隔离环境专属）')
            )
          } else {
            // 主环境专属参数
            pipelineParams.add(
              choice(name: 'DEPLOY_ENV', choices: ['prod', 'preprod'], description: '主环境部署目标')
            )
          }
          
          // 将参数应用到流水线
          properties([parameters(pipelineParams)])
        }
      }
    }
    
    // 后续业务阶段可以直接使用参数
    stage('Deploy') {
      steps {
        echo "当前环境: ${env.ENVIRONMENT}"
        echo "通用参数: ${params.APP_VERSION}"
        if (env.ENVIRONMENT == 'ISOLATED') {
          echo "隔离环境参数: SKIP_QA_CHECK = ${params.SKIP_QA_CHECK}"
        } else {
          echo "主环境参数: DEPLOY_ENV = ${params.DEPLOY_ENV}"
        }
      }
    }
  }
}

方案2：用共享库封装参数生成逻辑（推荐） #

如果多个流水线都需要这套差异化逻辑，可将参数生成逻辑放到共享库的vars目录下：

// vars/getEnvironmentParams.groovy
def call() {
  def params = [
    string(name: 'APP_VERSION', defaultValue: '1.0.0', description: '待部署版本号')
  ]
  
  if (env.ENVIRONMENT == 'ISOLATED') {
    params << booleanParam(name: 'SKIP_QA_CHECK', defaultValue: true, description: '是否跳过QA校验（隔离环境专属）')
  } else {
    params << choice(name: 'DEPLOY_ENV', choices: ['prod', 'preprod'], description: '主环境部署目标')
  }
  
  return params
}

然后在流水线中调用：

pipeline {
  agent any
  stages {
    stage('Init') {
      steps {
        script {
          properties([parameters(getEnvironmentParams())])
        }
      }
    }
    // 后续阶段正常使用参数即可
  }
}

注意：这种方式下，流水线首次运行时参数不会显示（因为参数是运行时设置的），首次运行后参数才会出现在流水线启动页面。如果需要首次运行就显示参数，可结合Jenkins全局变量提前配置，或使用共享库的动态参数插件扩展（不过一般首次运行后就能正常显示，不影响后续使用）。

二、动态调整流水线选项（options） #

声明式的options块同样不支持直接条件判断，但可以通过configure步骤修改底层XML配置实现，这种方式能让选项在流水线初始化时就生效，直接显示在流水线页面。

示例：根据环境设置不同的构建保留策略和通用选项 #

pipeline {
  agent any
  
  // 使用configure步骤动态生成选项
  configure { node ->
    // 添加所有环境通用的选项
    node / 'options' << 'timeout' {
      'time'('30')
      'unit'('MINUTES')
    }
    
    // 根据环境添加差异化选项
    if (env.ENVIRONMENT == 'ISOLATED') {
      // 隔离环境：仅保留最近5次构建
      node / 'options' << 'buildDiscarder' {
        'logRotator' {
          'numToKeepStr'('5')
        }
      }
    } else {
      // 主环境：保留最近100次构建，开启时间戳日志
      node / 'options' << 'buildDiscarder' {
        'logRotator' {
          'numToKeepStr'('100')
        }
      }
      node / 'options' << 'timestamps'()
    }
  }
  
  stages {
    stage('Build') {
      steps {
        echo "构建中...当前环境: ${env.ENVIRONMENT}"
      }
    }
  }
}

另一种方式：用共享库封装选项逻辑 #

如果需要复用选项逻辑，同样可以用共享库的vars封装：

// vars/getEnvironmentOptions.groovy
def call() {
  def options = []
  options.add(timeout(time: 30, unit: 'MINUTES'))
  
  if (env.ENVIRONMENT == 'ISOLATED') {
    options.add(buildDiscarder(logRotator(numToKeepStr: '5')))
  } else {
    options.add(buildDiscarder(logRotator(numToKeepStr: '100')))
    options.add(timestamps())
  }
  
  return options
}

然后在流水线中通过script块调用（注意声明式options中直接调用函数需要用script包裹）：

pipeline {
  agent any
  options {
    script { getEnvironmentOptions() }
  }
  stages {
    // ...
  }
}

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