Jenkins声明式管道如何遍历已勾选布尔参数按描述执行步骤

核心前提说明 #

流水线运行时的params作用域只会暴露参数名和用户选择的实际值，无法直接读取参数定义阶段填写的description属性，因此不能直接依赖description做逻辑判断，需要显式维护参数和对应属性的映射关系。 #

方案1：兼容现有布尔参数配置（无需额外装插件） #

1.1 修正原有参数定义的语法问题 #

原参数块存在语法缺失（第二个booleanParam未闭合），同时不建议直接把URL作为参数名，调整为语义化参数名，URL和环境属性放到映射表维护：

parameters {
  booleanParam(defaultValue: false, name: 'SELECT_TEST1', description: '非生产环境1' )
  booleanParam(defaultValue: false, name: 'SELECT_TEST2', description: '非生产环境2')
  booleanParam(defaultValue: false, name: 'SELECT_TEST3', description: '生产环境')
  string(name: 'user', defaultValue: '', description: '操作用户')
}

1.2 定义参数映射表 #

在流水线脚本段建立参数名、对应URL、环境类型的绑定关系，替代从description读取属性的逻辑：

// 可放在pipeline顶层script块，或对应执行stage内
def targetConfig = [
  SELECT_TEST1: [url: 'https://test1.com', envTag: 'Non-Prod'],
  SELECT_TEST2: [url: 'https://test2.com', envTag: 'Non-Prod'],
  SELECT_TEST3: [url: 'https://test3.com', envTag: 'Prod']
]

1.3 遍历勾选项+执行差异化逻辑 #

过滤出值为true的勾选参数，按环境标签走不同执行步骤：

stage('执行目标操作') {
  steps {
    script {
      // 过滤所有被用户勾选的目标
      def selectedTargets = targetConfig.findAll { paramKey, config ->
        params[paramKey] == true
      }

      // 空选择校验
      if (selectedTargets.isEmpty()) {
        error("未勾选任何操作目标，构建终止")
      }

      // 逐个处理选中的目标
      selectedTargets.each { paramKey, config ->
        echo "当前处理目标：${config.url}，环境类型：${config.envTag}，操作用户：${params.user}"
        
        // 按环境类型执行差异化步骤
        switch(config.envTag) {
          case 'Non-Prod':
            // 非生产环境逻辑：直接执行部署、测试等操作
            sh """
              echo "触发非生产环境操作，目标地址：${config.url}"
              # 此处填写实际curl、部署命令，可直接引用config.url
            """
            break
          case 'Prod':
            // 生产环境逻辑：增加人工审批、灰度规则等
            input message: "确认对生产地址${config.url}执行操作？", ok: "确认发布"
            sh """
              echo "触发生产环境操作，目标地址：${config.url}"
              # 此处填写生产专属执行命令
            """
            break
        }
      }
    }
  }
}

方案2：使用多选参数简化配置（需安装Extended Choice Parameter插件） #

如果后续需要管理的目标地址较多，逐个定义布尔参数维护成本高，可以用多选复选框参数替代多个独立布尔参数：

2.1 参数定义 #

parameters {
  extendedChoice(
    name: 'SELECTED_TARGETS',
    type: 'PT_CHECKBOX',
    description: '勾选需要操作的目标地址',
    value: 'https://test1.com,https://test2.com,https://test3.com',
    // 为每个选项绑定对应的环境标签
    descriptionPropertyValue: 'Non-Prod,Non-Prod,Prod',
    multiSelectDelimiter: ',',
    defaultValue: ''
  )
  string(name: 'user', defaultValue: '', description: '操作用户')
}

2.2 遍历逻辑 #

stage('执行目标操作') {
  steps {
    script {
      if (!params.SELECTED_TARGETS?.trim()) {
        error("未勾选任何操作目标，构建终止")
      }
      // 拆分选中的URL列表
      def selectedUrls = params.SELECTED_TARGETS.split(',')
      // 定义URL和环境标签的映射
      def urlEnvMapping = [
        'https://test1.com': 'Non-Prod',
        'https://test2.com': 'Non-Prod',
        'https://test3.com': 'Prod'
      ]

      selectedUrls.each { url ->
        def envTag = urlEnvMapping[url]
        echo "当前处理目标：${url}，环境类型：${envTag}，操作用户：${params.user}"
        // 此处差异化逻辑和方案1一致，按envTag分支处理即可
      }
    }
  }
}

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