如何通过GIT/Bitbucket实现无需本地检出的远程字符串批量替换

官方原生API支持 #

Bitbucket Server 5.10及以上版本官方提供了无需本地检出仓库的文件修改API，可直接在服务端完成文件修改、提交操作：

• 单次调用GET /rest/api/1.0/projects/{projectKey}/repos/{repositorySlug}/browse/{filePath}?at={branchName}接口，即可拉取指定分支指定文件的当前内容，不需要拉取整个仓库代码。
• 对拉取到的内容在内存中完成指定URL替换后，调用PUT /rest/api/1.0/projects/{projectKey}/repos/{repositorySlug}/browse/{filePath}接口，传入替换后的内容、提交信息、目标分支名，服务端会直接生成对应提交，全程不需要本地克隆、检出任何分支，完全跳过本地拉取推送的网络和IO开销。

批量操作流程 #

• 调用分支列表API拉取目标仓库所有需要修改的分支，单次请求即可获取全部分支列表
• 逐分支拉取目标配置文件的内容，在内存中执行规则替换
• 提交替换后的内容到对应分支，完成修改

你可以通过多线程并行处理不同仓库、不同分支的请求，相比本地逐分支checkout修改推送的方案，整体耗时可降低90%以上，完全适配分支数量极大的场景。

服务端内置工具方案 #

如果你的Bitbucket Server实例安装了ScriptRunner插件，可直接在服务端运行Groovy脚本完成全流程操作，连本地调用API的步骤都可以省略：

• 脚本可直接遍历所有目标项目、仓库、分支
• 内置的API可以直接读取文件内容、执行替换、生成提交，所有操作都在服务端本地执行，效率更高

注意事项 #

• 批量操作前建议先在测试仓库的单个分支验证替换规则、提交权限，避免批量误操作
• 调用官方API时注意适配服务端的限流阈值，合理设置并发数，避免触发限流

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