將代碼庫從 SVN 遷移至 Git 並保留全部 commit 記錄

公司內部本來使用 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 記錄就是遷移的關鍵。

 

 

1、遷移步驟

建立用戶映射 （例如 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 遷移好了。

2、新的 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 –