You need to enable JavaScript to run this app. 如何为我拥有权限的所有Jenkin任务统一添加timeout参数?
优惠活动
大模型
产品
解决方案
定价
更多

如何为我拥有权限的所有Jenkin任务统一添加timeout参数?

可行实现方案

以下是两种可直接落地的操作方案:

方案1:Jenkins脚本控制台批量修改(优先推荐)

该方法无需额外工具,直接在Jenkins页面端执行Groovy脚本即可完成批量操作,前提是你拥有脚本控制台访问权限,且对目标任务有配置修改权限。
你可以直接在脚本控制台运行如下代码:

// 遍历所有可访问任务
Jenkins.instance.getAllItems(Job.class).each { job ->
  // 跳过无修改权限的任务
  if(!job.hasPermission(Item.CONFIGURE)) return
  
  // 处理参数化配置
  def paramsDef = job.getProperty(ParametersDefinitionProperty.class)
  if(!paramsDef) {
    // 任务未开启参数化则先初始化参数配置
    paramsDef = new ParametersDefinitionProperty([])
    job.addProperty(paramsDef)
  }
  
  // 检查是否已存在同名timeout参数,避免覆盖原有配置
  def existingParam = paramsDef.getParameterDefinitions().find { it.name == 'timeout' }
  if(existingParam) return
  
  // 添加timeout参数,可按需调整参数类型、默认值、描述信息
  def timeoutParam = new StringParameterDefinition('timeout', '3600', '构建超时时间,单位为秒')
  paramsDef.getParameterDefinitions().add(timeoutParam)
  
  // 保存任务配置
  job.save()
}
  • 可根据需求调整参数的类型、默认值、描述字段
  • 执行前建议先注释掉job.save()行,先打印待修改的任务列表确认范围,没问题后再执行保存逻辑

方案2:Jenkins CLI 批量操作

如果你没有脚本控制台权限,可以用Jenkins官方CLI工具完成操作:

  • 首先从你的Jenkins服务根路径/jnlpJars/jenkins-cli.jar下载对应版本的CLI jar包
  • 准备好你的Jenkins账号用户名和对应API Token
  • 第一步拉取所有你有权限的任务列表:
    java -jar jenkins-cli.jar -s <你的Jenkins服务地址> -auth <你的用户名>:<你的API Token> list-jobs > job-list.txt
  • 遍历job-list.txt中的每一个任务名称,执行如下操作:
    1. 拉取任务现有配置:java -jar jenkins-cli.jar -s <你的Jenkins服务地址> -auth <你的用户名>:<你的API Token> get-job <任务名> > config.xml
    2. 编辑config.xml,在参数定义段添加timeout参数的XML配置
    3. 推送修改后的配置回Jenkins:java -jar jenkins-cli.jar -s <你的Jenkins服务地址> -auth <你的用户名>:<你的API Token> update-job <任务名> < config.xml

注意事项

  • 全量操作前务必先选1-2个非核心测试任务验证操作逻辑,确认参数添加符合预期后再全量执行
  • 若任务是流水线类型且参数定义在代码库的Jenkinsfile中,上述两种方法不适用,需要直接修改对应Jenkinsfile的参数配置
  • 建议执行前备份所有任务的配置,避免误操作导致配置丢失

内容的提问来源于stack exchange,提问作者Hema Prasanthi

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.19 03:45:07