Git – 記下來

Git GUI – (4) fetch、merge、pull、解決衝突情況(conflict)

黃小蛙 — Mon, 18 Mar 2013 10:23:10 +0000

接續上篇文章 Git GUI – (3) branch、conflict、merge。

【六、取得最新檔案(fetch, merge, pull)】

在開發程式的時候，可能在同一時間有許多工程師做修改的動作，剛開始可以先用 fetch 指令來查看看遠端倉儲中是否有較新的檔案。如果有最新檔案，可以使用合併(merge)來將檔案合併到目前本地倉儲。fetch 跟 pull 的功能非常類似，fetch 負責檢查遠端倉儲中是否有更新版本的檔案，接著讓工程師手動合併檔案；而 pull 則是先呼叫 fetch 檢查有無新版本後，由系統自動做合併動作，也就是 pull = fetch + merge。遇到無法解決的衝突(conflict)才需要透過手動處理。

開始改動檔案前先檢查是否有檔案版本是否有更新。滑鼠右鍵 -> TortoiseGit -> Fetch

「64f1f65..7c8a8af master -> origin/master」表示有檔案更新(如上圖)，並且已經將檔案儲存在暫存區。下圖[up to date]則是表示目前本地倉儲中的檔案已經是最新版本(與遠端倉儲一致)。

(此步驟目的在檢查版本差異，可跳過直接進入第5點合併差異)如果沒有版本更新就可以不用理會，若有版本更新要處理，可透過滑鼠右鍵「TortoiseGit」選單，接著點選「Diff with previous version」來查看有哪些內容的變更。

點選「RefBrowse」設定要比較的來源檔案，將 Version 1 設定成遠端倉儲分支，Version 2 設定成本地倉儲分支。

設定完 Ref 後，如下圖，下方的框框會顯示這兩個版本有哪些變動。(修改了README.txt，以及多了一個 newFile.txt 檔案。在檔案上點選滑鼠左鍵兩下，可以看到兩個版本的檔案內容比較。

開始進行合併動作，滑鼠右鍵「TortoiseGit」選單 ->「Merge…」，選擇要合併的分支，並填寫 Merge Message。如果沒有發生衝突，合併完成後會出現 Success 字樣。

接著我們嘗試使用 pull 來更新並合併版本庫。滑鼠右鍵「TortoiseGit」選單 -> 「Pull…」。選取遠端要 pull 的倉儲分支，出現 Success 的字樣表示成功合併。

【七、衝突情況】

衝突是使用版本控制經常遇到的情況，以下將介紹衝突處理方式。

如下圖，當 push 檔案回遠端倉儲時，出現以下錯誤訊息。

當 push 發生衝突時，可以透過 (1) fetch+merge 或 (2) pull 來解決。以下只說明使用 fetch + merge 處理方式( pull 操作較為簡單，可自行練習使用)。

滑鼠右鍵「TortoiseGit」選單 -> 「Fetch…」

從遠端倉儲抓了較新的資料，接著我們把他和我們的版本合併在一起。滑鼠右鍵「TortoiseGit」選單 -> 「Merge…」。From的部份要選擇遠端的分支，例如：remotes/origin/master，填入Merge Message。

系統自動執行合併時發現有衝突，導致無法自動合併。關閉視窗後，可以看到衝突的檔案變成黃色三角形驚嘆號。

在 newFile.txt 上點選滑鼠右鍵開啟「TortoiseGit」選單 -> 「Diff」，即可開始編輯有衝突的部份(符號說明)，修改完成後儲存檔案。

接著把剛剛做的變更 commit 到本地倉儲中。

將本地倉儲的變更 push 到遠端倉儲，以上為衝突發生時的處理流程。

本文完。有很多情況下沒辦法使用 GUI 介面，可到參考資料1, 參考資料2, 參考資料3，這三篇文章涵蓋了幾乎所有新手會遇到的問題！

參考資料

Git 教學(1) : Git 的基本使用 @ 好麻煩部落格http://gogojimmy.net/2012/01/17/how-to-use-git-1-git-basic/
Git 教學(2)：Git Branch 的操作與基本工作流程 @ 好麻煩部落格http://blog.gogojimmy.net/2012/01/21/how-to-use-git-2-basic-usage-and-worflow/
Git 情境劇 @ 好麻煩部落格http://blog.gogojimmy.net/2012/02/29/git-scenario/

Git 系列文章：

這篇文章 Git GUI – (4) fetch、merge、pull、解決衝突情況(conflict) 最早出現於記下來。

Git GUI – (3) branch、conflict、merge

黃小蛙 — Mon, 18 Mar 2013 10:22:03 +0000

接續上篇文章 Git GUI – (2) 設定、Clone、Add、Modify。

【四、建立分支(branch)】

如果有新功能要開發或是既有功能修改，但又不想影響到主要程式(master)的運作，這時候可以透過建立分支(branch)，所有的修改動作都在「分支」中進行，各個分支是獨立作業的。比如要開發某個大功能，大功能中又切分很多細小的功能，我們可以在主線分支(master)下建立一個大功能分支，接著在大功能分支下，又切出許多細小功能的分支，也可以在分支的下面建立更細的分支，形成多重架構。當分支開發、測試結束後，再透過合併(merge)的動作，將所有分支合併回主線分支(master)，或透過重造(rebase)的動作，將目前開發的分支(branch)提升為主線分支(master)。

在E:\GitDaal\下點選滑鼠右鍵，接著選取「Create Branch…」。

輸入分支名稱，例如：newBranch。如果是要建立其它分支下的分支，Base On 的部份選擇 Branch 的選項，再選擇要基於哪個分支下建立新分支，這邊由於我們是基於主線分支(master)建立分支，因此選擇「HEAD (master)」。將「Switch to new branch」打勾，當分支建立完成後，會將目前的環境切換到新建立的分支下。

在新分支中編輯的東西，並不會影響到主線分支(master)，當編輯到一段落，將新分支中的東西 commit 到本地倉儲(commit 請參考三、修改(新增)檔案)。點選滑鼠右鍵，選擇「Git Branch」->「master」可快速切換至 master。master 看見的 README.txt 與 newBranch 看見的 README.txt 是不一樣的。

如果不知道自己現在身處於哪個分支，只要點選滑鼠右鍵，就可以在上方紅色框框看到目前所在分支。「Git Branch」子選單下有打勾的就是目前分支。以及「Git Commit -> “newBranch”」也可以看到現在是在 newBranch 分支下。

【五、合併分支 (merge) 並解決衝突 (conflict)】

當新的分支開發到一個段落時，Git 可以提供我們合併(merge)的功能，意即將目前分支(newBranch)開發的結果合併到主線分支(master)。

滑鼠右鍵選單->「TortoiseGit」->「Merge」

Branch 部份選擇要被合併的分支，我們要把 newBranch 合併回 master，因此選擇 newBranch。

若出現 Success 的字樣表示合併完成，沒有出現衝突的情況。此時視情況是否保留該 branch (可以理解成分支開發的子功能已經「加入」主線分支，該支線是否繼續保留開發功能或功成身退)。

如果合併時產生衝突(Conflict)的錯誤訊息，表示必須使用手動的方式來處理衝突。衝突的檔案會出現黃色三角形驚嘆號的圖樣。

在衝突的檔案上，開啟滑鼠右鍵 TortoiseGit 選單中的「Diff」。左邊是倉儲中上一個版本的檔案內容，只有五行內容，右邊則分為兩部分，從「<<<<<<< HEAD」到「=======」，表示最新版本中的內容，有六行內容，而「=======」到「>>>>>>> newBranch」是要合併的分支中的內容。此處視情況修改檔案內容，並把「<<<<<<< HEAD」「=======」「>>>>>>> newBranch」符號拿掉後存檔即完成修改。

修改完將檔案 commit 回本地倉儲。

接著選取滑鼠右鍵選單中的「Git History」，如下圖，上方為目前Git的分支狀況，修改者以及修改時間…等，下方為修改內容以及註解…等等資訊。

下一篇文章：Git GUI – (4) fetch、merge、pull、解決衝突情況(conflict)

參考資料

Git 教學(1) : Git 的基本使用 @ 好麻煩部落格http://gogojimmy.net/2012/01/17/how-to-use-git-1-git-basic/
Git 教學(2)：Git Branch 的操作與基本工作流程 @ 好麻煩部落格http://blog.gogojimmy.net/2012/01/21/how-to-use-git-2-basic-usage-and-worflow/
Git 情境劇 @ 好麻煩部落格http://blog.gogojimmy.net/2012/02/29/git-scenario/

Git 系列文章：

這篇文章 Git GUI – (3) branch、conflict、merge 最早出現於記下來。

Git GUI – (2) 設定、Clone、Add、Modify

黃小蛙 — Mon, 18 Mar 2013 10:21:24 +0000

依照上一篇文章 Git GUI – (1) TortoiseGit, msysgit 安裝 安裝好 Git 工具後，這篇大概記錄一下怎麼處理 Clone, Add, Modify … 等操作。

安裝完 TortoiseGit 及 msysgit 之後，即可開始使用 TortoiseGit 來管理專案，本範例主要描述如何使用 TortoiseGit 來管理既有專案，包括從遠端倉儲複製資料(clone)，操作本地倉儲(add, commit)，操作遠端倉儲(push)以及處理衝突(conflict)。

【一、基本設定】

在本機電腦上新增一個資料夾，例如：E:\GitDaal\，進入該資料夾，點選滑鼠右鍵，選取 TortoiseGit -> Settings。

輸入個人資料(Config)，名稱及電子郵件。

設定遠端伺服器(Remote)，Remote name可以隨便輸入，輸入您的 git Url 後點選 Add New，設定完成後按確定關閉設定視窗。

【二、從遠端倉儲複製檔案 (Git Clone)】

進入剛剛新增的 E:\GitDaal\ 資料夾，點選滑鼠右鍵選取「Git Clone…」。

填入您的 Git URL，按下 OK 開始複製遠端倉儲的目錄及檔案。

看到 Success 表示目錄及檔案複製成功。

可看到 E:\GitDaal\ 資料夾及以下所有資料夾都有綠色圓圈的勾勾，表示所有檔案都複製完成，綠色表示目前工作目錄的檔案與本地倉儲的檔案一致。

【三、修改(新增)檔案】

下圖為 Git 工作流程，本範例中的 E:\GitDaal\ 即為工作目錄(working directory)，經過編輯的檔案必須先透過存放進暫存區(staging area)後才可以成功儲存至本地倉儲(local repository)，也只有在本地倉儲中的檔案及資料，才可以透過推送(push)的方式分享到遠端倉儲(remote repository)。

用文字編輯器開啟剛剛透過 Git Clone 複製下來的 README.txt，修改完後存檔關閉檔案。(E:\GitDaal\README.txt)例如增加文字 ” Git test by Hans”。

可以看到從原本的勾勾變成紅色圈圈驚嘆號，表示目前「工作目錄中」的檔案已經和「本地倉儲中」的檔案不一致了。

TortoiseGit 簡化了上圖中 git add 指令，因此透過 TortoiseGit 可以直接做 commit 到本地倉儲的動作。點選滑鼠右鍵，選擇 Git Commit -> “master”

開啟 Commit 介面，Message 部份填入這次 Commit 的資訊，TortoiseGit 會將工作目錄中所有被修改過的檔案列在下方的列表中，這邊我們只更動了 README.txt 檔案，打勾表示同意將該檔案 commit 至本地倉儲。

出現 Success 表示檔案已成功 commit 到本地倉儲。TortoiseGit 為了讓使用者更方便，提供了左下角的 Push 按鈕，使用者可直接將檔案 push 到遠端倉儲，如果不想在此時 push，按下滑鼠右鍵的 TortoiseGit 選單中也有 push 的指令可選擇。

如果要增加新的遠端倉儲，可以點選「Manage」新增。點選 OK 之後如果出現 Success 字樣表示這次的 push 完成。

如果沒有出現 Success 可能是發生了衝突(conflict)，請參考 Git GUI – (4) fetch、merge、pull、解決衝突情況(conflict)。

下一篇文章：Git GUI – (3) branch、conflict、merge

Git 系列文章：

參考資料

Git 教學(1) : Git 的基本使用 @ 好麻煩部落格http://gogojimmy.net/2012/01/17/how-to-use-git-1-git-basic/
Git 教學(2)：Git Branch 的操作與基本工作流程 @ 好麻煩部落格http://blog.gogojimmy.net/2012/01/21/how-to-use-git-2-basic-usage-and-worflow/
Git 情境劇 @ 好麻煩部落格http://blog.gogojimmy.net/2012/02/29/git-scenario/

這篇文章 Git GUI – (2) 設定、Clone、Add、Modify 最早出現於記下來。

Git GUI – (1) TortoiseGit, msysgit 安裝

黃小蛙 — Mon, 18 Mar 2013 10:20:10 +0000

Git 是一個分散式版本控管的好工具(維基百科的 Git 介紹)，這邊從簡單、有圖形化界面的開始吧！注意：小蛙也還是 Git 新手，很多指令都要去查，這系列文章在實際做法上可能會有所出入！如果發現有問題，可以在文章下面留言，感恩喔！

【安裝TortoiseGit】

TortoiseGit 這個工具是由著名的 Tortoise 所開發，讓使用者在 Windwos 環境下可透過圖形化的操作方式，簡化了以往操作 Git 需透過命令列下指令的麻煩。

下載 TortoiseGit-1.5.8.0-32bit.msi，下載位址。(http://download.tortoisegit.org/tgit/)

開始安裝，預設安裝即可，安裝完重新啟動電腦。

安裝完 TortoiseGit 重新開機。

【安裝msysgit】

下載 Git-1.7.3.1-preview20101002.exe，下載位址。(http://msysgit.github.io/)

開始安裝 Git。

SSH 工具的選擇，請選擇「Use (Tortoise)Plink」的選項，並且將路徑指定到剛剛安裝的 TortoiseGit\ 目錄下的TortoisePlink.exe。

安裝完成後重新啟動電腦。

下一篇：Git GUI – (2) 設定、Clone、Add、Modify

Git 系列文章：

參考資料

Git @ 維基百科http://zh.wikipedia.org/wiki/Git
tortoisegit @ Google Project Hostinghttps://code.google.com/p/tortoisegit/downloads/list
msysgit @ Google Project Hostinghttps://code.google.com/p/msysgit/downloads/list?can=3
Git 教學(1) : Git 的基本使用 @ 好麻煩部落格http://gogojimmy.net/2012/01/17/how-to-use-git-1-git-basic/
Git 教學(2)：Git Branch 的操作與基本工作流程 @ 好麻煩部落格http://blog.gogojimmy.net/2012/01/21/how-to-use-git-2-basic-usage-and-worflow/
Git 情境劇 @ 好麻煩部落格http://blog.gogojimmy.net/2012/02/29/git-scenario/

這篇文章 Git GUI – (1) TortoiseGit, msysgit 安裝最早出現於記下來。

[參考文章] 使用 Git 做為網站開發版本控管工具

黃小蛙 — Wed, 02 Jan 2013 09:20:24 +0000

小蛙最近在找一個 website 開發上的解決方案，發現下面這篇文章可以符合小蛙的要求，本文主用小蛙自己的理解”記錄”下來。【A web-focused Git workflow @ joe maller.com 】

使用 Git 做為版本控管非常好用，網路上有很多 Git 教學文：
【Git and Github 演講投影片(2011) @ ihower { blogging }】
【Git 教學(1) : Git 的基本使用 @ 好麻煩部落格】
【Git 初學筆記 – 指令操作教學 @ Tsung’s Blog】

這篇文章參考自【A web-focused Git workflow @ joe maller.com 】，以下文章指令輸入的部份源自於原始網頁，說明的部分是小蛙破英文翻過來的(只挑部份，沒有逐字翻)，連結到原始作者網頁可看到更多資訊。

這邊原作者把架構拉開分成 3 種身份(點回作者網站可以看到架構圖)：Clones(副本)、Hub(匯整)、Prime(網站)。

大致上的流程為：所有開發者從 Hub clone 一份下來開發，最後 push 回 Hub，再由 Hub 中的 hook 進入 Prime 的目錄下執行 pull，當 Prime 有 commit 動作時，也透過 hook 將變動 push 到 Hub 以維持兩個 repository 的一致性。

Hub: bare repository，其他開發者只能從這邊 clone 資料。

Prime: standard repository，網站的目錄。

安裝並設定 Git

git config --global user.name "Joe, working on the server"

在網站目錄下初始化一個新的 Git repository (Prime)

cd ~/www
git init
git add .
git commit -m"initial import of pre-existing web files"

在網站目錄之外的地方建立一個 bare repository (Hub)

cd; mkdir site_hub.git; cd site_hub.git
git --bare init
Initialized empty Git repository in /home/joe/site_hub.git

從 Prime 目錄下，把 Hub 加入到 remote 中，並且把 Prime 上的 master push 到 Hub 上

cd ~/www
git remote add hub ~/site_hub.git
git remote show hub
* remote hub
  URL: /home/joe/site_hub.git
git push hub master

為了讓 hub 跟 prime 緊密連接在一起，且不影響到工作目錄結構，這邊作者在 Hub repository 上設定 post-update (參考資料2)，當 Hub 接收到更新(git push)時，便會切換到網站目錄(prime)下的 repository 執行 git pull 的動作

#!/bin/sh
echo
echo "**** Pulling changes into Prime [Hub's post-update hook]"
echo
cd $HOME/www || exit
unset GIT_DIR
git pull hub master
exec git-update-server-info

在 Prime repository 中加入 post-commit (參考資料2)，為了維持 hub 跟 prime 雙向一致，如果真的 Prime 被手動修改了，也可以立即將這個變動發送到 Hub 上，讓 Hub 知道這些變動，避免 conflict

#!/bin/sh
echo
echo "**** pushing changes to Hub [Prime's post-commit hook]"
echo
git push hub

有一些情況下 Prime 跟 Hub 會發生不一致的情況，作者提到如果衝突發生時，最好的做法是先把目前發生問題的 Prime 的狀態 push 到 Hub 的 “fixme” 分支，如此一來其他的 clones 就可以把有問題的分支 pull 下來，處理完成後再 merge，以免因為 Git 的衝突標示使得網站無法正常運作

git push hub master:refs/heads/fixme

由於 Prime 的 .git 資料夾在網站的根目錄可能會有安全性的問題，使用 Apache 的話可以透過以下方式禁止 .git 被存取

# deny access to the top-level git repository:
RewriteEngine On
RewriteRule \.git - [F,L]

如果看到以下錯誤，就把 export PATH=${PATH}:~/bin 加入到 Server 上的 .bashrc 中。

git-receive-pack: command not found
fatal: The remote end hung up unexpectedly

參考資料

A web-focused Git workflow @ joe maller.com
http://joemaller.com/990/a-web-focused-git-workflow/
Git Hooks @ Git Book 中文版
http://gitbook.liuhui998.com/5_8.html
Git @ 維基百科，自由的百科全書
http://zh.wikipedia.org/wiki/Git
Git and Github 演講投影片(2011) @ ihower { blogging }
http://ihower.tw/blog/archives/5391/
Git 教學(1) : Git 的基本使用 @ 好麻煩部落格
http://gogojimmy.net/2012/01/17/how-to-use-git-1-git-basic/
Git 初學筆記 – 指令操作教學 @ Tsung’s Blog
http://blog.longwin.com.tw/2009/05/git-learn-initial-command-2009/

Git 系列文章：

這篇文章 [參考文章] 使用 Git 做為網站開發版本控管工具最早出現於記下來。