Configurer un serveur Git dans sa salle de PI
Ce tutoriel présente la procédure d'installation d'un serveur Git sur sa machine de projet industriel.
Loin de se vouloir être exhaustif sur l'installation et la configuration du logiciel de dépôt, son but est principalement de vous aider à rendre votre serveur accessible à vos camarades de projet.
Sommaire
Introduction
Dans un soucis de praticité, nous n'installerons pas un serveur git tel quel, mais un gestionnaire de dépôts tiers. Cela vous permettra d'initialiser facilement plusieurs dépôts pour votre PI.
Plusieurs logiciels existent pour remplir cette tâches, notamment :
- Gogs, disponible sur Windows, Debian/Ubuntu et Mac OS.
- Gitea, un fork de Gogs, disponible sur Windows, Debian/Ubuntu et Mac OS également.
- GitLab , beaucoup plus complet que Gogs, il est disponible sur un grand nombre de plateforme également (mais pas Windows).
- Bonobo Git Server, développé spécialement pour les services IIS de Windows.
Pour ce guide, le logiciel Gogs a été choisi, mais rien ne vous interdit d'essayer les deux autres solutions.
À savoir que Bonobo Git Server à le bon côté de se lancer avec IIS au démarrage de votre ordinateur, mais nécessite justement l'installation des services IIS, ce qui peut s'avérer fastidieux. Pour GitLab, si vous êtes sur Windows, l'installation d'une VM sera obligatoire et la configuration réseau pourra s'avérer laborieuse également.
Installation
Prérequis
Il est nécessaire d'avoir git d'installé sur votre PC pour poursuivre l'installation. Il vous faudra également un des système de base de données suivant :
- MySQL (nécessite une installation)
- PostgreSQL (nécessite une installation)
- SQLite 3 (ne nécessite aucune installation)
Installation de Gogs
L'installation de Gogs se fait très facilement, il faut pour cela :
- Télécharger le binaire Gogs sur le site Gogs
- Extraire l'archive dans le dossier voulu
- 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 stockés 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ées par les règles de routage appliquées par le proxy de l'école, je vous invite à vous diriger vers ce post superuser.com 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 caché et ne pas apparaitre si vous y accédez 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'on 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.
Si l'accès ne marche toujours pas, il peut être nécessaire d'ajouter une exception pour <votreNomDHôte> dans les paramètres proxy de votre navigateur.
