如何通过编程将Jenkins中用credentials X的Git克隆任务改为credentials Y？

这种批量修改Jenkins任务的需求，完全不用手动一个个改到崩溃——我之前刚帮团队处理过类似的凭证替换操作，用Jenkins自带的Groovy脚本就能高效搞定，下面给你具体的实现步骤和注意事项：

方法一：用Jenkins脚本控制台快速执行（推荐） #

这是最直接的方式，不用额外工具，在Jenkins内部就能完成：

1. 登录你的Jenkins实例，进入「Manage Jenkins」→「Script Console」
2. 复制下面的Groovy脚本，替换其中的OLD_CRED_ID（你的credentials X的ID）和NEW_CRED_ID（credentials Y的ID），然后点击「Run」执行：

import jenkins.model.Jenkins
import hudson.plugins.git.GitSCM
import hudson.plugins.git.UserRemoteConfig

// 替换为实际的旧凭证ID和新凭证ID
def oldCredentialId = "OLD_CRED_ID"
def newCredentialId = "NEW_CRED_ID"

// 遍历所有Jenkins任务
Jenkins.instance.getAllItems(hudson.model.Job).each { job ->
    def scm = job.getScm()
    // 只处理使用GitSCM的任务
    if (scm instanceof GitSCM) {
        def remoteConfigs = scm.getUserRemoteConfigs()
        def isUpdated = false
        
        remoteConfigs.each { remote ->
            // 检查当前远程仓库使用的凭证是否为目标旧凭证
            if (remote.getCredentialsId() == oldCredentialId) {
                remote.setCredentialsId(newCredentialId)
                isUpdated = true
                println "已更新任务: ${job.fullName} - 凭证ID从 ${oldCredentialId} 替换为 ${newCredentialId}"
            }
        }
        
        // 如果任务有修改，保存配置
        if (isUpdated) {
            job.save()
        }
    }
}

println "批量替换操作完成！"

3. 执行后，控制台会输出所有被修改的任务名称，你可以核对确认是否符合预期。

方法二：独立Groovy脚本（适合自动化场景） #

如果需要把这个操作集成到自动化流水线或者外部脚本中，可以基于Jenkins API编写独立Groovy脚本，核心逻辑和上面一致，只是需要添加Jenkins实例的认证信息（比如API Token）来访问 Jenkins。

重要注意事项 #

• 先备份！ 执行脚本前一定要备份Jenkins的JENKINS_HOME目录，避免脚本异常导致配置丢失
• 脚本会自动遍历所有层级的任务（包括文件夹下的子任务），不用额外处理嵌套结构
• 如果你的任务使用了「多SCM」插件，需要修改脚本逻辑，遍历任务的所有SCM配置而不是只取第一个
• 执行脚本的账号需要拥有「Run Scripts」和「Configure Jobs」的权限，否则会报错

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