公司內部原本使用 SVN 進行版本控制,但隨着 Github 的流行我個人的代碼管理習慣逐漸轉變。雖然公司項目並非開源,SVN 所具有的標准 trunk / branches / tags 結構完全夠用,使用 Git 仍然有如下優勢:
- 類似 GitHub 的 GitLab 免費管理工具。將代碼托管在自己內部服務器上的同時,提供了優美的 web 界面,圖形化分支結構,更直觀的代碼審查,統計、issue 系統、wiki 等功能全面集成。
- 更方便主程做 code review,控制代碼質量。創建主倉庫,多人開發時使用 fork 模式,每個人擁有自己獨立的 repo,獨立的 trunk / branches,最后發送 pull request 進行代碼合並。
- commit 和 push 更快。體現在 push 到遠程倉庫時 Git 會先對所有需要上傳的文件進行 zip 打包壓縮,然后一次性傳輸,在遠程服務器解壓,全部自動完成。而 SVN 則是一個一個文件地上傳,代碼是純文本,總體積並不大,但是大量零碎的小文件頻繁建立網絡連接造成延遲。這在升級第三方的庫或者框架時,成千上萬的文件更新更加讓人難以忍受。
- hook 可以更方便做自動化部署。當然這個 SVN 也有。
權衡后我決定花時間進行代碼倉庫的遷移。代碼遷移並非簡單地創建 Git repo 把當前項目代碼一次性 commit 過去就夠了,因為 SVN 中存有長年累月的 commit 歷史記錄,丟失歷史記錄將對今后追溯 debug 造成非常大的麻煩,所以如何保留 commit 記錄就是遷移的關鍵。
一、遷移步驟
創建用戶映射 (例如 users.txt
) ,將 SVN 用戶和 Git 用戶對應起來:
user1 = First Last Name <email@address.com> user2 = First Last Name <email@address.com> …
如果上面的文件中有用戶缺失,后面的 SVN 命令將會停止。不過你可以更新用戶映射然后接着再來(類似斷點續傳)。
現在從 SVN 倉庫中拉取所有數據:
git svn clone --stdlayout --no-metadata -A users.txt svn://hostname/path dest_dir-tmp |
這個命令將會在 dest_dir-tmp
新建一個 Git repo,並開始從 SVN 中拉取代碼。請注意 “--stdlayout
” 參數表示你的項目在 SVN 中是常見的 “trunk/branches/tags
” 目錄結構,如果不是,那你需要使用 --tags
, --branches
, --trunk
參數(請通過 git svn help
自行了解)。
再后面的參數是 SVN 的地址,一些常見協議都是支持的 : svn://
, http://
, https://
. 注意這個 URL 應該指向項目的 base repository,例如 http://svn.mycompany.com/myrepo/repository
. 不要指到了 /trunk
, /tag
或 /branches
里。
如果出現用戶名沒找到,更新你的 users.txt
文件,然后
cd dest_dir-tmp
git svn fetch |
如果你的項目非常大,你可能需要重復上面的命令好幾次,直到所有的 SVN commit 都被抓下來了:
git svn fetch |
完成后,Git 將會 checkout SVN 的 trunk 到一個新的 Git branch,而其他的 SVN branch 將會設為 Git remote,你可以查看所有的 SVN branch:
git branch -r |
如果你想在你的 Git repo 中保留其他的 remote branch,你需要手動創建本地 branch。否則,SVN 的 branch 將不會在最后被 clone。
git checkout -b local_branch remote_branch # it's ok if local_branch and remote_branch are the same name |
SVN tags 被當作 branch 導入了,你需要創建本地 branch,打一個 tag,然后刪掉那個 branch,這樣才會在 Git 中生成 tag。例如 SVN tag “v1″:
git checkout -b tag_v1 remotes/tags/v1 git checkout master git tag v1 tag_v1 git branch -D tag_v1 |
把上面的 GIT-SVN repo Clone 到一個全新的干凈 git repo:
git clone dest_dir-tmp dest_dir
rm -rf dest_dir-tmp cd dest_dir |
之前從 remote branch 創建的本地 branch 又會在新 clone 的 repo 中成為 remote branch,於是對每個 branch 再做一次:
git checkout -b local_branch origin/remote_branch |
最后,從干凈的 Git repo 中刪掉 remote (指向我們剛剛已經刪掉的 temp repo)
git remote rm origin |
這樣一個全新 Git repo 就已經從 SVN 遷移好了。
二、新的 Git 遠程倉庫
將本地的 Git repo push 到遠程倉庫(我這里用的是 GitLab):
git remote add origin git@git.udev.hk:udba/udba.git git push -u origin master |
push 所有的 branch:
git push origin --all |
push 所有的 tag:
git push origin --tags |
最后再放兩張 GitLab 的截圖
– EOF –
http://www.lovelucy.info/codebase-from-svn-to-git-migration-keep-commit-history.html