當(dāng)前位置：首頁(yè) > 编程资源 > 编程问答 >内容正文

编程问答

Git之深入解析如何将项目迁移到Git

發(fā)布時(shí)間：2024/5/21 编程问答 73 豆豆

生活随笔收集整理的這篇文章主要介紹了 Git之深入解析如何将项目迁移到Git 小編覺得挺不錯(cuò)的,現(xiàn)在分享給大家,幫大家做個(gè)參考.

一、前言

如果我們現(xiàn)在有一個(gè)正在使用其他 VCS 的代碼庫(kù)，但是已經(jīng)決定開始使用 Git，必須通過(guò)某種方式將項(xiàng)目遷移至 Git，那該怎么辦呢？
Git 有一些通用系統(tǒng)的導(dǎo)入器，也可以開發(fā)自己定制的導(dǎo)入器，這里將會(huì)學(xué)習(xí)如何從幾個(gè)大型專業(yè)應(yīng)用的 SCM 系統(tǒng)中導(dǎo)入數(shù)據(jù)，不僅因?yàn)樗鼈兪谴蠖鄶?shù)想要轉(zhuǎn)換的用戶正在使用的系統(tǒng)，也因?yàn)楂@取針對(duì)它們的高質(zhì)量工具很容易。

二、Subversion

如果了解了關(guān)于 git svn 的內(nèi)容，可以輕松地使用那些指令來(lái) git svn clone 一個(gè)倉(cāng)庫(kù)，停止使用 Subversion 服務(wù)器，推送到一個(gè)新的 Git 服務(wù)器，然后就可以開始使用。如果想要?dú)v史，可以從 Subversion 服務(wù)器上盡可能快地拉取數(shù)據(jù)來(lái)完成這件事（這可能會(huì)花費(fèi)一些時(shí)間）。還不熟悉 git svn 相關(guān)內(nèi)容的，請(qǐng)參考：Github之深入解析如何在那些托管在不同系統(tǒng)的項(xiàng)目上使用Git客戶端。
然而，導(dǎo)入并不完美，因?yàn)榛ㄙM(fèi)太長(zhǎng)時(shí)間，可能我們用其他方法也許早已完成導(dǎo)入操作。導(dǎo)入產(chǎn)生的第一個(gè)問(wèn)題就是作者信息，在 Subversion 中，每一個(gè)人提交時(shí)都需要在系統(tǒng)中有一個(gè)用戶，它會(huì)被記錄在提交信息內(nèi)。如果想要將上面的 Subversion 用戶映射到一個(gè)更好的 Git 作者數(shù)據(jù)中，需要一個(gè) Subversion 用戶到 Git 用戶的映射。創(chuàng)建一個(gè) users.txt 的文件包含像下面這種格式的映射：

schacon = Scott Chacon <schacon@geemail.com> selse = Someo Nelse <selse@geemail.com>

為了獲得 SVN 使用的作者名字列表，可以運(yùn)行這個(gè)：

$ svn log --xml --quiet | grep author | sort -u | \perl -pe 's/.*>(.*?)<.*/$1 = /'

這會(huì)將日志輸出為 XML 格式，然后保留作者信息行、去除重復(fù)、去除 XML 標(biāo)記，很顯然這只會(huì)在安裝了 grep、sort 與 perl 的機(jī)器上運(yùn)行；然后，將輸出重定向到 users.txt 文件中，這樣就可以在每一個(gè)記錄后面加入對(duì)應(yīng)的 Git 用戶數(shù)據(jù)。
如果在 Windows 上運(yùn)行它，那么到這里就會(huì)遇到問(wèn)題，微軟提供了一些不錯(cuò)的建議和示例，具體請(qǐng)參考：Learn how to migrate from Subversion (SVN) to Git, including history。
可以將此文件提供給 git svn 來(lái)幫助它更加精確地映射作者數(shù)據(jù)，也可以通過(guò)傳遞 --no-metadata 給 clone 與 init 命令，告訴 git svn 不要包括 Subversion 通常會(huì)導(dǎo)入的元數(shù)據(jù)。在導(dǎo)入過(guò)程中，Git 會(huì)在每個(gè)提交說(shuō)明的元數(shù)據(jù)中生成一個(gè) git-svn-id。
當(dāng)想要將 Git 倉(cāng)庫(kù)中的提交鏡像回原 SVN 倉(cāng)庫(kù)中時(shí)，需要保留元數(shù)據(jù)，如果不想在提交記錄中同步它，請(qǐng)直接省略掉 --no-metadata 選項(xiàng)。這會(huì)使 import 命令看起來(lái)像這樣：

$ git svn clone http://my-project.googlecode.com/svn/ \--authors-file=users.txt --no-metadata --prefix "" -s my_project $ cd my_project

現(xiàn)在在 my_project 目錄中應(yīng)當(dāng)有了一個(gè)更好的 Subversion 導(dǎo)入，并不像是下面這樣的提交：

commit 37efa680e8473b615de980fa935944215428a35a Author: schacon <schacon@4c93b258-373f-11de-be05-5f7a86268029> Date: Sun May 3 00:12:22 2009 +0000fixed install - go to trunkgit-svn-id: https://my-project.googlecode.com/svn/trunk@94 4c93b258-373f-11de-be05-5f7a86268029

反而它們看起來(lái)像是這樣：

commit 03a8785f44c8ea5cdb0e8834b7c8e6c469be2ff2 Author: Scott Chacon <schacon@geemail.com> Date: Sun May 3 00:12:22 2009 +0000fixed install - go to trunk

不僅是 Author 字段更好看了，git-svn-id 也不存在了。之后，應(yīng)當(dāng)做一些導(dǎo)入后的清理工作，第一步應(yīng)當(dāng)清理 git svn 設(shè)置的奇怪的引用，首先移動(dòng)標(biāo)簽，這樣它們就是標(biāo)簽而不是奇怪的遠(yuǎn)程引用，然后會(huì)移動(dòng)剩余的分支這樣它們就是本地的。
為了將標(biāo)簽變?yōu)楹线m的 Git 標(biāo)簽，運(yùn)行：

$ for t in $(git for-each-ref --format='%(refname:short)' refs/remotes/tags); do git tag ${t/tags\//} $t && git branch -D -r $t; done

這會(huì)使原來(lái)在 refs/remotes/tags/ 里的遠(yuǎn)程分支引用變成真正的（輕量）標(biāo)簽。接下來(lái)，將 refs/remotes 下剩余的引用移動(dòng)為本地分支：

$ for b in $(git for-each-ref --format='%(refname:short)' refs/remotes); do git branch $b refs/remotes/$b && git branch -D -r $b; done

可能會(huì)看到一些額外的分支，這些分支的后綴是 @xxx (其中 xxx 是一個(gè)數(shù)字)，而在 Subversion 中只會(huì)看到一個(gè)分支，這實(shí)際上是 Subversion 一個(gè)叫做“peg-revisions”的功能，Git 在語(yǔ)法上沒有與之對(duì)應(yīng)的功能。因此， git svn 只是簡(jiǎn)單地將 SVN peg-revision 版本號(hào)添加到分支名稱中，這同在 SVN 中修改分支名稱來(lái)定位一個(gè)分支的“peg-revision”是一樣的。如果對(duì)于 peg-revisions 完全不在乎，通過(guò)下面的命令可以輕易地移除他們：

$ for p in $(git for-each-ref --format='%(refname:short)' | grep @); do git branch -D $p; done

現(xiàn)在所有的舊分支都是真正的 Git 分支，并且所有的舊標(biāo)簽都是真正的 Git 標(biāo)簽。
還有最后一點(diǎn)東西需要清理，git svn 會(huì)創(chuàng)建一個(gè)名為 trunk 的額外分支，它對(duì)應(yīng)于 Subversion 的默認(rèn)分支，然而 trunk 引用和 master 指向同一個(gè)位置。鑒于在 Git 中 master 最為常用，因此可以移除額外的分支：

$ git branch -d trunk

最后一件要做的事情是，將新 Git 服務(wù)器添加為遠(yuǎn)程倉(cāng)庫(kù)并推送到上面。如下所示，將服務(wù)器添加為遠(yuǎn)程倉(cāng)庫(kù)：

$ git remote add origin git@my-git-server:myrepository.git

因?yàn)橄胍蟼魉蟹种c標(biāo)簽，現(xiàn)在可以運(yùn)行：

$ git push origin --all $ git push origin --tags

通過(guò)以上漂亮、干凈地導(dǎo)入操作，所有分支與標(biāo)簽都應(yīng)該在新 Git 服務(wù)器上。

三、Mercurial

因?yàn)?Mercurial 與 Git 在表示版本時(shí)有著非常相似的模型，也因?yàn)?Git 擁有更加強(qiáng)大的靈活性，將一個(gè)倉(cāng)庫(kù)從 Mercurial 轉(zhuǎn)換到 Git 是相當(dāng)直接的，使用一個(gè)叫作“hg-fast-export”的工具，需要從這里拷貝一份：

$ git clone https://github.com/frej/fast-export.git

轉(zhuǎn)換的第一步就是要先得到想要轉(zhuǎn)換的 Mercurial 倉(cāng)庫(kù)的完整克隆：

$ hg clone <remote repo URL> /tmp/hg-repo

下一步就是創(chuàng)建一個(gè)作者映射文件，Mercurial 對(duì)放入到變更集作者字段的內(nèi)容比 Git 更寬容一些，所以這是一個(gè)清理的好機(jī)會(huì)，只需要用到 bash 終端下的一行命令：

$ cd /tmp/hg-repo $ hg log | grep user: | sort | uniq | sed 's/user: *//' > ../authors

這會(huì)花費(fèi)幾秒鐘，具體要看項(xiàng)目提交歷史有多少，最終 /tmp/authors 文件看起來(lái)會(huì)像這樣：

bob bob@localhost bob <bob@company.com> bob jones <bob <AT> company <DOT> com> Bob Jones <bob@company.com> Joe Smith <joe@company.com>

在這個(gè)例子中，同一個(gè)人（Bob）使用不同的名字創(chuàng)建變更集，其中一個(gè)實(shí)際上是正確的，另一個(gè)完全不符合 Git 提交的規(guī)范。hg-fast-export 通過(guò)對(duì)每一行應(yīng)用規(guī)則 “”="" ，將映射到來(lái)修正這個(gè)問(wèn)題。在和字符串中，所有 Python 的 string_escape 支持的轉(zhuǎn)義序列都會(huì)被解釋。如果作者映射文件中并不包含匹配的，那么該作者將原封不動(dòng)地被發(fā)送到 Git。如果所有的用戶名看起來(lái)都是正確的，那我們根本就不需要這個(gè)文件。在本例中，會(huì)使文件看起來(lái)像這樣：

"bob"="Bob Jones <bob@company.com>" "bob@localhost"="Bob Jones <bob@company.com>" "bob <bob@company.com>"="Bob Jones <bob@company.com>" "bob jones <bob <AT> company <DOT> com>"="Bob Jones <bob@company.com>"

當(dāng)分支和標(biāo)簽 Mercurial 中的名字在 Git 中不允許時(shí)，這種映射文件也可以用來(lái)重命名它們。
下一步是創(chuàng)建一個(gè)新的 Git 倉(cāng)庫(kù)，然后運(yùn)行導(dǎo)出腳本：

$ git init /tmp/converted $ cd /tmp/converted $ /tmp/fast-export/hg-fast-export.sh -r /tmp/hg-repo -A /tmp/authors

-r 選項(xiàng)告訴 hg-fast-export 去哪里尋找我們想要轉(zhuǎn)換的 Mercurial 倉(cāng)庫(kù)，-A 標(biāo)記告訴它在哪找到作者映射文件（分支和標(biāo)簽的映射文件分別通過(guò) -B 和 -T 選項(xiàng)來(lái)指定），這個(gè)腳本會(huì)分析 Mercurial 變更集然后將它們轉(zhuǎn)換成 Git“fast-import”功能需要的腳本，這會(huì)花一點(diǎn)時(shí)間（盡管它比通過(guò)網(wǎng)格更快），輸出相當(dāng)?shù)娜唛L(zhǎng)：

$ /tmp/fast-export/hg-fast-export.sh -r /tmp/hg-repo -A /tmp/authors Loaded 4 authors master: Exporting full revision 1/22208 with 13/0/0 added/changed/removed files master: Exporting simple delta revision 2/22208 with 1/1/0 added/changed/removed files master: Exporting simple delta revision 3/22208 with 0/1/0 added/changed/removed files […] master: Exporting simple delta revision 22206/22208 with 0/4/0 added/changed/removed files master: Exporting simple delta revision 22207/22208 with 0/2/0 added/changed/removed files master: Exporting thorough delta revision 22208/22208 with 3/213/0 added/changed/removed files Exporting tag [0.4c] at [hg r9] [git :10] Exporting tag [0.4d] at [hg r16] [git :17] […] Exporting tag [3.1-rc] at [hg r21926] [git :21927] Exporting tag [3.1] at [hg r21973] [git :21974] Issued 22315 commands git-fast-import statistics: --------------------------------------------------------------------- Alloc'd objects: 120000 Total objects: 115032 ( 208171 duplicates )blobs : 40504 ( 205320 duplicates 26117 deltas of 39602 attempts)trees : 52320 ( 2851 duplicates 47467 deltas of 47599 attempts)commits: 22208 ( 0 duplicates 0 deltas of 0 attempts)tags : 0 ( 0 duplicates 0 deltas of 0 attempts) Total branches: 109 ( 2 loads )marks: 1048576 ( 22208 unique )atoms: 1952 Memory total: 7860 KiBpools: 2235 KiBobjects: 5625 KiB --------------------------------------------------------------------- pack_report: getpagesize() = 4096 pack_report: core.packedGitWindowSize = 1073741824 pack_report: core.packedGitLimit = 8589934592 pack_report: pack_used_ctr = 90430 pack_report: pack_mmap_calls = 46771 pack_report: pack_open_windows = 1 / 1 pack_report: pack_mapped = 340852700 / 340852700 ---------------------------------------------------------------------$ git shortlog -sn369 Bob Jones365 Joe Smith

看起來(lái)非常好，所有 Mercurial 標(biāo)簽都已被轉(zhuǎn)換成 Git 標(biāo)簽，Mercurial 分支與書簽都被轉(zhuǎn)換成 Git 分支。現(xiàn)在已經(jīng)準(zhǔn)備好將倉(cāng)庫(kù)推送到新的服務(wù)器那邊：

$ git remote add origin git@my-git-server:myrepository.git $ git push origin --all

四、Bazaar

Bazaar 是一個(gè)和 Git 非常類似的分布式版本控制系統(tǒng)（DVCS)，因此將 Bazzar 倉(cāng)庫(kù)轉(zhuǎn)換成 Git 倉(cāng)庫(kù)是非常簡(jiǎn)單易懂的。
想要完成轉(zhuǎn)換，需要安裝 bzr-fastimport 插件。

① 安裝 bzr-fastimport 插件

安裝 fastimport 插件的步驟在類 UNIX 操作系統(tǒng)和 Windows 上是不一樣的。在類 UNIX 系統(tǒng)上，最簡(jiǎn)單的辦法就是安裝 bzr-fastimport 包，這種方法將會(huì)自動(dòng)安裝所有需要的依賴。
例如，使用 Debian 及其派生系統(tǒng)，只需要進(jìn)行以下操作：

$ sudo apt-get install bzr-fastimport

紅帽企業(yè)版系統(tǒng)（RHEL），使用以下命令：

$ sudo yum install bzr-fastimport

Fedora 從 22 版本開始，采用了新的包管理器 dnf，使用以下命令：

$ sudo dnf install bzr-fastimport

如果直接安裝包的方法不行，可能需要使用安裝插件的方法：

$ mkdir --parents ~/.bazaar/plugins # 為插件創(chuàng)建必要的文件夾 $ cd ~/.bazaar/plugins $ bzr branch lp:bzr-fastimport fastimport # 引入 fastimport 插件 $ cd fastimport $ sudo python setup.py install --record=files.txt # 安裝插件

為了確保插件工作，同時(shí)也需要安裝有 fastimport 這一 Python 模塊，使用下面的命令可以檢查這一模塊安裝與否，如果沒有則安裝這一模塊：

$ python -c "import fastimport" Traceback (most recent call last):File "<string>", line 1, in <module> ImportError: No module named fastimport $ pip install fastimport

如果上面的命令安裝失敗，可以直接到這個(gè)地址下載 fastimport 0.9.14。
在 Windows 上，bzr-fastimport 插件在 Git 使用脫機(jī)安裝并保持默認(rèn)安裝選項(xiàng)不變（可選框全部選中）的情況下是自動(dòng)安裝的，在這種情況下，什么都不用做。
接下來(lái)，導(dǎo)入 Bazaar 倉(cāng)庫(kù)的方法根據(jù)倉(cāng)庫(kù)是有一個(gè)分支還是有多個(gè)分支而不同。

② 單分支項(xiàng)目

cd 到包含 Bazaar 倉(cāng)庫(kù)的路徑，然后初始化 Git 倉(cāng)庫(kù)：

$ cd /path/to/the/bzr/repository $ git init

現(xiàn)在可以使用以下命令輕松地導(dǎo)出 Bazaar 倉(cāng)庫(kù)并把它轉(zhuǎn)化成 Git 倉(cāng)庫(kù)：

$ bzr fast-export --plain . | git fast-import

根據(jù)項(xiàng)目的大小，Git 倉(cāng)庫(kù)會(huì)在幾秒鐘到幾分鐘之間構(gòu)建。

③ 多分支項(xiàng)目

同樣也能夠?qū)氚鄠€(gè)分支的 Bazaar 倉(cāng)庫(kù)，讓我們假設(shè)有兩個(gè)分支，一個(gè)代表主分支（myProject.trunk），另一個(gè)是工作分支（myProject.work）：

$ ls myProject.trunk myProject.work

創(chuàng)建一個(gè) Git 倉(cāng)庫(kù)并 cd 進(jìn)去：

$ git init git-repo $ cd git-repo

將 master 分支拉入 Git：

$ bzr fast-export --export-marks=../marks.bzr ../myProject.trunk | \ git fast-import --export-marks=../marks.git

將工作分支拉入 Git：

$ bzr fast-export --marks=../marks.bzr --git-branch=work ../myProject.work | \ git fast-import --import-marks=../marks.git --export-marks=../marks.git

現(xiàn)在 git branch 會(huì)同時(shí)顯示 master 分支和 work 分支，檢查日志以確保它們是完整的，并刪除 marks.bzr 和 marks.git 文件。

④ 同步暫存區(qū)

無(wú)論有多少分支以及使用的導(dǎo)入方法如何，暫存區(qū)都不會(huì)與 HEAD 同步，并且在導(dǎo)入多個(gè)分支時(shí)，工作目錄也不會(huì)同步。這種情況使用下面的命令可以輕松解決：

$ git reset --hard HEAD

⑤ 忽略被 .bzrignore 文件指明忽略的文件

現(xiàn)在看看要忽略的文件，第一件事情就是將 .bzrignore 重命名為 .gitignore，如果 .bzrignore 文件里面有一行或數(shù)行以“!!”或“RE:”開頭的內(nèi)容，必須修改它，并且可能還要?jiǎng)?chuàng)建幾個(gè) .gitignore 文件，以便忽略與 Bazaar 忽略的文件完全相同的文件。
最后，必須創(chuàng)建一個(gè)提交，其中包含此次遷移的修改：

$ git mv .bzrignore .gitignore $ # modify .gitignore if needed $ git commit -am 'Migration from Bazaar to Git'

⑥ 推送你的倉(cāng)庫(kù)到服務(wù)器

終于到這一步了，現(xiàn)在可以推送倉(cāng)庫(kù)到它的“云端新家”了：

$ git remote add origin git@my-git-server:mygitrepository.git $ git push origin --all $ git push origin --tags

Git 倉(cāng)庫(kù)準(zhǔn)備就緒。

五、Perforce

下一個(gè)將要看到導(dǎo)入的系統(tǒng)是 Perforce，就像之前討論過(guò)的，有兩種方式讓 Git 與 Perforce 互相通信：git-p4 與 Perforce Git Fusion。

① Perforce Git Fusion

Git Fusion 使這個(gè)過(guò)程毫無(wú)痛苦，只需要使用在 Git Fusion 中討論過(guò)的配置文件來(lái)配置項(xiàng)目設(shè)置、用戶映射與分支，然后克隆整個(gè)倉(cāng)庫(kù)。Git Fusion 讓我們處在一個(gè)看起來(lái)像是原生 Git 倉(cāng)庫(kù)的環(huán)境中，如果愿意的話可以隨時(shí)將它推送到一個(gè)原生 Git 托管中，如果喜歡的話甚至可以使用 Perforce 作為我們的 Git 托管。

② Git-p4

Git-p4 也可以作為一個(gè)導(dǎo)入工具。作為例子，我們將從 Perforce 公開倉(cāng)庫(kù)中導(dǎo)入 Jam 項(xiàng)目，為了設(shè)置客戶端，必須導(dǎo)出 P4PORT 環(huán)境變量指向 Perforce 倉(cāng)庫(kù)：

$ export P4PORT=public.perforce.com:1666

為了繼續(xù)后續(xù)步驟，需要連接到 Perforce 倉(cāng)庫(kù)，在我們的例子中將會(huì)使用在 public.perforce.com 的公開倉(cāng)庫(kù)，但是可以使用任何有權(quán)限的倉(cāng)庫(kù)。
運(yùn)行 git p4 clone 命令從 Perforce 服務(wù)器導(dǎo)入 Jam 項(xiàng)目，提供倉(cāng)庫(kù)、項(xiàng)目路徑與想要存放導(dǎo)入項(xiàng)目的路徑：

$ git-p4 clone //guest/perforce_software/jam@all p4import Importing from //guest/perforce_software/jam@all into p4import Initialized empty Git repository in /private/tmp/p4import/.git/ Import destination: refs/remotes/p4/master Importing revision 9957 (100%)

這個(gè)特定的項(xiàng)目只有一個(gè)分支，但是如果在分支視圖（或者說(shuō)一些目錄）中配置了一些分支，可以將 --detect-branches 選項(xiàng)傳遞給 git p4 clone 來(lái)導(dǎo)入項(xiàng)目的所有分支。
此時(shí)，幾乎已經(jīng)完成了，如果進(jìn)入 p4import 目錄中并運(yùn)行 git log，可以看到導(dǎo)入工作：

$ git log -2 commit e5da1c909e5db3036475419f6379f2c73710c4e6 Author: giles <giles@giles@perforce.com> Date: Wed Feb 8 03:13:27 2012 -0800Correction to line 355; change </UL> to </OL>.[git-p4: depot-paths = "//public/jam/src/": change = 8068]commit aa21359a0a135dda85c50a7f7cf249e4f7b8fd98 Author: kwirth <kwirth@perforce.com> Date: Tue Jul 7 01:35:51 2009 -0800Fix spelling error on Jam doc page (cummulative -> cumulative).[git-p4: depot-paths = "//public/jam/src/": change = 7304]

可以看到 git-p4 在每一個(gè)提交里都留下了一個(gè)標(biāo)識(shí)符，如果之后想要引用 Perforce 的修改序號(hào)的話，標(biāo)識(shí)符保留在那里也是可以的。然而，如果想要移除標(biāo)識(shí)符，現(xiàn)在正是這么做的時(shí)候，在開始在新倉(cāng)庫(kù)中工作之前。可以使用 git filter-branch 將全部標(biāo)識(shí)符移除：

$ git filter-branch --msg-filter 'sed -e "/^\[git-p4:/d"' Rewrite e5da1c909e5db3036475419f6379f2c73710c4e6 (125/125) Ref 'refs/heads/master' was rewritten

如果運(yùn)行 git log，會(huì)看到所有提交的 SHA-1 校驗(yàn)和都改變了，但是提交信息中不再有 git-p4 字符串了：

$ git log -2 commit b17341801ed838d97f7800a54a6f9b95750839b7 Author: giles <giles@giles@perforce.com> Date: Wed Feb 8 03:13:27 2012 -0800Correction to line 355; change </UL> to </OL>.commit 3e68c2e26cd89cb983eb52c024ecdfba1d6b3fff Author: kwirth <kwirth@perforce.com> Date: Tue Jul 7 01:35:51 2009 -0800Fix spelling error on Jam doc page (cummulative -> cumulative).

現(xiàn)在導(dǎo)入已經(jīng)準(zhǔn)備好推送到新 Git 服務(wù)器上了。

六、TFS

如果我們的團(tuán)隊(duì)正在將他們的源代碼管理從 TFVC 轉(zhuǎn)換為 Git，會(huì)想要最高程度的無(wú)損轉(zhuǎn)換，在這里只分析介紹 git-tfs，因?yàn)?git-tfs 支持分支，而使用 git-tf 代價(jià)太大。這是一個(gè)單向轉(zhuǎn)換，意味著 Git 倉(cāng)庫(kù)無(wú)法連接到原始的 TFVC 項(xiàng)目。
第一件事是映射用戶名，TFVC 對(duì)待變更集作者字段的內(nèi)容相當(dāng)寬容，但是 Git 需要人類可讀的名字與郵箱地址，可以通過(guò) tf 命令行客戶端來(lái)獲取這個(gè)信息，像這樣：

PS> tf history $/myproject -recursive > AUTHORS_TMP

這會(huì)將歷史中的所有變更集抓取下來(lái)并放到 AUTHORS_TMP 文件中，然后我們將會(huì)將 User 列（第二個(gè)）取出來(lái)。打開文件找到列開始與結(jié)束的字符并替換，在下面的命令行中，cut 命令的參數(shù) 11-20 就是我們找到的：

PS> cat AUTHORS_TMP | cut -b 11-20 | tail -n+3 | sort | uniq > AUTHORS

cut 命令只會(huì)保留每行中第 11 個(gè)到第 22 個(gè)字符，tail 命令會(huì)跳過(guò)前兩行，就是字段表頭與 ASCII 風(fēng)格的下劃線。所有這些的結(jié)果通過(guò)管道送到 sort 和 uniq 來(lái)去除重復(fù)，然后保存到 AUTOHRS 文件中。下一步是手動(dòng)的，為了讓 git-tfs 有效地使用這個(gè)文件，每一行必須是這種格式：

DOMAIN\username = User Name <email@address.com>

左邊的部分是 TFVC 中的 “User” 字段，等號(hào)右邊的部分是將被用作 Git 提交的用戶名。一旦有了這個(gè)文件，下一件事就是生成一個(gè)需要的 TFVC 項(xiàng)目的完整克隆：

PS> git tfs clone --with-branches --authors=AUTHORS https://username.visualstudio.com/DefaultCollection $/project/Trunk project_git

接下來(lái)要從提交信息底部清理 git-tfs-id 區(qū)塊，如下的命令會(huì)完成這個(gè)任務(wù)：

PS> git filter-branch -f --msg-filter 'sed "s/^git-tfs-id:.*$//g"' '--' --all

那會(huì)使用 Git 終端環(huán)境中的 sed 命令來(lái)將所有以 “git-tfs-id:” 開頭的行替換為 Git 會(huì)忽略的空白。
全部完成后，就已經(jīng)準(zhǔn)備好去增加一個(gè)新的遠(yuǎn)程倉(cāng)庫(kù)，推送所有的分支上去，然后我們的團(tuán)隊(duì)就可以開始用 Git 工作了。

① 一個(gè)自定義的導(dǎo)入器

如果系統(tǒng)不是上述中的任何一個(gè)，需要在線查找一個(gè)導(dǎo)入器，針對(duì)許多其他系統(tǒng)有很多高質(zhì)量的導(dǎo)入器，包括 CVS、Clear Case、Visual Source Safe，甚至是一個(gè)檔案目錄。如果沒有一個(gè)工具適合，需要一個(gè)不知名的工具，或者需要更大自由度的自定義導(dǎo)入過(guò)程，應(yīng)當(dāng)使用 git fast-import，這個(gè)命令從標(biāo)準(zhǔn)輸入中讀取簡(jiǎn)單指令來(lái)寫入特定的 Git 數(shù)據(jù)。通過(guò)這種方式創(chuàng)建 Git 對(duì)象比運(yùn)行原始 Git 命令或直接寫入原始對(duì)象更容易些，可以編寫導(dǎo)入腳本，從要導(dǎo)入的系統(tǒng)中讀取必要數(shù)據(jù)，然后直接打印指令到標(biāo)準(zhǔn)輸出，然后可以運(yùn)行這個(gè)程序并通過(guò) git fast-import 重定向管道輸出。
為了快速演示，現(xiàn)在寫一個(gè)簡(jiǎn)單的導(dǎo)入器，假設(shè)在 current 工作，有時(shí)候會(huì)備份項(xiàng)目到時(shí)間標(biāo)簽 back_YYYY_MM_DD 備份目錄中，想要將這些導(dǎo)入到 Git 中，目錄結(jié)構(gòu)看起來(lái)是這樣：

$ ls /opt/import_from back_2014_01_02 back_2014_01_04 back_2014_01_14 back_2014_02_03 current

為了導(dǎo)入一個(gè) Git 目錄，需要了解 Git 如何存儲(chǔ)它的數(shù)據(jù)，我們知道，Git 在底層存儲(chǔ)指向內(nèi)容快照的提交對(duì)象的鏈表，因此所有要做的就是告訴 fast-import 哪些內(nèi)容是快照，哪個(gè)提交數(shù)據(jù)指向它們，以及它們進(jìn)入的順序。策略是一次訪問(wèn)一個(gè)快照，然后用每個(gè)目錄中的內(nèi)容創(chuàng)建提交，并且將每一個(gè)提交與前一個(gè)連接起來(lái)。
使用強(qiáng)制策略，我們將會(huì)使用 Ruby 寫這個(gè)，因?yàn)樗俏覀兤匠９ぷ髦惺褂玫牟⑶宜苋菀鬃x懂，可以使用任何熟悉的東西來(lái)非常輕松地寫這個(gè)例子，它只需要將合適的信息打印到標(biāo)準(zhǔn)輸出。然而，如果在 Windows 上，這意味著需要特別注意不要引入回車符到行尾—— git fast-import 非常特別地只接受換行符（LF）而不是 Windows 使用的回車換行符（CRLF）。
現(xiàn)在開始，需要進(jìn)入目標(biāo)目錄中并識(shí)別每一個(gè)子目錄，每一個(gè)都是要導(dǎo)入為提交的快照，要進(jìn)入到每個(gè)子目錄中并為導(dǎo)出它打印必要的命令，基本主循環(huán)像這個(gè)樣子：

last_mark = nil# loop through the directories Dir.chdir(ARGV[0]) doDir.glob("*").each do |dir|next if File.file?(dir)# move into the target directoryDir.chdir(dir) dolast_mark = print_export(dir, last_mark)endend end

在每個(gè)目錄內(nèi)運(yùn)行 print_export，將會(huì)拿到清單并標(biāo)記之前的快照，然后返回清單并標(biāo)記現(xiàn)在的快照；通過(guò)這種方式，可以將它們合適地連接在一起。“標(biāo)記”是一個(gè)給提交標(biāo)識(shí)符的 fast-import 術(shù)語(yǔ)；當(dāng)創(chuàng)建提交，為每一個(gè)提交賦予一個(gè)標(biāo)記來(lái)將它與其他提交連接在一起，這樣，在 print_export 方法中第一件要做的事就是從目錄名字生成一個(gè)標(biāo)記：

mark = convert_dir_to_mark(dir)

可以創(chuàng)建一個(gè)目錄的數(shù)組并使用索引做為標(biāo)記，因?yàn)闃?biāo)記必須是一個(gè)整數(shù)。方法類似這樣：

$marks = [] def convert_dir_to_mark(dir)if !$marks.include?(dir)$marks << dirend($marks.index(dir) + 1).to_s end

既然有一個(gè)整數(shù)代表你的提交，那還要給提交元數(shù)據(jù)一個(gè)日期，因?yàn)槟夸浢直磉_(dá)了日期，所以將會(huì)從中解析出日期， print_export 文件的下一行是：

date = convert_dir_to_date(dir) convert_dir_to_date 定義為：def convert_dir_to_date(dir)if dir == 'current'return Time.now().to_ielsedir = dir.gsub('back_', '')(year, month, day) = dir.split('_')return Time.local(year, month, day).to_iend end

那會(huì)返回每一個(gè)目錄日期的整數(shù)，最后一項(xiàng)每個(gè)提交需要的元數(shù)據(jù)是提交者信息，它將會(huì)被硬編碼在全局變量中：

$author = 'John Doe <john@example.com>'

現(xiàn)在準(zhǔn)備開始為導(dǎo)入器打印出提交數(shù)據(jù)，初始信息聲明定義了一個(gè)提交對(duì)象與它所在的分支，緊接著一個(gè)生成的標(biāo)記、提交者信息與提交信息、然后是一個(gè)之前的提交，如果它存在的話，代碼看起來(lái)像這樣：

# print the import information puts 'commit refs/heads/master' puts 'mark :' + mark puts "committer #{$author} #{date} -0700" export_data('imported from ' + dir) puts 'from :' + last_mark if last_mark

我們將硬編碼時(shí)區(qū)信息（-0700），因?yàn)檫@樣很容易，如果從其他系統(tǒng)導(dǎo)入，必須指定為一個(gè)偏移的時(shí)區(qū)，提交信息必須指定為特殊的格式：

data (size)\n(contents)

這個(gè)格式包括文本數(shù)據(jù)、將要讀取數(shù)據(jù)的大小、一個(gè)換行符、最終的數(shù)據(jù)，因?yàn)橹筮€需要為文件內(nèi)容指定相同的數(shù)據(jù)格式，需要?jiǎng)?chuàng)建一個(gè)幫助函數(shù)，export_data：

def export_data(string)print "data #{string.size}\n#{string}" end

剩下的工作就是指定每一個(gè)快照的文件內(nèi)容，這很輕松，因?yàn)槊恳粋€(gè)目錄都是一個(gè)快照，可以在目錄中的每一個(gè)文件內(nèi)容后打印 deleteall 命令，Git 將會(huì)適當(dāng)?shù)赜涗浢恳粋€(gè)快照：

puts 'deleteall' Dir.glob("**/*").each do |file|next if !File.file?(file)inline_data(file) end

因?yàn)榇蠖鄶?shù)系統(tǒng)認(rèn)為他們的版本是從一個(gè)提交變化到另一個(gè)提交，fast-import 也可以為每一個(gè)提交執(zhí)行命令來(lái)指定哪些文件是添加的、刪除的或修改的與新內(nèi)容是哪些，可以計(jì)算快照間的不同并只提供這些數(shù)據(jù)，但是這樣做會(huì)很復(fù)雜；也可以把所有數(shù)據(jù)給 Git 然后讓它為我們指出來(lái)，如果這更適合數(shù)據(jù)，查閱 fast-import man 幫助頁(yè)來(lái)了解如何以這種方式提供數(shù)據(jù)。
這種列出新文件內(nèi)容或用新內(nèi)容指定修改文件的格式如同下面的內(nèi)容：

M 644 inline path/to/file data (size) (file contents)

這里，644 是模式（如果有可執(zhí)行文件，反而需要檢測(cè)并指定 755），inline 表示將會(huì)立即把內(nèi)容放在本行之后，inline_data 方法看起來(lái)像這樣：

def inline_data(file, code = 'M', mode = '644')content = File.read(file)puts "#{code} #{mode} inline #{file}"export_data(content) end

可以重用之前定義的 export_data 方法，因?yàn)樗c定義的提交信息數(shù)據(jù)的方法一樣。
最后一件需要做的是返回當(dāng)前的標(biāo)記以便它可以傳給下一個(gè)迭代：

return mark

如果在 Windows 上還需要確保增加一個(gè)額外步驟，正如之前提到的，Windows 使用 CRLF 作為換行符而 git fast-import 只接受 LF，為了修正這個(gè)問(wèn)題使 git fast-import 正常工作，需要告訴 ruby 使用 LF 代替 CRLF：

$stdout.binmode

就是這樣，這是全部的腳本：

#!/usr/bin/env ruby$stdout.binmode $author = "John Doe <john@example.com>"$marks = [] def convert_dir_to_mark(dir)if !$marks.include?(dir)$marks << dirend($marks.index(dir)+1).to_s enddef convert_dir_to_date(dir)if dir == 'current'return Time.now().to_ielsedir = dir.gsub('back_', '')(year, month, day) = dir.split('_')return Time.local(year, month, day).to_iend enddef export_data(string)print "data #{string.size}\n#{string}" enddef inline_data(file, code='M', mode='644')content = File.read(file)puts "#{code} #{mode} inline #{file}"export_data(content) enddef print_export(dir, last_mark)date = convert_dir_to_date(dir)mark = convert_dir_to_mark(dir)puts 'commit refs/heads/master'puts "mark :#{mark}"puts "committer #{$author} #{date} -0700"export_data("imported from #{dir}")puts "from :#{last_mark}" if last_markputs 'deleteall'Dir.glob("**/*").each do |file|next if !File.file?(file)inline_data(file)endmark end# Loop through the directories last_mark = nil Dir.chdir(ARGV[0]) doDir.glob("*").each do |dir|next if File.file?(dir)# move into the target directoryDir.chdir(dir) dolast_mark = print_export(dir, last_mark)endend end

如果運(yùn)行這個(gè)腳本，會(huì)得到類似下面的內(nèi)容：

$ ruby import.rb /opt/import_from commit refs/heads/master mark :1 committer John Doe <john@example.com> 1388649600 -0700 data 29 imported from back_2014_01_02deleteall M 644 inline README.md data 28 # HelloThis is my readme. commit refs/heads/master mark :2 committer John Doe <john@example.com> 1388822400 -0700 data 29 imported from back_2014_01_04from :1 deleteall M 644 inline main.rb data 34 #!/bin/env rubyputs "Hey there" M 644 inline README.md (...)

為了運(yùn)行導(dǎo)入器，將這些輸出用管道重定向到想要導(dǎo)入的 Git 目錄中的 git fast-import，可以創(chuàng)建一個(gè)新的目錄并在其中運(yùn)行 git init 作為開始，然后運(yùn)行腳本：

$ git init Initialized empty Git repository in /opt/import_to/.git/ $ ruby import.rb /opt/import_from | git fast-import git-fast-import statistics: --------------------------------------------------------------------- Alloc'd objects: 5000 Total objects: 13 ( 6 duplicates )blobs : 5 ( 4 duplicates 3 deltas of 5 attempts)trees : 4 ( 1 duplicates 0 deltas of 4 attempts)commits: 4 ( 1 duplicates 0 deltas of 0 attempts)tags : 0 ( 0 duplicates 0 deltas of 0 attempts) Total branches: 1 ( 1 loads )marks: 1024 ( 5 unique )atoms: 2 Memory total: 2344 KiBpools: 2110 KiBobjects: 234 KiB --------------------------------------------------------------------- pack_report: getpagesize() = 4096 pack_report: core.packedGitWindowSize = 1073741824 pack_report: core.packedGitLimit = 8589934592 pack_report: pack_used_ctr = 10 pack_report: pack_mmap_calls = 5 pack_report: pack_open_windows = 2 / 2 pack_report: pack_mapped = 1457 / 1457 ---------------------------------------------------------------------

正如所看到的，當(dāng)它成功完成時(shí)，它會(huì)給我們一串關(guān)于它完成內(nèi)容的統(tǒng)計(jì)。這本例中，一共導(dǎo)入了 13 個(gè)對(duì)象、4 次提交到 1 個(gè)分支，現(xiàn)在可以運(yùn)行 git log 來(lái)看一下你的新歷史：

$ git log -2 commit 3caa046d4aac682a55867132ccdfbe0d3fdee498 Author: John Doe <john@example.com> Date: Tue Jul 29 19:39:04 2014 -0700imported from currentcommit 4afc2b945d0d3c8cd00556fbe2e8224569dc9def Author: John Doe <john@example.com> Date: Mon Feb 3 01:00:00 2014 -0700imported from back_2014_02_03

做得很好，一個(gè)漂亮、干凈的 Git 倉(cāng)庫(kù)，要注意的一點(diǎn)是并沒有檢出任何東西，一開始工作目錄內(nèi)并沒有任何文件。為了得到他們，必須將分支重置到 master 所在的地方：

$ ls $ git reset --hard master HEAD is now at 3caa046 imported from current $ ls README.md main.rb

可以通過(guò) fast-import 工具做很多事情，處理不同模式、二進(jìn)制數(shù)據(jù)、多個(gè)分支與合并、標(biāo)簽、進(jìn)度指示等。一些更復(fù)雜情形下的例子可以在 Git 源代碼目錄中的 contrib/fast-import 目錄中找到。

總結(jié)

以上是生活随笔為你收集整理的Git之深入解析如何将项目迁移到Git的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問(wèn)題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。

上一篇： GitHub之深入解析脚本·自定义与修改
下一篇： Git内部原理之深入解析Git对象