9.5 Git 內部原理 - The Refspec

The Refspec

這本書讀到這裏,你已經使用過一些簡單的遠程分支到本地引用的映射方式了,這種映射可以更爲複雜。 假設你像這樣添加了一項遠程倉庫:

$ git remote add origin [email protected]:schacon/simplegit-progit.git

它在你的 .git/config 文件中添加了一節,指定了遠程的名稱 (origin), 遠程倉庫的URL地址,和用於獲取操作的 Refspec:

[remote "origin"]
       url = [email protected]:schacon/simplegit-progit.git
       fetch = +refs/heads/*:refs/remotes/origin/*

Refspec 的格式是一個可選的 + 號,接着是 <src>:<dst> 的格式,這裏 <src> 是遠端上的引用格式,<dst> 是將要記錄在本地的引用格式。可選的 + 號告訴 Git 在即使不能快速演進的情況下,也去強制更新它。

缺省情況下 refspec 會被 git remote add 命令所自動生成, Git 會獲取遠端上 refs/heads/ 下面的所有引用,並將它寫入到本地的 refs/remotes/origin/. 所以,如果遠端上有一個 master 分支,你在本地可以通過下面這種方式來訪問它的歷史記錄:

$ git log origin/master
$ git log remotes/origin/master
$ git log refs/remotes/origin/master

它們全是等價的,因爲 Git 把它們都擴展成 refs/remotes/origin/master.

如果你想讓 Git 每次只拉取遠程的 master 分支,而不是遠程的所有分支,你可以把 fetch 這一行修改成這樣:

fetch = +refs/heads/master:refs/remotes/origin/master

這是 git fetch 操作對這個遠端的缺省 refspec 值。而如果你只想做一次該操作,也可以在命令行上指定這個 refspec. 如可以這樣拉取遠程的 master 分支到本地的 origin/mymaster 分支:

$ git fetch origin master:refs/remotes/origin/mymaster

你也可以在命令行上指定多個 refspec. 像這樣可以一次獲取遠程的多個分支:

$ git fetch origin master:refs/remotes/origin/mymaster \
   topic:refs/remotes/origin/topic
From [email protected]:schacon/simplegit
 ! [rejected]        master     -> origin/mymaster  (non fast forward)
 * [new branch]      topic      -> origin/topic

在這個例子中, master 分支因爲不是一個可以快速演進的引用而拉取操作被拒絕。你可以在 refspec 之前使用一個 + 號來重載這種行爲。

你也可以在配置文件中指定多個 refspec. 如你想在每次獲取時都獲取 master 和 experiment 分支,就添加兩行:

[remote "origin"]
       url = [email protected]:schacon/simplegit-progit.git
       fetch = +refs/heads/master:refs/remotes/origin/master
       fetch = +refs/heads/experiment:refs/remotes/origin/experiment

但是這裏不能使用部分通配符,像這樣就是不合法的:

fetch = +refs/heads/qa*:refs/remotes/origin/qa*

但無論如何,你可以使用命名空間來達到這個目的。如你有一個QA組,他們推送一系列分支,你想每次獲取 master 分支和QA組的所有分支,你可以使用這樣的配置段落:

[remote "origin"]
       url = [email protected]:schacon/simplegit-progit.git
       fetch = +refs/heads/master:refs/remotes/origin/master
       fetch = +refs/heads/qa/*:refs/remotes/origin/qa/*

如果你的工作流很複雜,有QA組推送的分支、開發人員推送的分支、和集成人員推送的分支,並且他們在遠程分支上協作,你可以採用這種方式爲他們創建各自的命名空間。

推送 Refspec

採用命名空間的方式確實很棒,但QA組成員第1次是如何將他們的分支推送到 qa/ 空間裏面的呢?答案是你可以使用 refspec 來推送。

如果QA組成員想把他們的 master 分支推送到遠程的 qa/master 分支上,可以這樣運行:

$ git push origin master:refs/heads/qa/master

如果他們想讓 Git 每次運行 git push origin 時都這樣自動推送,他們可以在配置文件中添加 push值:

[remote "origin"]
       url = [email protected]:schacon/simplegit-progit.git
       fetch = +refs/heads/*:refs/remotes/origin/*
       push = refs/heads/master:refs/heads/qa/master

這樣,就會讓 git push origin 缺省就把本地的 master 分支推送到遠程的 qa/master 分支上。

刪除引用

你也可以使用 refspec 來刪除遠程的引用,是通過運行這樣的命令:

$ git push origin :topic

因爲 refspec 的格式是 <src>:<dst>, 通過把 <src> 部分留空的方式,這個意思是是把遠程的 topic 分支變成空,也就是刪除它。


本文來自 http://git-scm.com/ 保存下來,方便自己查閱。


發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章