Configurer un référentiel Git sur votre NAS ASUSTOR

OBJECTIFS DU COURS

Une fois ce cours terminé, vous devriez être en mesure d’:

1. Configurer un référentiel Git sur votre NAS ASUSTOR.

PRÉ-REQUIS

Cours pré-requis :

Aucune

Les étudiants doivent avoir une connaissance pratique de :

Linux, Git

SOMMAIRE

1. Introduction à Git

1.1 Installer Git sur un NAS ASUSTOR

2. Configurer un référentiel Git sur votre NAS ASUSTOR

2.1 Création d'un Dossier Partagé pour les référentiels Git

2.2 Configuration des Référentiels Git

3. Connexion à un Référentiel Git sur votre NAS avec d'Autres Outils Git

1. Introduction à Git

Git est un système de contrôle de version distribué gratuit et open source conçu pour tout gérer, des petits aux très grands projets, avec rapidité et efficacité.

L'avantage du système de contrôle de version distribué est que Git peut toujours être utilisé localement dans un environnement sans serveur ou sans réseau. Lorsqu'un serveur ou un réseau revient à la normale, les données se synchronisent.

1.1 Installer Git sur un NAS ASUSTOR

• Connectez-vous à ADM avec un compte administrateur.
• Recherchez Git sur App Central.
• Sélectionnez Git, cliquez sur Installer.
• Git ne prend en charge que les opérations de ligne de commande via SSH, donc une fois l'installation terminée, l'icône du bureau ADM n'apparaîtra pas.

2. Configurer un référentiel Git sur votre NAS ASUSTOR

Git fourni par ASUSTOR ne fonctionne qu'en utilisant des comptes avec des droits d'administrateur. Avant d'utiliser Git, ASUSTOR recommande de créer un nouveau dossier partagé pour gérer tous les fichiers d'un référentiel Git de manière unifiée.

2.1 Création d'un Dossier Partagé pour les référentiels Git

• Sélectionnez [Contrôle d'Accès] [Dossiers Partagés].
• Cliquez sur [Ajouter].

• Vous êtes maintenant prêt à créer un nouveau dossier partagé sur votre NAS.
• Entrez un nom pour le nouveau dossier et cliquez sur [Suivant] une fois chose faite. (Dans cet exemple, nous avons utilisé "Git_Repository" comme nom de notre nouveau dossier).

• Réglez les droits d'accès au dossier en cochant le bouton radio correspondant aux droits d'accès de votre choix. (Dans l'exemple ci-dessous, les droits d'accès [Lecture Seule pour tous les utilisateurs, Lecture & Ecriture pour les administrateurs] qui ont été sélectionnés.)
• Une fois chose faite, cliquez sur [Suivant].

• Vérifiez le résumé final de vos réglages.
• Une fois que vous avez terminé, confirmez les réglages en cliquant sur [Terminer].

2.2 Configuration des Référentiels Git

Git ne prend en charge que les opérations de ligne de commande, veuillez d'abord vous assurer que SSH a été activé.

• Sélectionnez [Services] [Terminal] [SSH].
• Sélectionnez [Activer service SSH] et cliquez sur [Appliquer].

• Utilisez un client SSH pour vous connecter à votre NAS et accédez au dossier partagé nommé Git_Repository.
• Entrez la commande pour créer un nouveau dossier, généralement nommé avec le projet Git. Vous pouvez également créer un nouveau dossier dans l'explorateur de fichiers ADM.
• $ mkdir TestProject

• Accédez au dossier du projet Git créé et entrez la commande suivante pour initialiser le référentiel Git.
• $ git init -- bare

• Lorsque le dépôt Git a été initialisé, vous pouvez voir que le dépôt Git a été configuré dans l'explorateur de fichiers d'ADM.

3. Connexion à un Référentiel Git sur votre NAS avec d'Autres Outils Git

Les utilisateurs peuvent installer le logiciel approprié sur d'autres plates-formes prenant également en charge Git pour cloner le référentiel Git à partir d'un NAS ASUSTOR, puis modifier et valider le code source sur différentes plates-formes.

Veuillez-vous référer au Site Web officiel Git pour télécharger et installer Git pour Windows.

• Une fois Git installé, ouvrez l'Explorateur de fichiers Windows et créez un nouveau dossier pour gérer Git. Le nom de dossier "Git_Clone" est utilisé dans le cadre de ce guide.

• Faites un clic droit sur l'espace vide à droite du dossier Git_Clone et selectionnez [Open Git Bash here].

• Utilisez la commande Git clone pour vous connecter au référentiel Git sur le NAS et cloner le code source d'un projet.
• $ git clone ssh://admin@{NAS_IP}/volume2/Git_Repository/TestProject
• Connectez-vous à votre NAS avec le mot de passe que vous utilisez pour votre compte administrateur en ssh.
• Une fois le clone Git terminé, vous pourrez modifier, écrire et valider le code source sur la plate-forme locale.

Instructions pour Git Gui :

• Faites un clic droit sur l'espace vide à droite du dossier Git_Clone et selectionnez [Open Git GUI here].

• Cliquer sur [Clone Existing Repository].

• Entrez le référentiel NAS Git comme emplacement source.
• Entrez le dossier local comme répertoire cible.
• Cliquez sur Clone pour cloner le code source d'un projet Git.

• Connectez-vous à votre NAS avec le mot de passe que vous utilisez pour votre compte administrateur en ssh.

• Une fois le clone Git terminé, vous pourrez modifier, écrire et valider le code source sur la plate-forme locale.

Utilisation de TortoiseGit :

• Faites un clic droit sur l'espace vide à droite du dossier Git_Clone et selectionnez [Git Clone…].

• Entrez le référentiel NAS Git comme URL.
• Entrez le dossier local comme répertoire cible.
• Cliquez sur OK pour cloner le code source d'un projet Git.

• Connectez-vous à votre NAS avec le mot de passe que vous utilisez pour votre compte administrateur en ssh.

• Une fois le clone Git terminé, vous pourrez modifier, écrire et valider le code source sur la plate-forme locale.