git遠程倉庫
git遠程倉庫
到目前為止,我們已經掌握了如何在Git倉庫裏對一個文件進行時光穿梭,你再也不用擔心文件備份或者丟失的問題了。
可是有用過集中式版本控制系統SVN的童鞋會站出來說,這些功能在SVN裏早就有了,沒看出Git有什麽特別的地方。
沒錯,如果只是在一個倉庫裏管理文件歷史,Git和SVN真沒啥區別。為了保證你現在所學的Git物超所值,將來絕對不會後悔,同時為了打擊已經不幸學了SVN的童鞋,本章開始介紹Git的殺手級功能之一(註意是之一,也就是後面還有之二,之三……):遠程倉庫。
Git是分布式版本控制系統,同一個Git倉庫,可以分布到不同的機器上。怎麽分布呢?最早,肯定只有一臺機器有一個原始版本庫,此後,別的機器可以“克隆”這個原始版本庫,而且每臺機器的版本庫其實都是一樣的,並沒有主次之分。
你肯定會想,至少需要兩臺機器才能玩遠程庫不是?但是我只有一臺電腦,怎麽玩?
其實一臺電腦上也是可以克隆多個版本庫的,只要不在同一個目錄下。不過,現實生活中是不會有人這麽傻的在一臺電腦上搞幾個遠程庫玩,因為一臺電腦上搞幾個遠程庫完全沒有意義,而且硬盤掛了會導致所有庫都掛掉,所以我也不告訴你在一臺電腦上怎麽克隆多個倉庫。
實際情況往往是這樣,找一臺電腦充當服務器的角色,每天24小時開機,其他每個人都從這個“服務器”倉庫克隆一份到自己的電腦上,並且各自把各自的提交推送到服務器倉庫裏,也從服務器倉庫中拉取別人的提交。
完全可以自己搭建一臺運行Git的服務器,不過現階段,為了學Git先搭個服務器絕對是小題大作。好在這個世界上有個叫GitHub的神奇的網站,從名字就可以看出,這個網站就是提供Git倉庫托管服務的,所以,只要註冊一個GitHub賬號,就可以免費獲得Git遠程倉庫。
在繼續閱讀後續內容前,請自行註冊GitHub賬號。由於你的本地Git倉庫和GitHub倉庫之間的傳輸是通過SSH加密的,所以,需要一點設置:
第1步:創建SSH Key。在用戶主目錄下,看看有沒有.ssh目錄,如果有,再看看這個目錄下有沒有id_rsa
和id_rsa.pub
這兩個文件,如果已經有了,可直接跳到下一步。如果沒有,打開Shell(Windows下打開Git Bash),創建SSH Key:
``` $ ssh-keygen -t rsa -C "[email protected]"
```
你需要把郵件地址換成你自己的郵件地址,然後一路回車,使用默認值即可,由於這個Key也不是用於軍事目的,所以也無需設置密碼。
如果一切順利的話,可以在用戶主目錄裏找到.ssh
目錄,裏面有id_rsa
和id_rsa.pub
兩個文件,這兩個就是SSH Key的秘鑰對,id_rsa
是私鑰,不能泄露出去,id_rsa.pub
是公鑰,可以放心地告訴任何人。
第2步:登陸GitHub,打開“Account settings”,“SSH Keys”頁面:
然後,點“Add SSH Key”,填上任意Title,在Key文本框裏粘貼id_rsa.pub
文件的內容:
點“Add Key”,你就應該看到已經添加的Key:
為什麽GitHub需要SSH Key呢?因為GitHub需要識別出你推送的提交確實是你推送的,而不是別人冒充的,而Git支持SSH協議,所以,GitHub只要知道了你的公鑰,就可以確認只有你自己才能推送。
當然,GitHub允許你添加多個Key。假定你有若幹電腦,你一會兒在公司提交,一會兒在家裏提交,只要把每臺電腦的Key都添加到GitHub,就可以在每臺電腦上往GitHub推送了。
最後友情提示,在GitHub上免費托管的Git倉庫,任何人都可以看到喔(但只有你自己才能改)。所以,不要把敏感信息放進去。
如果你不想讓別人看到Git庫,有兩個辦法,一個是交點保護費,讓GitHub把公開的倉庫變成私有的,這樣別人就看不見了(不可讀更不可寫)。另一個辦法是自己動手,搭一個Git服務器,因為是你自己的Git服務器,所以別人也是看不見的。這個方法我們後面會講到的,相當簡單,公司內部開發必備。
確保你擁有一個GitHub賬號後,我們就即將開始遠程倉庫的學習。
“有了遠程倉庫,媽媽再也不用擔心我的硬盤了。”——Git點讀機
1 添加遠程倉庫
現在的情景是,你已經在本地創建了一個Git倉庫後,又想在GitHub創建一個Git倉庫,並且讓這兩個倉庫進行遠程同步,這樣,GitHub上的倉庫既可以作為備份,又可以讓其他人通過該倉庫來協作,真是一舉多得。
首先,登陸GitHub,然後,在右上角找到“Create a new repo”按鈕,創建一個新的倉庫:
在Repository name填入learngit
,其他保持默認設置,點擊“Create repository”按鈕,就成功地創建了一個新的Git倉庫:
目前,在GitHub上的這個learngit
倉庫還是空的,GitHub告訴我們,可以從這個倉庫克隆出新的倉庫,也可以把一個已有的本地倉庫與之關聯,然後,把本地倉庫的內容推送到GitHub倉庫。
現在,我們根據GitHub的提示,在本地的learngit
倉庫下運行命令:
``` $ git remote add origin [email protected]:michaelliao/learngit.git
```
請千萬註意,把上面的michaelliao
替換成你自己的GitHub賬戶名,否則,你在本地關聯的就是我的遠程庫,關聯沒有問題,但是你以後推送是推不上去的,因為你的SSH Key公鑰不在我的賬戶列表中。
添加後,遠程庫的名字就是origin
,這是Git默認的叫法,也可以改成別的,但是origin
這個名字一看就知道是遠程庫。
下一步,就可以把本地庫的所有內容推送到遠程庫上:
``` $ git push -u origin master Counting objects: 19, done. Delta compression using up to 4 threads. Compressing objects: 100% (19/19), done. Writing objects: 100% (19/19), 13.73 KiB, done. Total 23 (delta 6), reused 0 (delta 0) To [email protected]:michaelliao/learngit.git * [new branch] master -> master Branch master set up to track remote branch master from origin.
```
把本地庫的內容推送到遠程,用git push
命令,實際上是把當前分支master
推送到遠程。
由於遠程庫是空的,我們第一次推送master
分支時,加上了-u
參數,Git不但會把本地的master
分支內容推送的遠程新的master
分支,還會把本地的master
分支和遠程的master
分支關聯起來,在以後的推送或者拉取時就可以簡化命令。
推送成功後,可以立刻在GitHub頁面中看到遠程庫的內容已經和本地一模一樣:
從現在起,只要本地作了提交,就可以通過命令:
``` $ git push origin master
```
把本地master
分支的最新修改推送至GitHub,現在,你就擁有了真正的分布式版本庫!
1.1 SSH警告
當你第一次使用Git的clone
或者push
命令連接GitHub時,會得到一個警告:
``` The authenticity of host ‘github.com (xx.xx.xx.xx)‘ can‘t be established. RSA key fingerprint is xx.xx.xx.xx.xx. Are you sure you want to continue connecting (yes/no)?
```
這是因為Git使用SSH連接,而SSH連接在第一次驗證GitHub服務器的Key時,需要你確認GitHub的Key的指紋信息是否真的來自GitHub的服務器,輸入yes
回車即可。
Git會輸出一個警告,告訴你已經把GitHub的Key添加到本機的一個信任列表裏了:
``` Warning: Permanently added ‘github.com‘ (RSA) to the list of known hosts.
```
這個警告只會出現一次,後面的操作就不會有任何警告了。
如果你實在擔心有人冒充GitHub服務器,輸入yes
前可以對照GitHub的RSA Key的指紋信息是否與SSH連接給出的一致。
1.2 小結
要關聯一個遠程庫,使用命令git remote add origin [email protected]:path/repo-name.git
;
關聯後,使用命令git push -u origin master
第一次推送master分支的所有內容;
此後,每次本地提交後,只要有必要,就可以使用命令git push origin master
推送最新修改;
分布式版本系統的最大好處之一是在本地工作完全不需要考慮遠程庫的存在,也就是有沒有聯網都可以正常工作,而SVN在沒有聯網的時候是拒絕幹活的!當有網絡的時候,再把本地提交推送一下就完成了同步,真是太方便了!
2 從遠程庫克隆
上次我們講了先有本地庫,後有遠程庫的時候,如何關聯遠程庫。
現在,假設我們從零開發,那麽最好的方式是先創建遠程庫,然後,從遠程庫克隆。
首先,登陸GitHub,創建一個新的倉庫,名字叫gitskills
:
我們勾選Initialize this repository with a README
,這樣GitHub會自動為我們創建一個README.md
文件。創建完畢後,可以看到README.md
文件:
現在,遠程庫已經準備好了,下一步是用命令git clone
克隆一個本地庫:
``` $ git clone [email protected]:michaelliao/gitskills.git Cloning into ‘gitskills‘... remote: Counting objects: 3, done. remote: Total 3 (delta 0), reused 0 (delta 0) Receiving objects: 100% (3/3), done.
$ cd gitskills $ ls README.md
```
註意把Git庫的地址換成你自己的,然後進入gitskills
目錄看看,已經有README.md
文件了。
如果有多個人協作開發,那麽每個人各自從遠程克隆一份就可以了。
你也許還註意到,GitHub給出的地址不止一個,還可以用https://github.com/michaelliao/gitskills.git
這樣的地址。實際上,Git支持多種協議,默認的git://
使用ssh,但也可以使用https
等其他協議。
使用https
除了速度慢以外,還有個最大的麻煩是每次推送都必須輸入口令,但是在某些只開放http端口的公司內部就無法使用ssh
協議而只能用https
。
2.1 小結
要克隆一個倉庫,首先必須知道倉庫的地址,然後使用git clone
命令克隆。
Git支持多種協議,包括https
,但通過ssh
支持的原生git
協議速度最快。
3 多人協作
當你從遠程倉庫克隆時,實際上Git自動把本地的master
分支和遠程的master
分支對應起來了,並且,遠程倉庫的默認名稱是origin
。
要查看遠程庫的信息,用git remote
:
``` $ git remote origin
```
或者,用git remote -v
顯示更詳細的信息:
``` $ git remote -v origin [email protected]:michaelliao/learngit.git (fetch) origin [email protected]:michaelliao/learngit.git (push)
```
上面顯示了可以抓取和推送的origin
的地址。如果沒有推送權限,就看不到push的地址。
3.1 推送分支
推送分支,就是把該分支上的所有本地提交推送到遠程庫。推送時,要指定本地分支,這樣,Git就會把該分支推送到遠程庫對應的遠程分支上:
``` $ git push origin master
```
如果要推送其他分支,比如dev
,就改成:
``` $ git push origin dev
```
但是,並不是一定要把本地分支往遠程推送,那麽,哪些分支需要推送,哪些不需要呢?
master
分支是主分支,因此要時刻與遠程同步;dev
分支是開發分支,團隊所有成員都需要在上面工作,所以也需要與遠程同步;- bug分支只用於在本地修復bug,就沒必要推到遠程了,除非老板要看看你每周到底修復了幾個bug;
- feature分支是否推到遠程,取決於你是否和你的小夥伴合作在上面開發。
總之,就是在Git中,分支完全可以在本地自己藏著玩,是否推送,視你的心情而定!
3.2 抓取分支
多人協作時,大家都會往master
和dev
分支上推送各自的修改。
現在,模擬一個你的小夥伴,可以在另一臺電腦(註意要把SSH Key添加到GitHub)或者同一臺電腦的另一個目錄下克隆:
``` $ git clone [email protected]:michaelliao/learngit.git Cloning into ‘learngit‘... remote: Counting objects: 46, done. remote: Compressing objects: 100% (26/26), done. remote: Total 46 (delta 16), reused 45 (delta 15) Receiving objects: 100% (46/46), 15.69 KiB | 6 KiB/s, done. Resolving deltas: 100% (16/16), done.
```
當你的小夥伴從遠程庫clone時,默認情況下,你的小夥伴只能看到本地的master
分支。不信可以用git branch
命令看看:
``` $ git branch * master
```
現在,你的小夥伴要在dev
分支上開發,就必須創建遠程origin
的dev
分支到本地,於是他用這個命令創建本地dev
分支:
``` $ git checkout -b dev origin/dev
```
現在,他就可以在dev
上繼續修改,然後,時不時地把dev
分支push
到遠程:
``` $ git commit -m "add /usr/bin/env" [dev 291bea8] add /usr/bin/env 1 file changed, 1 insertion(+) $ git push origin dev Counting objects: 5, done. Delta compression using up to 4 threads. Compressing objects: 100% (2/2), done. Writing objects: 100% (3/3), 349 bytes, done. Total 3 (delta 0), reused 0 (delta 0) To [email protected]:michaelliao/learngit.git fc38031..291bea8 dev -> dev
```
你的小夥伴已經向origin/dev
分支推送了他的提交,而碰巧你也對同樣的文件作了修改,並試圖推送:
``` $ git add hello.py $ git commit -m "add coding: utf-8" [dev bd6ae48] add coding: utf-8 1 file changed, 1 insertion(+) $ git push origin dev To [email protected]:michaelliao/learngit.git ! [rejected] dev -> dev (non-fast-forward) error: failed to push some refs to [email protected]:michaelliao/learngit.git‘ hint: Updates were rejected because the tip of your current branch is behind hint: its remote counterpart. Merge the remote changes (e.g. ‘git pull‘) hint: before pushing again. hint: See the ‘Note about fast-forwards‘ in ‘git push --help‘ for details.
```
推送失敗,因為你的小夥伴的最新提交和你試圖推送的提交有沖突,解決辦法也很簡單,Git已經提示我們,先用git pull
把最新的提交從origin/dev
抓下來,然後,在本地合並,解決沖突,再推送:
``` $ git pull remote: Counting objects: 5, done. remote: Compressing objects: 100% (2/2), done. remote: Total 3 (delta 0), reused 3 (delta 0) Unpacking objects: 100% (3/3), done. From github.com:michaelliao/learngit fc38031..291bea8 dev -> origin/dev There is no tracking information for the current branch. Please specify which branch you want to merge with. See git-pull(1) for details
git pull <remote> <branch>
If you wish to set tracking information for this branch you can do so with:
git branch --set-upstream dev origin/<branch>
```
git pull
也失敗了,原因是沒有指定本地dev
分支與遠程origin/dev
分支的鏈接,根據提示,設置dev
和origin/dev
的鏈接:
``` $ git branch --set-upstream dev origin/dev Branch dev set up to track remote branch dev from origin.
```
再pull:
``` $ git pull Auto-merging hello.py CONFLICT (content): Merge conflict in hello.py Automatic merge failed; fix conflicts and then commit the result.
```
這回git pull
成功,但是合並有沖突,需要手動解決,解決的方法和分支管理中的解決沖突完全一樣。解決後,提交,再push:
``` $ git commit -m "merge & fix hello.py" [dev adca45d] merge & fix hello.py $ git push origin dev Counting objects: 10, done. Delta compression using up to 4 threads. Compressing objects: 100% (5/5), done. Writing objects: 100% (6/6), 747 bytes, done. Total 6 (delta 0), reused 0 (delta 0) To [email protected]:michaelliao/learngit.git 291bea8..adca45d dev -> dev
```
因此,多人協作的工作模式通常是這樣:
- 首先,可以試圖用
git push origin branch-name
推送自己的修改; - 如果推送失敗,則因為遠程分支比你的本地更新,需要先用
git pull
試圖合並; - 如果合並有沖突,則解決沖突,並在本地提交;
- 沒有沖突或者解決掉沖突後,再用
git push origin branch-name
推送就能成功!
如果git pull
提示“no tracking information”,則說明本地分支和遠程分支的鏈接關系沒有創建,用命令git branch --set-upstream branch-name origin/branch-name
。
這就是多人協作的工作模式,一旦熟悉了,就非常簡單。
3.3 小結
- 查看遠程庫信息,使用
git remote -v
; - 本地新建的分支如果不推送到遠程,對其他人就是不可見的;
- 從本地推送分支,使用
git push origin branch-name
,如果推送失敗,先用git pull
抓取遠程的新提交; - 在本地創建和遠程分支對應的分支,使用
git checkout -b branch-name origin/branch-name
,本地和遠程分支的名稱最好一致; - 建立本地分支和遠程分支的關聯,使用
git branch --set-upstream branch-name origin/branch-name
; - 從遠程抓取分支,使用
git pull
,如果有沖突,要先處理沖突。
參考資料:廖雪峰的官方網站
git遠程倉庫