[[357214]]

擁有一致的命名標(biāo)準(zhǔn)是保持本地和上游 Git 倉庫保持一致的關(guān)鍵。

當(dāng)本地 Git 倉庫的命名與遠(yuǎn)程倉庫不一致時，與遠(yuǎn)程倉庫協(xié)作就會變得很混亂。

解決此問題的一個方法是標(biāo)準(zhǔn)化兩個詞的使用和含義：origin 指的是你個人的 example.com/<USER>/* 倉庫，而 upstream 指的是你從 origin 倉庫復(fù)刻fork出來的 example.com 倉庫。換句話說，upstream 指的是公開提交工作的上游倉庫，而 origin 指的是你對上游倉庫的本地復(fù)刻，例如，你從這里生成拉取請求pull request（PR）。

以 pbench 倉庫為例，下面是一個逐步建立新的本地克隆的方法，其中 origin 和 upstream 的定義是一致的。

1、在大多數(shù) Git 托管服務(wù)上，當(dāng)你想在上面工作時，必須對它進(jìn)行復(fù)刻。當(dāng)你運(yùn)行自己的 Git 服務(wù)器時，這并不是必要的，但對于一個公開的代碼庫來說，這是一個在貢獻(xiàn)者之間傳輸差異的簡單方法。

創(chuàng)建一個 Git 倉庫的復(fù)刻。在這個例子中，假設(shè)你的復(fù)刻位于 example.com/<USER>/pbench。

2、接下來，你必須獲得一個統(tǒng)一資源標(biāo)識符 （URI），以便通過 SSH 進(jìn)行克隆cloning。在大多數(shù) Git 托管服務(wù)上，比如 GitLab 或 GitHub，它在一個標(biāo)有 “Clone” 或 “Clone over SSH” 的按鈕或面板上，可以將克隆 URI 復(fù)制到剪貼板中。

3、在你的開發(fā)系統(tǒng)中，使用你復(fù)制的 URI 克隆倉庫：

$ git clone git@example.com:<USER>/pbench.git

這將以默認(rèn)名稱 origin 來克隆 Git 倉庫，作為你的 pbench 倉庫復(fù)刻副本。

4、切換到剛才克隆的目錄：

$ cd ~/pbench

5、下一步，獲取源倉庫的 SSH URI（你最初復(fù)刻的那個）。這可能和上面的方法一樣。找到 “Clone” 按鈕或面板，復(fù)制克隆地址。在軟件開發(fā)中，這通常被稱為“上游”，因?yàn)椋ɡ碚撋希┻@是大多數(shù)提交發(fā)生的地方，而你打算讓這些提交流向下游的倉庫。

6、將 URI 添加到你的本地倉庫中。是的，將有兩個不同的遠(yuǎn)程倉庫分配給你的本地倉庫副本：

$ git remote add upstream git@example.com:bigproject/pbench.git

7、現(xiàn)在你有兩個命名遠(yuǎn)程倉庫：origin 和 upstream。 你可以用 remote 子命令查看你的遠(yuǎn)程倉庫：

$ git remote -v

現(xiàn)在，你的本地 master 分支正在跟蹤 origin 的 master，這不一定是你想要的。你可能想跟蹤這個分支的 upstream 版本，因?yàn)榇蠖鄶?shù)開發(fā)都在上游進(jìn)行。這個想法是，你要在從上游獲得的內(nèi)容的基礎(chǔ)上添加更改。

8、將你的本地的 master 分支改成跟蹤 upstream/master：

$ git fetch upstream
$ git branch --set-upstream-to=upstream/master master

你可以對任何你想要的分支這樣做，而不僅僅是 master。例如，有些項(xiàng)目使用 dev 分支來處理所有不穩(wěn)定的變化，而將 master 保留給已批準(zhǔn)發(fā)布的代碼。

9、一旦你設(shè)置了你的跟蹤分支，一定要變基（rebase）你的 master 分支，使它與上游倉庫的任何新變化保持一致：

$ git remote update
$ git checkout master
$ git rebase

這是一個保持 Git 倉庫在不同復(fù)刻之間同步的好方法。如果你想自動完成這項(xiàng)工作，請閱讀 Seth Kenlon 關(guān)于使用 Ansible 托管 Git 倉庫的文章。