安裝與設定 git

前言

使用 Ubuntu 22.04 時
要從公司的 GitLab 取得工作上的專案，
或從自己的 GitHub 取得 Side Project 專案做後續部署，
由於不像 Windows 或 Mac 等環境有很多 GUI 工具可以爽用，
故把整個步驟筆記下來。

GUI介面還是我這種懶人最愛ㄉ

下載安裝

指令安裝

為了能在 Ubuntu 22.04 使用版本控制，
我們需要先在作業系統上安裝 git，
才能把遠端存放庫的程式複製下來。

參考官網

sudo apt-get install git

sudo add-apt-repository ppa:git-core/ppa
sudo apt update;
sudo apt install git

設定識別資料

git config --global user.name "<userName>"
git config --global user.email "<e-mail>"

未來只要送交程式，
就會用優先使用預設的名稱與信箱，
但個別專案仍然可以個別設定。

在 Linux 系統中，設定檔案通常會在 ~/.gitconfig
在 Windows 系統中，設定檔案通常會在 C:\Users\$USER\.gitconfig

使用 SSH 金鑰

由於 GitHub 已經禁用一般帳號密碼的驗證方式，
必須改以權杖（Token）身分驗證或 SSH 金鑰，

GitHub 的 Git 操作將無法再採用密碼認證，

金鑰設定

參考文件 SSH 金鑰建立與設定

填寫 SSH config 檔

可參考以下範例格式，對於之後用 SSH 連線比較方便。
例如使用 VSCode 的遠端連線工具就會自動取用裡面的設定。

在 Windows 系統中，設定檔案通常會在 C:\Users\$USER\.ssh\config 。

# 命名連線名稱
Host gitlab.com # 要輸入連結的網站網址或IP位址
	HostName gitlab.com # 要輸入連結的網站網址或IP位址
	Port 2222  # 指定埠口
	User pamis1116@gmail.com # 使用者名稱 mail 或 登入 ID
	PreferredAuthentications publickey # 強制使用公鑰驗證
	IdentityFile ~/.ssh/id_rsa_gitlab # SSH key的位置

Host github.com # 要輸入連結的網站網址或IP位址
	HostName github.com # 要輸入連結的網站網址或IP位址
	User pamis1116@gmail.com # 使用者名稱 mail 或 登入 ID
	PreferredAuthentications publickey # 強制使用公鑰驗證
	IdentityFile ~/.ssh/id_rsa_github # SSH key的位置

在 GitLab / GitHub 上設定

點選右上角的選單，選擇「Settings」，左邊選單選擇「SSH key」，
把剛剛複製的 SSH key 公鑰貼上與填寫自訂名稱即可。

SSH Key 金鑰測試

測試是否設定成功 & 設定 SSH agent

ssh -T git@github.com
ssh -T ssh://git@gitlab.xxx.org.tw

建立專案

複製專案

git clone ssh://git@gitlab.xxx.org.tw/pamis/demo.git

使用 PuTTY 到虛擬機 下更新指令

cd ~/project
git pull

常見問題

Git SSL 連線憑證錯誤

如果 git repo 有憑證問題可設定不驗證 SSL

git config --global http.sslVerify false

參考資料

替 github, gitlab 設定不同 SSH key
SSH keys 或 HTTPS 設定步驟
git 官方文件