Git 使用 - 遠端

OverView of Content

參考該文章，並實做，並依序 Git 使用 - 基礎

Git 使用 - 遠端

分支 - branch

一直以來我們都是在一個叫 master 的分之上提交 Patch，以下我們新增一個檔案並且重新建立 Git，它就會提示我們目前在 master 上

初始化 Git init 時，分支 master 也會被創建出來
```
git init

git status
```
分支的功能在於，任何的 Patch 都可以有自己的分支，我們可以新增刪除分支，並且平行開發不會相互引響，分支修正完成後還可以合併回 master 主分支，想要簡單測試時也可以迅速分支出來，以下是 commit tree 的概念圖

查看分支 - branch

指令式、UI 圖形界面查詢兩種
1. 指令式
```
# 查看目前分支

git branch
```
  可以看到目前分支在 master 上
2. Gitk 圖形 UI 圖形界面
  
  Gitk 是內建於 git 的圖形化界面工具，有一些版本當安裝好 git 時它就存在了，而也一些需要使用指令另外安裝
```
# 安裝 gitk 指令
sudo apt install -y gitk

# 背景執行 gitk
gitk --all &
```
  當你提交新的 Patch 時 Gitk 並不會自己更新，必須要使 F5 刷新界面

建立/切換/刪除分支

指令	功能
git branch	查看所有的分支
git branch <new branch name>	建立新的分支
git checkout <branch name>	切換分支
git checkout -b <new branch name>	建立＆切換分支，將兩個動作和為一個指令 (滿好用的)
git checkout -b <new branch name> <commit_id>	功能同上，但是可以另外指定 Patch id，在該 Patch 上建立 (滿好用的)
git branch -f <branch name> <commit_id>	f 是 force 強制的意思，在指定的 patch 上建立 branch，若該 branch 以存在則切換過去（轉換 branch）
git branch -D <branch name>	刪除指定分支，不能在要刪除的分支上

git branch <new branch name> 建立新的分支





# 建立新分支，取名為 bugFix
git branch bugFix

# 查詢全部分支
git branch

git checkout <branch name> 切換分支
```
# 切換分支
git checkout fixBug
```
使用 Shift + F5 刷新 Gitk 界面，會發現 bugFix 變粗體字（有點不明顯）

在新的分支，提交新的 Patch










git status

# 新增檔案
git add myDebug.d

# 新分支上提交新 Patch
git commit -m "add File of myDebug.d"

# 查看 log
git log --oneline

在 log 中可以看到 HEAD 已經移動到 bugFix，Gitk 字體轉為粗體並且 目前所在的分支節點會呈現黃色點

在 fixBug 再次提交新的 Patch，最後移動回 master 分支上並做提交









# fixBug 分支上提交，使用分號 `;` 連續做多種不同的動作
touch boy.txt; git add boy.txt; git commit -m "add boy.txt File"

# 移動分支到 master 上
git checkout master

# 創建、新增並提交新的 Patch 在 master 中
touch eye.txt; git add eye.txt; git commit -m "add eye.txt File"
touch nose.txt; git add nose.txt; git commit -m "add nose.txt File"

這樣就可以從 gitk 中看出分支的差異

git checkout -b <branch name>，創建分之並切換








# 查看所有的分支
git branch

# 新增分支並切換
git checkout -b feature

# 查看結果
git branch

git branch -f <branch name> <commit_id>，在指定 Patch　上新增分支








# 在 `add Alien in num.txt` 上建立新的分支，該分支上的 id 為 29d7d18
git branch -f tmp 29d7d18

# 查看指定分支上的 log （查看 tmp 分支上的 log 訊息）
git log tmp --oneline

# 移動 tmp 分支到 `add Pan in num.txt`
git branch -f tmp 2acb117

git branch -D <branch name> 刪除分支


# 刪除 tmp 分支 
git branch -D tmp

Patch 的表示法

要先了解到 branch & HEAD 是可以分開的，我們可以單獨移動 HEAD or Branch

Patch 的表示法
1. commit ID (指定)
2. HEAD 代表目前所在的 Patch （以 HEAD 來相對比較出 Patch）
3. Branch Name (該 branch 最後的 Patch)
4. 在 HEAD or Branch Name 後面加上 ^ or ~n 來表示相對位置

指令	描述
git checkout <commit_id>	移動 HEAD 的位置

git checkout <commit_id> 移動 HEAD 位置；HEAD 代表目前所在 patch 的位置（點）

大部分 HEAD 都會和某個 branch 重疊在一起（像是 master 分支），但仍然可以單獨移動 HEAD 的
```
# 移動 HEAD
git checkout 29d7d18

# log 
git log --oneline

# 查看所有的 branch
git branch
```
原來的 branch 並未移動，並且會提醒目前 HEAD 所在的 Patch ID 在哪裡
- 之前使用 reset –hard <commit_id> 指令其實改變了 master 分支位置，使用 checkout <commit_id> 指令可以讓 HEAD 脫離 master 任意移動到其他 Patch 之上

使用 amend 修改目前 HEAD 的提交標題，在查分支＆ log 狀況








# 改變目前所在的 Patch 標題描述
git commit --amend -m "Fix By checkout, Add Alien in num.txt"

# 查看 branch
git branch

# log
git log --oneline

使用 amend 後多了一個新的 Patch ID (尚未有分支，下面步驟會在創建一個分支給這次的修改)

cherry-pick 一個 Patch 進來




# 使用 branch Name 作為相對位置，並移動到剛剛 amend 的檔案
git cherry-pick bugFix^

git log --oneline

使用 git checkout -b <new branch name> （建立＆切換分支，將兩個動作和為一個指令）
```
# 建立新分支

git checkout -b testCheckout
```

創建 branch 資料夾

前面有說到單獨創建 branch 分支，而我們可以針對 branch 開新的資料夾，並在該資料夾之下創建分支





# git branch <資料夾>/<分支名>
# 在 TEST 資料夾下創建 Hello 分支
git branch TEST/Hello

git branch -v

合併分支 cherry-pick、merge、rebase

合併分支有幾種方式

方式	描述
cherry-pick	一個一個移動，實際上來說它並不算是合併
rebase	充新定義分支的基準點，git rebase <主要分支> <將要被合併分支>，要特別注意是誰 rebase 誰
Merge	切換到要合併的分支，再使用 git merge <將要被合併分支>，會保有原本 branch 資訊

新增檔案到 bugFix 分支








# 切換分支到 bugFix
git checkout bugFix

# 新增檔案並提交
echo "Fix Finish" >> boy.txt ; git add -u; git commit -m "Fix Big Finish"

# log
git log --oneline

這是目前的分支

使用 cherry-pick 把 bugFix 分支中所有的 Patch 移動到 master 分支上








# 查看分支上所有的 ID
git log --oneline

# 切換回 master 分支
git checkout master

# 分別取出 cherry-pick，從舊的加到新的
git cherry-pick 8c46944 f872c4f 8972ed4

使用 cherry-pick 一個一個移動

使用 rebase 真正的合併分支到主分支（它會整理分支並合併，不會留下原本分支）

rebase 作為一個犧牲者～由它自己來決定要合併進去的分支，合併完後自己的分支就不復存在













# 移動 branch 到 bugFix 分支
git checkout bugFix

# 將 bugFix 分支合併到 master 之後
git rebase master

# 上面兩行可以改為一行，master 接續 bugFix
# git rebase master bugFix

git log --oneline

# 查看目前分支狀況
git branch

結果圖 1
結果圖 2 可以從 log 中看到 fixBug 全部移動到 master 之後了

也可以合併部份的 Patch 而不是整個分支




git checkout bugFix

# 把 bugFix 的所有 Patch 掛到 master 前一個節點的後面 
git rebase master^

遠端設定

以下將會使用 GitHub 作為範例，所以必須要先有 GitHub 帳號

GitHub 新增專案

新增專案
1. 按右上角的 +，選擇 New repository
2. 輸入 Repository name 也可以輸入一些描述
3. 這裡 先不要 勾選 "Initialize this repository with a README"
4. 點擊 Create repository 就會創建出一個新專案了
5. 創建出專案後可以看到它有兩種連線方式 SSH、Https 兩者是使用不同的加密協定，也可以看到下方有提示如何操作該倉庫的指令
- SSH、Https 兩種連線的差異在 Https 每一次連線都需要輸入一次 username、password，而 SSH 則不需要，以下示範 SSH 連線的方式

本地 SSH 設定

在 Ubuntu 中 ssh 通常會在用戶的主資料夾中 ~/.ssh （隱藏資料夾），在該資料夾下生成 rsa 非對稱加密的 key，rsa 是非對稱加密，會有兩把 key(公鑰、私鑰)，使用公鑰加密、私鑰解密
```
# 移動到 .ssh 資料夾 
cd ~/.ssh

# 生成 rsa 非對稱加密的兩把 key
ssh-keygen -t rsa
```
使用 man ssh-keygen 可以查看到如何生成 rsa key

生成 key 的過程中沒有特別設定就一直按 enter 就好，之後就會在該資料夾下生成公鑰、私鑰，如果之前生成 rsa key 過則會被覆蓋

遠端連線

在 GitHub 上設定公鑰，公鑰是每個人都可以取得的，但是單單有公鑰也無法解開通訊加密，所以可以公佈在 GitHub 上
Setting -> SSH and GPG keys -> New SSH key
使用 cat 查看剛剛生成的 id_rsa.pub 公鑰，私鑰不可以給別人，複製到 key 欄位並點擊 Add SSH key 儲存
測試 SSH 連線
```
ssh -T git@github.com
```
可用 man ssh 查看 T 的操作

第一次連線它會出現無法辨別主機真實性，輸入 yes 不用特別在意

遠端操作

設定 URL - remote

在上面新增專案後，底要有一個提示要如何使用指令 push 到倉庫中，其中就使用到了 remote

指令格式	功能
git remote add <name> <repo_url>	新增遠端 url 指令，並為此 url 取別名
git remote -v	看所有的 remote url
git remote rename <目標名稱> <新名稱>	修改之前取的名稱
git remote remove <目標名稱>	移除 url

新增 url，url 可以是本地的地址，也可以有多個 url





# 新增遠端 url 
git remote add helloGitHub git@github.com:kyle861550/Hello_GitHub.git

# 查看
git remote -v

修改名稱 rename





# 改 url 別名為 gitHub
git remote rename helloGitHub gitHub

# 查看
git remote -v

刪除 remove











# 新增一個本地 url
git remote add local ~/桌面/EnjoyGit/

# 查看
git remote -v

# 移除
git remote remove local

# 查看
git remote -v

上傳分支 - push

Git 在上傳程式碼到 server 時，必須是以分支為單位

指令格式	功能
git push <url 別名> <分支名稱>	上傳分支 (不須 checkout 到指定分支上傳)
git branch -a	-a 也就是 –all，可以查看所有的分支，包括遠端分支
git log <分支名稱>	可以透過 log 指令查看指定分支的 log(包括遠端)

上傳分支 git push <url 別名> <分支名稱>，指定我們剛剛建立的 url 別名，還有需要上傳的分支
```
# 上傳 master 分支 到 gitHub（url 別名） 倉庫
git push gitHub master

# 查看所有的分支
git branch -a

# 查看遠端 log
git log remotes/gitHub/master --oneline
```
查看分支實會看到遠端分支（紅色字），如果遠端沒有 master 這個分支時就會自己新增

網頁重整就可以看到 master 分支

在 gitk 這個 UI 界面也可以看到遠端分支，遠端分支的內容會與 server 上的內容一致

查看遠端分支 log
上傳分支 bugFix 分支（我刪除了舊的合併 bugFix 分支，並且建立新的 bugFix 分支，該分支建立在某個 Patch 上）
```
# 上傳 bugFix 分支
git push gitHub bugFix

# 查看所有的分支
git branch -a
```
上傳前後在 gitk 的比較

網站刷新後就會看到新的 branch

更新 master branch，先更新本地端的 master 分支（新增 Patch）














# 切換分支
git checkout master

# 查看分支
git branch

# 查看 master 分支 log
git log --oneline

# 修改 boy.txt 檔案並提交 Patch
echo "YoYo" >> boy.txt; git add -u; git commit -m "Update boy.txt File"

# 上傳更新 master 分支
git push gitHub master

前後對比上傳前後遠端的差異

追蹤遠端 - set-upstream

參數 -u 等同於 --set-upstream，設定 upstream 可以使分支開始追蹤遠端分支，使用 git status 時就會 Git 就會比較遠端＆本地的 commit 差異

只需要一次 git push -u <遠端分支名> <本地分支名> 成功後，之後只需要使用 git push 就可以直接上傳分支

指令	功能
git push -u <url\ 別名> <本地分支名>	上傳並設定分支 upstream
git branch -u <url\ 別名>/<遠端分支名>	設定遠端 upstream，使用 git status 會顯示追蹤的訊息
git branch –unset-upstream	取消追蹤遠端分支

git push -u <遠端分支名> <本地分支名>，遠端分支名可以使用 remote -v 查詢











# stream 設定 and 上傳
git push -u gitHub master

# 同上功能
git push --set-upstream gitHub master

# 切換到 master
git checkout master

# 上傳
git push

git branch -u <url 別名>/<遠端分支名>，設定遠端 upstream，git status 就會改變
```
git checkout master

# stream 設定到 gitHub/master 分支
git branch -u gitHub/master

git status
```
- git branch -u gitHub/master master 可以合併指令，這樣就不用切換到 master 分支去操作
- Your branch is up to date with 'gitHub/master' 代表本機端的 master 與遠端的內容分支一致

本地新增移除 Patch，讓遠端 master ＆本地 master 發生差異








git checkout master

# 本地新增 Patch
touch localPatch_1; git add .; git commit -m local_Patch_1

git status

git log --oneline

Your branch is ahead of 'gitHub/master' by 1 commit 代表目前本地分支領先遠端 gitHub/master 分支一個 Patch








git checkout master

# 退回前 3 Patch
git reset --hard HEAD~3

# git reset --hard HEAD~3 master 同上功能

git status

Your branch is behind 'gitHub/master' by 2 commits, and can be fast-forwarded. 代表本地分支落後遠端 gitHub/master 分支 2 個 Patch

git branch –unset-upstream








# git checkout master

# 取消分支追蹤
# git branch --unset-upstream

git branch --unset-upstream master

git status

下載/複製專案 - clone

在 github 上可以透過 clone 找到遠端 https or ssh 的下載連結

指令	功能
git clone <遠端 url/>	下載專案
git clone <遠端 url/> -b <branch name>	下載指定分支
git clone <遠端 URL> <folder name/path>	下載到指定位子
git clone <本地 project>	建立專案副本

下載遠端專案









mkdir clone

cd clone

# clone 遠端分支
git clone git@github.com:kyle861550/Hello_GitHub.git

# clone 下來的資料夾名稱就是 github 上的專案名稱
ls Hello_GitHub/

下載下來後查看所有的分支，會發現多了 HEAD 分支remotes/origin/HEAD -> origin/master ，remotes/origin/HEAD 是專案的預設分支，而後面指向的是預設分支 master

git remote 預設名稱為 origin (git remote rename 可以修改名稱)

同步遠端分支 - fetch/pull

當遠端已經被其他人更新時，會發生自己的 Patch 無法 push 上去，會產生衝突而導致 rejected (如下圖)

指令	功能
git fetch <remote name>/<remote branch name>	更新 "指定" 分支，fetch 後可以在 gitk 上看到遠端的更新
git fetch –all	更新所有的分支
git remote update	相當於 git fetch –all 的功能，它會更新所有分支
git pull <remote name ＆ bramch> <本地 branch name>	同步分支，預設使用 merge
git pull –rebase <remote name> <本地 branch name>	git 使用 rebase 來解決衝突

首先先在 remote 端，也就是 github 上手動添加一個 RemoteFile2 檔案

添加後的 GitHub 顯示

在本地添加一個檔案 three.txt，並提交一個 commit，最後一起推送


# 添加 ＆ 提交本地 Commit & 推送
touch four.txt; echo >> three.txt Hello Git 4; git add .; git commit -m "add four.txt file"; git push

因為更遠端不同步，所以產生衝突，被遠端拒絕（rejected）

執行 fetch：發生衝突後第一件事，是 fetch 遠端 Git
```
# fetch master 分支
git fetch origin master
```
使用 fetch 後，再用 gitk 就可以看到遠端的差異 (很丑不好看)

執行 pull：同步分支，將遠端資料與本地資料同步（這過程可能會稱圖）


#如果有設定 upstream 可以使用 git status 看到與遠端的差異
git status

本地 diverged(發散)，有一個不同的 Patch，並且它會提示要使用 pull 更新







# 如果沒有設定 upstream
# 要使用 git pull origin master master (遠端 master -> 本地 master)
git pull

# pull 指令如同以下指令
git fetch origin    # 更新
git merge remotes/origin/master    # 將當前分支合併到 遠端 master

由於發生版本衝突，必須手動解決 (默認使用 Merge)，以下由於沒有改動到相同文件，所以直接儲存退出

解決完稱衝突後

Gitk 差異，可以看到它會產生 Merge Path （又稱為 Merge History）

查看 log 可以看到 Merge branches 資訊（以下是 merge 本地端 master & remote 端 master）


git log --oneline

衝突也可以選用 rebase 解決

衝突使用 rebase 解決，它將本地 master 重新 rebase 到遠端之後




# git pull

#若是沒有使用 upstream 就必須設定 remote&branch
git pull --rebase origin master

執行 push：別忘了我們之前在本地鎖新增的 four.txt 這個 Patch，記得把它 push 出去
```
#若是沒有使用 upstream 就必須設定 remote&branch
# git push origin master master
git push
```
在 Git 上我們就可以看到 four.txt 這個檔案

Gitk 上也更新遠端到 master，同步完成 !

進階功能

追溯檔案 - blame

指令格式	功能
git blame <option> <指定檔案>	可以追溯指定檔案，該檔案中的更改紀錄 & 更改者








# 追溯 Git.txt 檔案紀錄
git blame Git.txt

# 行數(-n) + 原檔案名稱 (-f) 
git blame -n -f --color-lines first.txt 

# --color-lines 每行間格顏色
git blame -n -f --color-lines first.txt

緩存資料 - stash

緩存尚未 Commit 之前的所有資料，add 前、後的也可以，不包括未追總檔案，這個指令十分的方便，可以在任何時候存入，並放入你所需的檔案中（中途 checkout 放置到其他的 Patch 也可以）

指令格式	功能
git stash	儲存一個暫存資料，並回復為上一次 Patch 並未改動的狀態
git stash list	查看所有 stash
git stash apply <指定 stash or 不指定>	拉出 stash 套上目前的 Patch，並未刪除 stash
git stash pop 指定 stash or 不指定>	拉出 stash 套上目前的 Patch，並刪除 stash
git drop <刪除指定 stash>	刪除指定 stash 紀錄
git stash clear	清除所有 stash

添加新檔案 & 改動








# 添加
touch Git.txt;

# 改動
echo >> first.txt "test stash"

# 查看狀態
git status

儲存暫存檔案







# 儲存暫存
git stash

git status

# 查看 stash
git stash list

無法儲存未追蹤檔案（Untracked files）

套用 stash：以下使用 apply（不刪除 stash）








# 套用最新 stash(當然也可以指定)
git stash apply

# 功能同上
git status apply stash@{0}

# 查看狀態
git status

刪除 stash












# 查看 stash list
git stash list

# 刪除指定 stash
git stash drop stash@{1}

git stash list

# 刪除全部 stash
git stash clear

git stash list

標籤 - tag

在需要的地方添加標籤 tag，這個 tag 也可以使用 gradle 獲取，它的功能與 branch 很像，但是差異是在 branch 可以不斷更新，Tag 無法更新，通常使用在正式版的本的 master Patch 上

指令格式	功能
git tag	查看所有的 Tag
git tag <tag name> <commit id>	打標籤在指定 Patch 上
git tag -a -m <描述字句> <tag name> <commit id>	功能如上，但是添加了 Message 訊息在 tag 上
git tag -d <tag 名稱>	刪除指定 Tag
git push –tags	推送全部 Tag
git push <url 代稱> <Tag 名稱>	推送指定 Tag 至 GitHub

建立 tag








# 查看 log
git log --oneline

# 建立 tag
git tag First_Tag 6e37ebb

# 查看 tag
git tag

在 gitk 上面也可以看到新增了 tag

Message Tag




# 新 tag 加上 message_something 描述
git tag -a -m message_something Second_Tag 7eade50

git tag

刪除 tag




# 刪除 Second_Tag
git tag -d Second_Tag

git tag

推送 remote Tag





# 推送全部 tag
git push --tags

# 推送指定 tags
git push First_Tag

刪除 remote Tag，刪除遠端必須先刪除本地標籤





# 刪除本地標籤
git tag -d First_Tag

# 刪除遠端
git push origin :refs/tags/First_Tag

Ubuntu 本地倉庫

學習如何在本地創建一個 git 本地倉庫 (當前環境在 Ubuntu)

首先當然是要有 git 對應套件


sudo apt install git-core

建立本地倉庫

我們在 /opt 目錄下創建一個 git 目錄，再創建一個自己的目錄

opt 目錄 (Ubuntu目錄介紹)

默認為空目錄，給主機而外安裝軟體所擺放的目錄













# 移動到 opt 目錄
cd /opt

# 創建 git 資料夾
sudo mkdir git

cd git

# 創建 local_remote 資料夾
sudo mkdir local_remote

# --bare 就是共享
sudo git init --bare

為了讓遠端當檔案可以被寫入，有兩種方法 (則依即可)

將該目錄底下的資料夾內容全部改為可執行



# -R 是遞歸該目錄底下所有的檔案

sudo chmod +777 -R local_remote

改變該目錄所屬者





# 查看當前使用者
whoami

# 改變該資料夾擁有者
sudo chown -R alien local_remote

開啟 ssh 服務器

安裝 ssh 套件


sudo apt install openssl-server

創建本地 ssh key








cd ~

sudo mkdir .ssh

cd .ssh

# 產生 ssh public key (用來加密)
ssh-keygen

測試 ssh 服務是否開啟



# -e 是所有的進程
# grep 是字串過濾
ps -e | grep ssh

若 ssh 沒有啟動則使用指令啟動 ssh （也可以使用 systemdctl 來啟動服務）
```
# etc 目錄是應用的配置
sudo /etc/init.d/ssh start
```

測試 push 到本地

在本地做一個簡單的 git 提交















mkdir -p test

cd test/

# 初始化 git 倉庫
git init .

# 輸出一個 HelloWorld.txt 檔案
echo HelloWorld >> HelloWorld.txt

# 添加所有檔案
git add .

# 本地提交一個紀錄
git commit -m "feat: add test file of HelloWorld.txt"

添加遠端 remote 地址
- 本地 ip 預設是 127.0.0.1，若要查詢的話可以使用 ifconfig 指令
儲存本地網路對應的地址
```
git remote add origin ssh://127.0.0.1:/opt/git/local_remote/
```
push 本地 git 到自己建立的本地遠端；成功透過 ssh 上傳資料到本地倉庫
```
git push --set-upstream origin master
```

Git 使用 - 遠端

OverView of Content

分支 - branch

查看分支 - branch

建立/切換/刪除分支

Patch 的表示法

創建 branch 資料夾

合併分支 cherry-pick、merge、rebase

遠端設定

GitHub 新增專案

本地 SSH 設定

遠端連線

遠端操作

設定 URL - remote

上傳分支 - push

追蹤遠端 - set-upstream

下載/複製專案 - clone

同步遠端分支 - fetch/pull

進階功能

追溯檔案 - blame

緩存資料 - stash

標籤 - tag

Ubuntu 本地倉庫

建立本地倉庫

開啟 ssh 服務器

測試 push 到本地

Appendix & FAQ

tags: `Git`

Git 使用 - 遠端

OverView of Content

分支 - branch

查看分支 - branch

建立/切換/刪除分支

Patch 的表示法

創建 branch 資料夾

合併分支 cherry-pick、merge、rebase

遠端設定

GitHub 新增專案

本地 SSH 設定

遠端連線

遠端操作

設定 URL - remote

上傳分支 - push

追蹤遠端 - set-upstream

下載/複製專案 - clone

同步遠端分支 - fetch/pull

進階功能

追溯檔案 - blame

緩存資料 - stash

標籤 - tag

Ubuntu 本地倉庫

建立本地倉庫

開啟 ssh 服務器

測試 push 到本地

Appendix & FAQ

tags: Git

Read more

Linux 組成、層次概念

Kyle Resume EN

Kyle 履歷 Resume

Android View 事件分發 / 滑動衝突

tags: `Git`