Configurazione di un repository Git sul NAS ASUSTOR

OBIETTIVI DEL CORSO

Al termine di questo corso si dovrebbe essere in grado di:

1. Configurazione di un repository Git sul NAS ASUSTOR.

PREREQUISITI

Prerequisiti del corso:

Nessuno

Gli studenti devono avere una conoscenza pratica di:

Linux, Git

SCHEMA

1. Introduzione a Git

1.1 Installazione di Git su un NAS ASUSTOR

2. Configurazione di un repository Git sul NAS ASUSTOR

2.1 Creazione di una cartella condivisa per un repository Git

2.2 Configurazione di un repository Git

3. Connessione a un repository Git sul NAS con altri strumenti Git

1. Introduzione a Git

Git è un sistema di controllo delle versioni distribuite, del tutto gratuito e open source, progettato per gestire qualsiasi cosa, dai progetti piccoli a quelli molto grandi con estrema velocità ed efficienza.

Il vantaggio del sistema di controllo delle versioni distribuite è che Git può comunque essere utilizzato localmente in un ambiente senza server o senza rete. Quando un server o una rete ritorna alla normalità, i dati si sincronizzeranno automaticamente.

1.1 Installazione di Git su un NAS ASUSTOR

• Accedere ad ADM con un account amministratore.
• Cerca Git su App Central.
• Selezionare Git e fare clic su Installa.
• Git supporta solo operazioni da riga di comando tramite SSH, quindi una volta completata l'installazione, l'icona del desktop di ADM non sarà visualizzata.

2. Configurazione di un repository Git sul NAS ASUSTOR

Git fornito da ASUSTOR funziona solo utilizzando account con diritti di amministratore. Prima di utilizzare Git, ASUSTOR consiglia di creare una nuova cartella condivisa per gestire tutti i file in un repository Git in modo unificato.

2.1 Creazione di una cartella condivisa per un repository Git

• Selezionare [Controllo accessi] [Cartelle condivisa].
• Fare clic su [Aggiungi].

• Adesso si è pronti per creare una nuova cartella condivisa sul NAS.
• Inserire un nome per la nuova cartella e, al termine, fare clic su [Avanti]. (Nell'esempio che segue, abbiamo inserito "Git_Repository" come nome della nostra nuova cartella).

• Impostare i diritti d’accesso per la cartella selezionando il pulsante di opzione corrispondente ai diritti d’accesso di scelta. (Nell'esempio che segue, sono stati selezionati i diritti di accesso [Solo lettura per tutti gli utenti, Lettura e scrittura per l'amministratore].)
• Al termine, fare clic su [Avanti].

• Controllare il riepilogo finale delle impostazioni.
• Al termine, confermare le impostazioni facendo clic su [Fine].

2.2 Configurazione di un repository Git

Git supporta solo operazioni da riga di comando, assicurati innanzitutto che SSH sia stato abilitato.

• Selezionare [Servizi] [Terminale] [SSH].
• Selezionare la casella [Abilita servizio SSH] e fare clic su [Applica].

• Utilizzare un client SSH per accedere al NAS e accedere alla cartella condivisa denominata Git_Repository.
• Inserisci il comando per creare una nuova cartella, solitamente denominata con il progetto Git. È inoltre possibile creare una nuova cartella in ADM File Explorer.
• $ mkdir TestProject

• Vai alla cartella del progetto Git creata e inserisci il seguente comando per inizializzare il repository Git.
• $ git init -- bare

• Una volta inizializzato il repository Git, potrai vedere esso sia stato configurato in ADM File Explorer.

3. Connessione a un repository Git sul NAS con altri strumenti Git

Gli utenti possono installare il software appropriato su altre piattaforme che supportano anche Git per clonare il repository Git da un NAS ASUSTOR e quindi modificare ed eseguire il commit del codice sorgente su piattaforme diverse.

Fare riferimento al sito web ufficiale di Git per scaricare e installare Git per Windows.

• Dopo aver installato Git, aprire Esplora file di Windows e creare una nuova cartella per gestire Git. Ai fini di questa guida viene utilizzato il nome della cartella "Git_Clone".

• Fare clic con il pulsante destro del mouse sullo spazio vuoto sul lato destro della cartella Git_Clone e selezionare [Open Git Bash here].

• Utilizzare il comando Git clone per connettersi al repository Git sul NAS e clonare il codice sorgente di un progetto.
• $ git clone ssh://admin@{NAS_IP}/volume2/Git_Repository/TestProject
• Accedi al NAS con la password che utilizzi per il tuo account amministratore in ssh.
• Una volta completato il clone Git, sarai in grado di modificare, scrivere e inviare il codice sorgente, sulla piattaforma locale.

Istruzioni per Git Gui:

• Fare clic con il pulsante destro del mouse sullo spazio vuoto sul lato destro della cartella Git_Clone e selezionare [Open Git GUI here].

• Fare clic su [Clone Existing Repository].

• Immettere il repository Git NAS come posizione di origine.
• Immettere la cartella locale come directory di destinazione.
• Fare clic su Clona per clonare il codice sorgente di un progetto Git.

• Accedi al NAS con la password che utilizzi per il tuo account amministratore in ssh.

• Una volta completato il clone Git, sarai in grado di modificare, scrivere e inviare il codice sorgente, sulla piattaforma locale.

Usando TortoiseGit:

• Fare clic con il pulsante destro del mouse sullo spazio vuoto sul lato destro della cartella Git_Clone e selezionare [Git Clone…].

• Immettere il repository Git NAS come URL.
• Immettere la cartella locale come directory di destinazione.
• Fare clic su OK per clonare il codice sorgente di un progetto Git.

• Accedi al NAS con la password che utilizzi per il tuo account amministratore in ssh.

• Una volta completato il clone Git, sarai in grado di modificare, scrivere e inviare il codice sorgente, sulla piattaforma locale.