如何批量为所有Jenkins任务添加相同的作业参数

方案1：使用Jenkins脚本控制台（推荐，无服务中断） #

适用场景：无需重启Jenkins，支持按文件夹、任务类型灵活筛选修改范围，可提前预览待修改任务列表，风险可控。
注意：操作前建议先备份Jenkins主目录，先开启dry run模式验证逻辑正确性，测试环境验证通过后再在生产环境执行
操作步骤：

1. 进入Jenkins首页 -> 系统管理 -> 脚本控制台
2. 粘贴下方Groovy脚本，按你的需求修改配置项后运行

// 配置项：定义需要添加的两个参数，可根据需求调整参数类型、名称、默认值、描述
def targetParams = [
  // 示例：字符串类型参数
  new hudson.model.StringParameterDefinition(
    "CUSTOM_PARAM1", 
    "default_value_1", 
    "第一个批量添加的自定义参数"
  ),
  // 示例：布尔类型参数，可替换为ChoiceParameterDefinition等其他参数类型
  new hudson.model.BooleanParameterDefinition(
    "CUSTOM_PARAM2", 
    false, 
    "第二个批量添加的自定义参数"
  )
]
// 配置项：指定要处理的文件夹路径，留空则处理所有Jenkins任务
def targetFolder = "your_target_folder"
// 配置项：dryRun为true时仅打印待修改任务，不实际保存配置
def dryRun = true

// 任务遍历逻辑
Jenkins.instance.getAllItems(Job.class).each { job ->
  // 文件夹过滤
  if (targetFolder && !job.fullName.startsWith(targetFolder + "/")) {
    return
  }
  def paramProp = job.getProperty(hudson.model.ParametersDefinitionProperty.class)
  def existingParams = paramProp ? paramProp.getParameterDefinitions() : []
  def paramsToAdd = []
  
  targetParams.each { newParam ->
    // 跳过已存在的同名参数
    if (!existingParams.any { it.name == newParam.name }) {
      paramsToAdd << newParam
    }
  }
  
  if (paramsToAdd) {
    println "待处理任务：${job.fullName}，待添加参数：${paramsToAdd*.name.join(',')}"
    if (!dryRun) {
      def newParamList = existingParams + paramsToAdd
      if (paramProp) {
        job.removeProperty(paramProp)
      }
      job.addProperty(new hudson.model.ParametersDefinitionProperty(newParamList))
      job.save()
      println "已完成任务 ${job.fullName} 的参数添加"
    }
  }
}

3. 确认dry run输出的待修改任务符合预期后，将dryRun改为false再次运行即可完成批量添加。

方案2：批量修改config.xml文件（适合可短暂停机的场景） #

适用场景：你已经验证过单任务config.xml修改逻辑，适合全量大批量修改的场景。
操作步骤：

• 停止Jenkins服务，避免运行时配置覆盖你修改的内容
• 完整备份$JENKINS_HOME/jobs目录
• 优先使用xmlstarlet工具修改（比sed更稳妥，不会破坏XML格式），示例命令如下（需先根据你的参数调整XML片段内容）：

# 遍历所有任务的config.xml，批量添加参数
find $JENKINS_HOME/jobs -name "config.xml" | while read config_file; do
  # 检查是否已有参数定义节点
  has_param_prop=$(xmlstarlet sel -q -t -c "/*/properties/hudson.model.ParametersDefinitionProperty" "$config_file" >/dev/null 2>&1 && echo "yes" || echo "no")
  if [ "$has_param_prop" = "no" ]; then
    # 无参数定义节点时新增完整参数节点
    xmlstarlet ed --inplace \
      --subnode "/*/properties" --type elem -n hudson.model.ParametersDefinitionProperty -v "" \
      --subnode "/*/properties/hudson.model.ParametersDefinitionProperty" --type elem -n parameterDefinitions -v "" \
      --subnode "/*/properties/hudson.model.ParametersDefinitionProperty/parameterDefinitions" --type elem -n hudson.model.StringParameterDefinition -v "" \
      --subnode "/*/properties/hudson.model.ParametersDefinitionProperty/parameterDefinitions/hudson.model.StringParameterDefinition" --type elem -n name -v "CUSTOM_PARAM1" \
      --subnode "/*/properties/hudson.model.ParametersDefinitionProperty/parameterDefinitions/hudson.model.StringParameterDefinition" --type elem -n defaultValue -v "default_value_1" \
      --subnode "/*/properties/hudson.model.ParametersDefinitionProperty/parameterDefinitions/hudson.model.StringParameterDefinition" --type elem -n description -v "第一个批量添加的参数" \
      --subnode "/*/properties/hudson.model.ParametersDefinitionProperty/parameterDefinitions" --type elem -n hudson.model.BooleanParameterDefinition -v "" \
      --subnode "/*/properties/hudson.model.ParametersDefinitionProperty/parameterDefinitions/hudson.model.BooleanParameterDefinition" --type elem -n name -v "CUSTOM_PARAM2" \
      --subnode "/*/properties/hudson.model.ParametersDefinitionProperty/parameterDefinitions/hudson.model.BooleanParameterDefinition" --type elem -n defaultValue -v "false" \
      --subnode "/*/properties/hudson.model.ParametersDefinitionProperty/parameterDefinitions/hudson.model.BooleanParameterDefinition" --type elem -n description -v "第二个批量添加的参数" \
      "$config_file"
  else
    # 已有参数定义节点时仅追加新参数
    xmlstarlet ed --inplace \
      --subnode "/*/properties/hudson.model.ParametersDefinitionProperty/parameterDefinitions" --type elem -n hudson.model.StringParameterDefinition -v "" \
      --subnode "/*/properties/hudson.model.ParametersDefinitionProperty/parameterDefinitions/hudson.model.StringParameterDefinition[last()]" --type elem -n name -v "CUSTOM_PARAM1" \
      --subnode "/*/properties/hudson.model.ParametersDefinitionProperty/parameterDefinitions/hudson.model.StringParameterDefinition[last()]" --type elem -n defaultValue -v "default_value_1" \
      --subnode "/*/properties/hudson.model.ParametersDefinitionProperty/parameterDefinitions/hudson.model.StringParameterDefinition[last()]" --type elem -n description -v "第一个批量添加的参数" \
      --subnode "/*/properties/hudson.model.ParametersDefinitionProperty/parameterDefinitions" --type elem -n hudson.model.BooleanParameterDefinition -v "" \
      --subnode "/*/properties/hudson.model.ParametersDefinitionProperty/parameterDefinitions/hudson.model.BooleanParameterDefinition[last()]" --type elem -n name -v "CUSTOM_PARAM2" \
      --subnode "/*/properties/hudson.model.ParametersDefinitionProperty/parameterDefinitions/hudson.model.BooleanParameterDefinition[last()]" --type elem -n defaultValue -v "false" \
      --subnode "/*/properties/hudson.model.ParametersDefinitionProperty/parameterDefinitions/hudson.model.BooleanParameterDefinition[last()]" --type elem -n description -v "第二个批量添加的参数" \
      "$config_file"
  fi
done

• 修改完成后启动Jenkins，随机抽查任务配置确认参数添加正确。

方案3：Configuration Slicing插件无代码方案 #

你提到的Configuration Slicing插件支持批量新增参数，操作逻辑如下：

1. 任选一个现有任务，手动添加你需要的两个目标参数并保存
2. 进入Jenkins首页 -> 系统管理 -> Configuration Slicing -> 选择「参数定义」切片
3. 筛选你需要批量修改的任务，勾选所有目标任务后，将两个新参数同步到选中任务中即可，无需编写代码。

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