Version du 26 février 2018 à 16:18

Cet tutoriel présente la procédure d'installation d'un serveur Git dans sa salle de Projet Industriel.

Introduction

Dans un soucis de praticité, nous n'installerons pas un serveur git tel quel, mais un gestionnaire de dépôts tier. Cela vous permettra d'initialiser plusieurs dépôts, pour votre PI, facilement. Plusieurs logiciels existe pour remplir cette tâches, notamment :

• Gogs, disponible sur Windows, Debian/Ubuntu et Mac OS.
• GitLab , beaucoup plus complet que Gogs, il est disponible sur un grand nombre de plateforme également.
• Bonobo Git Server, développé pour les services IIS de Windows.

Pour ce guide, le logiciel Gogs a été choisit, mais rien ne vous interdit d'essayer les deux autres solutions. Sachant que Bonobo Git Server a la qualité de se lancer avec IIS au démarrage de votre ordinateur, la difficulté d'installation résidant dans la phase d'installation des services IIS.

Installation

Prérequis

Il est nécessaire d'avoir git et un serveur MySQL d'installer sur votre PC pour poursuivre l'installation.

Installation de Gogs

L'installation de Gogs se fait très facilement, il faut pour cela :

1. Télécharger le binaire Gogs sur le site Gogs
2. Extraire l'archive dans le dossier voulu
3. Ouvrir un terminal et exécuter la commande ./gogs web

Configuration réseau

Pour que vos collègues puissent se connecter aux dépôts qui seront stocker sur votre PC, il est nécessaire de configurer le DNS de chaque ordinateur pour ne pas que les communications partent vers le proxy.

Pour les personnes intéressé par les règles de routage appliqué par le proxy de l'école, je vous invite à vous diriger vers [ce guide] qui vous indiquera comment récupérer la configuration.

Pour modifier votre DNS, ouvrez sur chaque PC le fichier hosts avec les accès administrateur.

• Sur Windows, le chemin du fichier est : C:\Windows\System32\drivers\etc\hosts. (Il peut être cacher et ne pas apparaitre si vous y accéder en avançant dossier par dossier)
• Sur GNU/Linux, le chemin du fichier est : /etc/hosts

Rajouter une ligne avec :

<IpDuServeurGit>        <nomHôteÀUtiliser>

Le nom d'hôte ne doit pas contenir de points !

Le fichier hosts est le fichier historique de résolution DNS. Il fut mis au point par ARPANET et contenait alors toutes les associations hôte/IP jusqu'à l'arrivée du service DNS que l'ont connait aujourd'hui.

Après modification, vous pouvez alors vous connecter à l'adresse http://<votreNomDHôte>:3000/, ce qui vous emmènera directement sur la page de configuration de gogs.