Gitlab est un logiciel permettant de gérer des dépôts git.

Chez FAImaison, il accessible sur https://git.faimaison.net

Gitlab permet plusieurs choses :

• Créer / Mettre à jour / Supprimer un dépôt git
• Gérer des utilisateurs git
• Permettre l'édition en ligne de fichiers (aucun besoin de client git installé sur sa machine dans ce cas : tout se passe dans l'interface Web)
• Gestion de projet (issues, merge requests, …)
• Intégration / Déploiement continu
• Interaction entre contributeurs au plus près des contributions
• Bien d'autres choses.

Si vous n'y avez pas accès, veuillez envoyer un e-mail au bureau (bureau at faimaison dot net).

L'hébergement de dépôts git sur l'infrastructure de FAImaison est réservé à FAImaison et à ses membres.

Dans un premier temps, une limite de 5 projets personnels par membre est appliquée : c'est une limite dont il sera amené à discuter notamment pour prendre en compte les coûts éventuels que peut engendrer un grand nombre de dépôts.

L'esprit au lancement du service est le suivant : on héberge les projets de l'association et on laisse la possibilité aux membres de tester des idées / projets.

Pour pouvoir utiliser les outils git installés sur votre ordinateur et pousser sur les dépôts de FAImaison, vous devez au préalable ajouter votre clé ssh à votre profil Gitlab.

Après vous être connectés, dans le menu de votre profil, choisissez “Settings” :

Puis rendez-vous dans “SSH Keys” :

: ce qui est ici est le fruit du travail du rédacteur et n'a pas été discuté en amont ; ce qui est ici est basé sur les bonnes pratiques qu'on retrouve souvent

Pour contribuer, l'idée principale est la suivante :

• je travaille sur ma branche
• j'ouvre une Merge Request pour verser mes contribution au projet
• une discussion s'ouvre autour de ma proposition
• j'apporte les éventuels correctifs
• ma contribution est versée au projet en fermant la merge request. Seul les utilisateur des groupes “Master” et “Owner” peuvent faire ça

La branche de release est protégée. Personne ne peut committer dans celle-ci à part les utilisateur des groupes “Master” et “Owner”. Qui prendront soin de passer, comme leurs camarades, par des merge requests.

Quand vous recevez une demande d'inscription, transmettez la demande sur la liste adminsys après vérification d'adhésion du demandeur.

Gitlab est hébergé sur riboul.faimaison.net. On retrouve aussi du docker et gitlab-runner-multi-ci.

docker est utilisé uniquement pour l'intégration / déploiement continus, son empreinte est donc faible sur Gitlab lui-même. Il permet juste d'éviter que des informations personnelles puissent être récupérées simplement en jouant des builds.

Connectez-vous sur gitlab, allez dans la zone d'administration ( https://git.faimaison.net/admin ) et créez un compte utilisateur.

Puis, il faut donner les droits à ce nouvel utilisateur pour le groupe faimaison-membres. Allez dans le groupe faimaison-membres et affectez le role “Developer” à ce nouveau membre.