Configurer un serveur Git dans sa salle de PI : Différence entre versions
De Wikisisar
m |
|||
| (7 révisions intermédiaires par le même utilisateur non affichées) | |||
| Ligne 1 : | Ligne 1 : | ||
| − | + | 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. | ||
= Introduction = | = Introduction = | ||
| − | Dans un soucis de praticité, nous n'installerons pas un serveur git tel quel, mais un gestionnaire de dépôts | + | 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 | + | |
| + | Plusieurs logiciels existent pour remplir cette tâches, notamment : | ||
* '''[https://gogs.io/ Gogs]''', disponible sur Windows, Debian/Ubuntu et Mac OS. | * '''[https://gogs.io/ Gogs]''', disponible sur Windows, Debian/Ubuntu et Mac OS. | ||
| − | * '''[https://about.gitlab.com/ GitLab ]''', beaucoup plus complet que Gogs, il est disponible sur un grand nombre de plateforme également. | + | * '''[https://gitea.io/ Gitea]''', un fork de Gogs, disponible sur Windows, Debian/Ubuntu et Mac OS également. |
| − | * '''[https://bonobogitserver.com/ Bonobo Git Server]''', développé pour les services [https://fr.wikipedia.org/wiki/Internet_Information_Services IIS] de Windows. | + | * '''[https://about.gitlab.com/ GitLab ]''', beaucoup plus complet que Gogs, il est disponible sur un grand nombre de plateforme également ('''mais pas Windows'''). |
| + | * '''[https://bonobogitserver.com/ Bonobo Git Server]''', développé spécialement pour les services [https://fr.wikipedia.org/wiki/Internet_Information_Services IIS] de Windows. | ||
| − | Pour ce guide, le logiciel Gogs a été | + | 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 = | = Installation = | ||
== Prérequis == | == Prérequis == | ||
| − | Il est nécessaire d'avoir '''git | + | 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 [https://dev.mysql.com/downloads/mysql/ une installation]) | ||
| + | * PostgreSQL (nécessite [https://www.postgresql.org/download/ une installation]) | ||
| + | * SQLite 3 (ne nécessite '''aucune installation''') | ||
== Installation de Gogs == | == Installation de Gogs == | ||
| Ligne 23 : | Ligne 32 : | ||
== Configuration réseau == | == Configuration réseau == | ||
| − | Pour que vos collègues puissent se connecter aux dépôts qui seront | + | 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. |
| − | {{mbox|type=style|image=[[File:light_bulb_icon.svg|40px]]|text = Pour les personnes | + | {{mbox|type=style|image=[[File:light_bulb_icon.svg|40px]]|text = 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 [https://superuser.com/a/346376 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. | 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 | + | * 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''' | * Sur GNU/Linux, le chemin du fichier est : '''/etc/hosts''' | ||
| Ligne 35 : | Ligne 44 : | ||
'''Le nom d'hôte ne doit pas contenir de points !''' | '''Le nom d'hôte ne doit pas contenir de points !''' | ||
| − | {{mbox|type=style|image=[[File:light_bulb_icon.svg|40px]]|text = Le fichier '''hosts''' est le fichier [https://fr.wikipedia.org/wiki/Hosts 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' | + | {{mbox|type=style|image=[[File:light_bulb_icon.svg|40px]]|text = Le fichier '''hosts''' est le fichier [https://fr.wikipedia.org/wiki/Hosts 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. | 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. | ||
Version actuelle datée du 4 juin 2018 à 12:55
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.
