Installation de Git sur un NAS Synology

Git est un logiciel de gestion de versions permettant de maintenir l’ensemble des versions d’un ou plusieurs fichiers, dans le cas présent de fichiers de code sources, pour faciliter l’échange des fichiers entre les différentes personnes travaillant

Des connaissances sur les instructions en mode console (mode non graphique des systèmes d’exploitation), et sur l’utilisation de Vi (éditeur de texte utilisé en mode non graphique), sont nécessaires pour mener à bien ce tutoriel.

Convention pour l’écriture des commandes en mode console

  • $ : console côté local, exécution des commandes sur l’ordinateur local
  • NAS > : console côté NAS, les commandes sont exécutées sur le NAS

Connexion au NAS en mode ligne de commande

Si vous utilisez un système d’exploitation Linux, passez en mode console et entrez la commande qui suit. A l’inverse si votre système d’exploitation est sous Windows, connectez-vous via putty ou une console de type GitBash ou Mingw reconnaissant la commande ssh (Secure Shell).

-> La commande de base pour la connection au NAS est la suivante : $ ssh utilisateur@adresse

L’utilisateur que nous utiliserons est le root pour permettre l’installation de programmes sur le NAS.
Pour se connecter, l’adresse correspond à celle du NAS et le mot de passe est celui utilisé pour le compte administrateur.

Nous allons voir comment installer Git sur un NAS Synology au travers de quatre parties : l’activation de la connexion, la création d’un dossier de partage et d’un compte utilisateur, l’installation d’ipkg et pour terminer l’installation du Git.

 

I. Activation de la connexion en SSH sur Synology

Pour permettre la connexion au serveur Synology en mode console et permettre l’échange sécurisé des données de Git, la connection SSH est essentielle.

  1. Connectez-vous à l’interface web via le compte administrateur
  2. Allez dans le « panneau de configuration », puis dans « Terminal »
  3. Cochez la case « Activer le service SSH »
  4. Redémarrez le NAS

 

II. Création d’un dossier partagé et d’un compte utilisateur

La création d’un dossier partagé et d’un compte utilisateur serviront à accéder aux dossiers git du NAS.

Cet accès permettra aux utilisateurs de se connecter pour créer, modifier ou supprimer les fichiers git.

 

Création d’un dossier partagé

  1. Connectez-vous à l’interface web via le compte administrateur
  2. Allez dans « Panneau de configuration », puis dans « Dossier Partagé »
  3. Créez un nouveau dossier nommé « Git »

 

Il est important de savoir qu’il ne faut assigner aucun utilisateur au dossier partagé.

 

Création d’un utilisateur git

  1. Connectez-vous au « Panneau de configuration », puis rendez-vous dans «Utilisateur »
  2. Créez un utilisateur nommé git, puis liez le à une adresse mail et attribuez lui un mot de passe
  3. Associez cet utilisateur au groupe « users »
  4. Dans l’attribution des privilèges, il faut permettre Lecture/Ecriture du dossier Git afin qu’il puisse avoir accès aux droits de modifications, de créations et de suppressions et l’empêcher d’accéder aux autres dossiers de partage du NAS
  5. Vérifiez les données entrées dans la page de récapitulatif et validez la création du nouvel utilisateur.

Il n’y a pas de nécessités spécifiques pour le quota et les privilèges liés aux applications.

 

Paramétrage du compte utilisateur git

1. Editez le fichier contenant les différents paramètres des utilisateurs du NAS

vi /etc/passwd

2. GIT PARTAGE : centralisé à un endroit pour tous les utilisateurs (home). Il faut modifier le chemin de connexion pour que l’utilisateur git aille directement dans son dossier (/volume1/Git et son « shell » en /bin/sh.)
Vous devriez obtenir une ligne pour l’utilisateur git ressemblant à celle-ci

-> git:x:Chiffre1:Chiffre2::/volume1/Git:/bin/sh
/!\ Le chiffre n°1 correspond au numéro d’identifiant du compte sur l’ordinateur et le chiffre n°2 du groupe auquel l’utilisateur est rattaché, à ne pas toucher, ni modifier.

 

III. Installation de ipkg

L’ipkg est un gestionnaire de paquets permettant l’installation de programmes, dont Git, sur le NAS.

1. Cherchez le processeur de votre NAS selon le modèle de celui-ci grâce à la liste du lien suivant : http://bit.ly/tdq6Ih

2. Connectez-vous à l’aide d’une interface de ligne de commandes au NAS

3. Chargez l’exécutable ipkg via la commande wget selon le type de CPU de votre NAS. Cliquez sur le lien suivant afin d’obtenir les liens pour le téléchargement selon le type du processeur de votre NAS : http://bit.ly/cFTXtr

-> Par exemple pour un modèle mv5281 ARM , la commande sera :

NAS> wget

Exécutez la commande suivante pour rendre le fichier téléchargé exécutable

NAS> chmod +x syno-x07-bootstrap_1.2-7_arm.xsh

4. Exécutez le fichier

NAS> sh syno-x07-bootstrap_1.2-7_arm.xsh

5. Supprimez l’exécutable

NAS> rm syno-mvkw-bootstrap_1.2-7_arm.xsh

6. Redémarrer le NAS

NAS> reboot now

7. Reconnectez-vous via une interface de ligne de commandes au NAS

8. Lancez la mise à jour de ipkg

NAS> ipkg update

 

IV. Installation de Git

1. Lancez l’installation de Git

NAS> ipkg install git

2. Créez un lien des commandes de git dans le répertoire principal des exécutables de commandes pour éviter les problèmes d’importation de path

NAS> ln -s /opt/bin/git* /usr/bin

Git est maintenant installé sur votre NAS et prêt à l’emploi. Vous pouvez utiliser l’utilisateur git pour accéder directement aux archives des dossiers git via une adresse de ce genre :

$ ssh git@adresse.nas/volume1/Git/mon_projet.git