在 ASUSTOR NAS 設定 Git Repository

課程目的

完成此課程後您將能夠：

1. 使用 ASUSTOR NAS 建置 Git Repository。

必修項目

課程必修項目：

無

學生須先具備以下知識：

Linux、Git

大綱

1. Git 簡介

1.1 在 ASUSTOR NAS 安裝 Git

2. 在 ASUSTOR NAS 建置 Git Repository

2.1 建立 Git 共用資料夾

2.2 設定 Git Repository

3. Git 客户端連接 NAS 上的 Git Repository

1. Git 簡介

Git 是一種免費開源的分散式版本的版本控制系統（Version Control Stystem）。記錄一個或若干個文件的狀態變化，並可以隨時切換到某個「版本」時候的狀態，以便查看特定版本修訂情況的系統。可以清楚地紀錄每個檔案的擁有者、時間、修改異動。

分散式的版本控制系統在沒有伺服器或是沒有網路的環境，依舊可以使用 Git 來進行版本控制，待伺服器恢復正常運作或是有網路的環境後再進行同步，不會受影響。

1.1 在 ASUSTOR NAS 上安裝 Git

• 使用網頁瀏覽器並以 Administrators 群組的帳號登入 ADM。
• 在 ADM 畫面上選擇 [App Central]，輸入 Git 進行搜尋。
• 點選 [Git] 後，點擊 [安裝]。
• Git 只支援使用命令列操作，因此安裝完成後，不會出現 ADM 桌面圖示。

2. 在 ASUSTOR NAS 建置 Git Repository

ASUSTOR 提供的 Git 僅適用於系統管理員群組的使用者使用，在使用 Git 前，ASUSTOR 建議您建立新的共用資料夾來統一管理 Git Repository 的所有檔案。

2.1 建立 Git 共用資料夾

• 點選 [存取控制] [共用資料夾]。
• 點擊 [新增]。

• 在 NAS 上新增一個共用資料夾。
• 請先為資料夾命名然後點選 [下一步]。( 以下圖為例，將新資料夾命名為 Git_Repository)

• 從選單中選取設定的資料夾存取權限 (以下圖為例，選擇 [管理員群組可讀取及寫入，其餘使用者僅能讀取] )。
• 設定結束後請點選 [下一步]。

• 檢查並確認設定後點選 [完成]。

2.2 設定 Git Repository

Git 只支援使用命令列操作，請務必啟用 SSH 服務。

• 點選 [服務] [終端機] [SSH]。
• 點選 [啟用 SSH 服務] 並點擊 [套用]。

• 透過 SSH 工具登入 NAS，並進入前一章節建立的共用資料夾 [Git_Repository]。
• 輸入下列指令來建立新的資料夾，通常以 Git 專案名稱命名，以 TestProject 為例。亦可使用 ADM 檔案總管在 Git_Repository 下建立新資料夾。
• $ mkdir TestProject

• 進入 TestProject 資料夾，輸入下列指令初始化 Git Repository。
• $ git init -- bare

• 初始化 Git Repository 完成，在 ADM 檔案總管可以看 Git Repository 已設置完成。

3. Git 客户端連接 NAS 上的 Git Repository

使用者可於其他同樣支援 Git 的客戶端電腦安裝合適的軟體來 Clone 在 NAS 上的 Git repository，於不同的平台修改及 commit 程式碼。

此範例以 Windows 10 為例，請參考 Git 官網，下載安裝 Windows 版本 Git。

• Git 安裝完成後，開啟 Windows 檔案總管，建立新資料夾以管理 Git。此範例中建立 [Git_Clone] 資料夾。

• 於 [Git_Clone] 右側空白處點擊右鍵，選擇 [Open Git Bash here]。

• 輸入 git clone 指令連接 NAS 資料夾，以 Clone 該專案的原始碼。
• $ git clone ssh://admin@{NAS_IP}/volume2/Git_Repository/TestProject
• 輸入使用 ssh 登入 NAS 的帳號密碼。
• Git Clone 完成後，即可在本地 Windows 端修改、編寫及 Commit 程式碼。

使用 Windows 版本 Git GUI 操作：

• 於 [Git_Clone] 右側空白處點擊右鍵，選擇 [Open Git GUI here]。

• 點選 [Clone Existing Repository]。

• 輸入來源端 NAS Git 資料夾及本地端資料夾。
• 點擊 [Clone]，即可 Clone 該專案的原始碼。

• 輸入使用 ssh 登入 NAS 的帳號密碼。

• Git Clone 完成後，即可在本地 Windows 端修改、編寫及 Commit 程式碼。

使用 Windows 版本 TortoiseGit 操作：

• 於 [Git_Clone] 右側空白處點擊右鍵，選擇 [Git Clone…]。

• 輸入 NAS Git 資料夾 URL 及本地端資料夾。
• 點擊 [OK]，即可 Clone 該專案的原始碼。

• 輸入使用 ssh 登入 NAS 的帳號密碼。

• Git Clone 完成後，即可在本地 Windows 端修改、編寫及 Commit 程式碼。