ASUSTOR - Website Management

Date:

Topic_id:

Subject:

Description:

content:

<h4>COURSE OBJECTIVES</h4>
Upon completion of this course you should be able to:
<ol>
<li>Configuring a Git repository on your ASUSTOR NAS.</li>
</ol>
 
<h4>PREREQUISITES</h4>
Course Prerequisites:
None
Students are expected to have a working knowledge of:
Linux, Git
 
<h4>OUTLINE</h4>
<a href="#gt1">1. Introduction to Git</a>
<a href="#gt11">1.1 Installing Git on an ASUSTOR NAS</a>
<a href="#gt2">2. Configuring a Git Repository on your ASUSTOR NAS</a>
<a href="#gt21">2.1 Creating a Shared Folder for Git Repositories</a>
<a href="#gt22">2.2 Configuring Git Repositories</a>
<a href="#gt3">3. Connecting to a Git Repository on your NAS with other Git tools</a>
 <hr /> 
<h4><a name="gt1"></a>1. Introduction to Git</h4>
Git is a free and open source distributed version control system designed to handle everything from small to very large projects with speed and efficiency.
The advantage of the distributed version control system is that Git can still be used locally in an environment without a server or without a network. When a server or a network returns to normal, data will synchronize itself.
 
<a name="gt11"></a>1.1 Installing Git on an ASUSTOR NAS
 
<ul>
<li>Log into ADM with an admin account.</li>
<li>Search for Git on App Central.</li>
<li>Select Git, click Install.</li>
<li>Git only supports command-line operations through SSH, so after installation is complete, the ADM desktop icon will not appear.</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. Configuring a Git Repository on your ASUSTOR NAS</h4>
Git provided by ASUSTOR only runs using accounts with administrator rights. Before using Git, ASUSTOR recommends that creating a new shared folder to manage all files in a Git Repository in a unified manner.
 
<a name="gt21"></a>2.1 Creating a Shared Folder for Git Repositories
 
<ul>
<li>Select [Access Control] [Shared Folders].</li>
<li>Click on [Add].</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>You are now ready to create a new shared folder on your NAS.</li>
<li>Enter a name for the new folder and click [Next] once you are done. (In the example below, we have entered "Git_Repository" as the name of our new folder).</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>Set access rights for the folder by selecting the radio button corresponding to the access rights of your choice. (In the example below, the access rights [Read Only for all users, Read & Write for administrators] that have been selected.)</li>
<li>Once you're done, click [Next].</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>Review a final summary of your settings.</li>
<li>Once you're done, confirm these settings by clicking [Finish].</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 Configuring Git Repositories
Git only supports command-line operations, please first ensure that SSH has been enabled.
 
<ul>
<li>Select [Services] [Terminal] [SSH].</li>
<li>Select [Enable SSH service] and click on [Apply].</li>
</ul>
<img src="https://www.asustor.com/images/tinymce/upload_img_20230810174207_Services_enable_SSH.png" alt="" width="880" height="526" />
 
<ul>
<li>Use an SSH client to log into your NAS and navigate to the shared folder named Git_Repository.</li>
<li>Input the command to create a new folder, usually named with the Git project. You can also create a new folder in the ADM File Explorer.</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>Go to the created Git project folder and enter the following command to initialize the 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>When the Git Repository has been initialized, you’ll be able to see that the Git repository has been set up in ADM File Explorer.</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. Connecting to a Git Repository on your NAS with other Git tools</h4>
Users can install appropriate software on other platforms which also support Git to clone the Git repository from an ASUSTOR NAS and then modify and commit source code on different platforms.
Please refer to the <a href="https://www.git-scm.com/downloads" target="_blank" rel="noopener">Git official website</a> to download and install Git for Windows.
 
<ul>
<li>After Git is installed, open Windows File Explorer and create a new folder to manage Git. The folder name "Git_Clone" is used for the purposes of this guide.</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>Right-click on the blank space on the right side of the Git_Clone folder and select [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>Use the Git clone command to connect to the Git repository on the NAS and clone the source code of a project.</li>
<li style="list-style-type: none; line-height: 2.0;">$ git clone ssh://admin@{NAS_IP}/volume2/Git_Repository/TestProject</li>
<li>Log into your NAS with the password you use for your admin account in ssh.</li>
<li>After the Git clone is completed, you’ll be able to modify, write and commit source code on the local platform.</li>
</ul>
<img src="https://www.asustor.com/images/tinymce/upload_img_20230810175340_windows_git_bash_clone.png" alt="" width="800" height="364" />
 
 Instructions for Git Gui:
<ul>
<li>Right-click on the blank space on the right side of the Git_Clone folder and select [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>Click on [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>Input the NAS Git repository as the source location.</li>
<li>Input local folder as the Target Directory.</li>
<li>Click Clone to clone the source code of a Git project.</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>Log into your NAS with the password you use for your admin account in ssh.</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>After the Git clone is completed, you’ll be able to modify, write and commit source code on the local platform.</li>
</ul>
<img src="https://www.asustor.com/images/tinymce/upload_img_20230810180001_windows_git_gui_clone_s4.png" alt="" width="800" height="501" />
 
 Using TortoiseGit:
<ul>
<li>Right-click on the blank space on the right side of the Git_Clone folder and select [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>Input the NAS Git repository as the URL.</li>
<li>Input local folder as the Target Directory.</li>
<li>Click OK to clone the source code of a Git project.</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>Log into your NAS with the password you use for your admin account in ssh.</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>After the Git clone is completed, you’ll be able to modify, write and commit source code on the local platform.</li>
</ul>
<img src="https://www.asustor.com/images/tinymce/upload_img_20230810180217_windows_tortoisegit_clone_s3.png" alt="" width="600" height="470" />

Publish: