【git】git-transfer一行搞定仓库迁移

文章目录

• • 介绍
  • 使用场景
  • 可用命令
  • • 单个迁移示例
    • 批量迁移
    • 自动创建gitea组织和仓库
  • 执行步骤
  • 新增特性
  • 支持的地址格式
  • 获取

介绍

这是一个go语言编写的命令行git迁移工具：git-transfer。
特点：

• 快速迁移，保留完整branch和commits记录
• 本地到远程批量迁移， 默认迁移本地分支。
• 远程到远程批量迁移，默认迁移所有分支，并且本地clone备份。
  

使用场景

git仓库地址发生变化，origin地址需要换成新的，支持单个仓库迁移和批量迁移两种模式。

可用命令

• git-transfer <新地址>- 单个仓库迁移，在项目目录下执行
• git-transfer --yaml [配置文件]- 批量迁移（默认: transfer.yaml），任意路径执行
• git-transfer --help- 显示帮助信息

单个迁移示例

git-transfer https://github.com/user/repo.git git-transfer [e-mail]:user/repo.git

批量迁移

创建transfer.yaml配置文件：

projects:-name:"项目1"path:"./project1"old_origin:"https://old-server.com/user/project1.git"# 从old-origin克隆到本地path，然后推送new-originnew_origin:"https://github.com/user/project1.git"-name:"项目2"path:"./project2"new_origin:"https://github.com/user/project2.git"# 只写new_origin，从本地直接推送所有分支到new_origin

自动创建gitea组织和仓库

git-transfer --make-repo gitea --yaml z_hedong.yaml --username admin --password123456

然后执行批量迁移：

git-transfer --yaml my-config.yaml

执行步骤

1. 环境检查

   • 检测本地是否安装git，无则输出"请配置git程序"
   • 检查当前目录是否为git仓库，无则输出"当前目录不是git仓库"
   • 验证新地址格式是否正确

2. 备份当前配置

   • 获取并保存当前origin地址（用于出错时回滚）
   • 输出当前origin地址信息

3. 更新远程地址

   • git remote remove origin- 删除现有的origin
   • git remote add origin 新地址- 添加新的origin地址
   • 验证新地址是否添加成功

4. 推送代码

   • 先尝试git push --all推送所有分支
   • 如果推送失败，询问用户是否确认使用git push -f --all强制推送
   • 推送成功后输出确认信息

5. 错误处理

   • 任何步骤失败时，尝试恢复原origin地址
   • 输出详细的错误信息和建议

新增特性

• ✅命令行帮助---help显示所有可用命令和使用说明
• ✅批量迁移---yaml支持从配置文件批量迁移多个项目
• ✅实时进度条- 批量迁移时显示绿色进度条（第几个项目/总数）
• ✅跨平台兼容- 兼容 cmd/powershell/bash/sh/zsh 等终端
• ✅彩色输出- 使用颜色区分不同类型的信息
• ✅详细日志- 每一步都有详细的日志输出
• ✅安全回滚- 支持出错时自动回滚到原地址

支持的地址格式

• http://github.com/user/repo.git
• https://github.com/user/repo.git
• [e-mail]:user/repo.git
• ssh://[e-mail]/user/repo.git

获取