ASUSTOR - Website Management

Date:

Topic_id:

Subject:

Description:

content:

<h4>課程目的</h4>
完成此課程後您將能夠：
<ol>
<li>使用 ASUSTOR NAS 建置 Git Repository。</li>
</ol>
 
<h4>必修項目</h4>
課程必修項目：
無
學生須先具備以下知識：
Linux、Git
 
<h4>大綱</h4>
<a href="#gt1">1. Git 簡介</a>
<a href="#gt11">1.1 在 ASUSTOR NAS 安裝 Git</a>
<a href="#gt2">2. 在 ASUSTOR NAS 建置 Git Repository</a>
<a href="#gt21">2.1 建立 Git 共用資料夾</a>
<a href="#gt22">2.2 設定 Git Repository</a>
<a href="#gt3">3. Git 客户端連接 NAS 上的 Git Repository</a>
 <hr /> 
<h4><a name="gt1"></a>1. Git 簡介</h4>
Git 是一種免費開源的分散式版本的版本控制系統（Version Control Stystem）。記錄一個或若干個文件的狀態變化，並可以隨時切換到某個「版本」時候的狀態，以便查看特定版本修訂情況的系統。可以清楚地紀錄每個檔案的擁有者、時間、修改異動。
分散式的版本控制系統在沒有伺服器或是沒有網路的環境，依舊可以使用 Git 來進行版本控制，待伺服器恢復正常運作或是有網路的環境後再進行同步，不會受影響。
 
<a name="gt11"></a>1.1 在 ASUSTOR NAS 上安裝 Git
 
<ul>
<li>使用網頁瀏覽器並以 Administrators 群組的帳號登入 ADM。</li>
<li>在 ADM 畫面上選擇 [App Central]，輸入 Git 進行搜尋。</li>
<li>點選 [Git] 後，點擊 [安裝]。</li>
<li>Git 只支援使用命令列操作，因此安裝完成後，不會出現 ADM 桌面圖示。</li>
</ul>
<img src="https://www.asustor.com/images/tinymce/upload_img_20230810173939_App_Central_install_git.png" alt="" title="" width="900" height="532" align="" />
 
<h4><a name="gt2"></a>2. 在 ASUSTOR NAS 建置 Git Repository</h4>
ASUSTOR 提供的 Git 僅適用於系統管理員群組的使用者使用，在使用 Git 前，ASUSTOR 建議您建立新的共用資料夾來統一管理 Git Repository 的所有檔案。
 
<a name="gt21"></a>2.1 建立 Git 共用資料夾
 
<ul>
<li>點選 [存取控制] [共用資料夾]。</li>
<li>點擊 [新增]。</li>
</ul>
<img src="https://www.asustor.com/images/tinymce/upload_img_20230810174016_Add_Shared_Folder_s1.png" alt="" width="880" height="526" />
 
<ul>
<li>在 NAS 上新增一個共用資料夾。</li>
<li>請先為資料夾命名然後點選 [下一步]。( 以下圖為例，將新資料夾命名為 Git_Repository)</li>
</ul>
<img src="https://www.asustor.com/images/tinymce/upload_img_20230810174033_Add_Shared_Folder_s2.png" alt="" width="700" height="599" />
 
<ul>
<li>從選單中選取設定的資料夾存取權限 (以下圖為例，選擇 [管理員群組可讀取及寫入，其餘使用者僅能讀取] )。</li>
<li>設定結束後請點選 [下一步]。</li>
</ul>
<img src="https://www.asustor.com/images/tinymce/upload_img_20230810174123_Add_Shared_Folder_s3.png" alt="" width="700" height="599" />
 
<ul>
<li>檢查並確認設定後點選 [完成]。</li>
</ul>
<img src="https://www.asustor.com/images/tinymce/upload_img_20230810174136_Add_Shared_Folder_s4.png" alt="" width="700" height="599" />
 
<a name="gt22"></a>2.2 設定 Git Repository
Git 只支援使用命令列操作，請務必啟用 SSH 服務。
 
<ul>
<li>點選 [服務] [終端機] [SSH]。</li>
<li>點選 [啟用 SSH 服務] 並點擊 [套用]。</li>
</ul>
<img src="https://www.asustor.com/images/tinymce/upload_img_20230810174207_Services_enable_SSH.png" alt="" width="880" height="526" />
 
<ul>
<li>透過 SSH 工具登入 NAS，並進入前一章節建立的共用資料夾 [Git_Repository]。</li>
<li>輸入下列指令來建立新的資料夾，通常以 Git 專案名稱命名，以 TestProject 為例。亦可使用 ADM 檔案總管在 Git_Repository 下建立新資料夾。</li>
<li style="list-style-type: none; line-height: 2.0;">$ mkdir TestProject</li>
</ul>
<img src="https://www.asustor.com/images/tinymce/upload_img_20230810174319_ssh_command_mkdir.png" alt="" width="720" height="178" />
 
<ul>
<li>進入 TestProject 資料夾，輸入下列指令初始化 Git Repository。</li>
<li style="list-style-type: none; line-height: 2.0;">$ git init -- bare</li>
</ul>
<img src="https://www.asustor.com/images/tinymce/upload_img_20230810174354_ssh_command_git_init.png" alt="" width="800" height="286" />
 
<ul>
<li>初始化 Git Repository 完成，在 ADM 檔案總管可以看 Git Repository 已設置完成。</li>
</ul>
<img src="https://www.asustor.com/images/tinymce/upload_img_20230810174453_TestProject_folder_after_git_init.png" alt="" width="900" height="503" />
 
<h4><a name="gt3"></a>3. Git 客户端連接 NAS 上的 Git Repository</h4>
使用者可於其他同樣支援 Git 的客戶端電腦安裝合適的軟體來 Clone 在 NAS 上的 Git repository，於不同的平台修改及 commit 程式碼。
此範例以 Windows 10 為例，請參考 <a href="https://www.git-scm.com/downloads" target="_blank" rel="noopener">Git 官網</a>，下載安裝 Windows 版本 Git。
 
<ul>
<li>Git 安裝完成後，開啟 Windows 檔案總管，建立新資料夾以管理 Git。此範例中建立 [Git_Clone] 資料夾。</li>
</ul>
<img src="https://www.asustor.com/images/tinymce/upload_img_20230810175003_windows_explorer_git_folder.png" alt="" width="900" height="574" />
 
<ul>
<li>於 [Git_Clone] 右側空白處點擊右鍵，選擇 [Open Git Bash here]。</li>
</ul>
<img src="https://www.asustor.com/images/tinymce/upload_img_20230810175249_windows_right_click_open_git_bash.png" alt="" width="300" height="327" />
 
<ul>
<li>輸入 git clone 指令連接 NAS 資料夾，以 Clone 該專案的原始碼。</li>
<li style="list-style-type: none; line-height: 2.0;">$ git clone ssh://admin@{NAS_IP}/volume2/Git_Repository/TestProject</li>
<li>輸入使用 ssh 登入 NAS 的帳號密碼。</li>
<li>Git Clone 完成後，即可在本地 Windows 端修改、編寫及 Commit 程式碼。</li>
</ul>
<img src="https://www.asustor.com/images/tinymce/upload_img_20230810175340_windows_git_bash_clone.png" alt="" width="800" height="364" />
 
 使用 Windows 版本 Git GUI 操作：
<ul>
<li>於 [Git_Clone] 右側空白處點擊右鍵，選擇 [Open Git GUI here]。</li>
</ul>
<img src="https://www.asustor.com/images/tinymce/upload_img_20230810175419_windows_right_click_open_git_gui.png" alt="" width="300" height="327" />
 
<ul>
<li>點選 [Clone Existing Repository]。</li>
</ul>
<img src="https://www.asustor.com/images/tinymce/upload_img_20230810175440_windows_git_gui_clone_s1.png" alt="" width="450" height="367" />
 
<ul>
<li>輸入來源端 NAS Git 資料夾及本地端資料夾。</li>
<li>點擊 [Clone]，即可 Clone 該專案的原始碼。</li>
</ul>
<img src="https://www.asustor.com/images/tinymce/upload_img_20230810175504_windows_git_gui_clone_s2-1.png" alt="" width="700" height="259" />
<img src="https://www.asustor.com/images/tinymce/upload_img_20230810175636_windows_git_gui_clone_s2-2.png" alt="" width="800" height="330" />
 
<ul>
<li>輸入使用 ssh 登入 NAS 的帳號密碼。</li>
</ul>
<img src="https://www.asustor.com/images/tinymce/upload_img_20230810175842_windows_git_gui_clone_s3.png" alt="" width="660" height="279" />
 
<ul>
<li>Git Clone 完成後，即可在本地 Windows 端修改、編寫及 Commit 程式碼。</li>
</ul>
<img src="https://www.asustor.com/images/tinymce/upload_img_20230810180001_windows_git_gui_clone_s4.png" alt="" width="800" height="501" />
 
 使用 Windows 版本 TortoiseGit 操作：
<ul>
<li>於 [Git_Clone] 右側空白處點擊右鍵，選擇 [Git Clone…]。</li>
</ul>
<img src="https://www.asustor.com/images/tinymce/upload_img_20230810180020_windows_right_click_open_git_clone.png" alt="" width="300" height="327" />
 
<ul>
<li>輸入 NAS Git 資料夾 URL 及本地端資料夾。</li>
<li>點擊 [OK]，即可 Clone 該專案的原始碼。</li>
</ul>
<img src="https://www.asustor.com/images/tinymce/upload_img_20230810180049_windows_tortoisegit_clone_s1-1.png" alt="" width="700" height="537" />
<img src="https://www.asustor.com/images/tinymce/upload_img_20230810180123_windows_tortoisegit_clone_s1-2.png" alt="" width="800" height="538" />
 
<ul>
<li>輸入使用 ssh 登入 NAS 的帳號密碼。</li>
</ul>
<img src="https://www.asustor.com/images/tinymce/upload_img_20230810180150_windows_tortoisegit_clone_s2.png" alt="" width="600" height="465" />
 
<ul>
<li>Git Clone 完成後，即可在本地 Windows 端修改、編寫及 Commit 程式碼。</li>
</ul>
<img src="https://www.asustor.com/images/tinymce/upload_img_20230810180217_windows_tortoisegit_clone_s3.png" alt="" width="600" height="470" />

Publish: