GitLab
GitLab est une interface Web pour les dépôts Git proposant de multiples fonctionnalités pratiques pour visualiser un dépôt, et donner des droits de commit/push à des utilisateurs n'existant pas sur le serveur.
Il est initialement basé sur gitolite, mais est devenu totalement indépendant.
Sommaire
Installation
Pour installer Gitlab, on a suivi cette page : https://about.gitlab.com/install/#debian.
C'est un paquet « Omnibus » qui contient l'ensemble de l'environnement Gitlab, le tout déployé avec Chef (concurrent de Bcfg2). Il permet de grandement simplifier les mises à jours.
Pour l'intégration avec le CAS du Crans, voir https://docs.gitlab.com/ee/integration/cas.html.
Maintenance
Voir https://docs.gitlab.com/ce/administration/raketasks/maintenance.html
Le Gitlab du Crans
Les adhérents du Crans ont la possibilité d'y héberger jusqu'à 75 projets qui peuvent être publics, privés, ou ouverts seulement aux utilisateurs connectés (internes).
Il est possible de demander une augmentation de cette limite en envoyant un mail à nounou@crans.org
Lien
Le GitLab du Crans se trouve à l'adresse https://gitlab.crans.org.
Tutorial
1ère utilisation
- Vous pouvez vous connecter avec votre login/mot de passe Cr@ns.
Si vous n'avez pas de clé SSH, générez-en une. Cf WikiInformatique/ConnexionSsh#Les_clefs_SSH
Allez dans Profile settings puis SSH Keys
Add SSH Key
Donnez-lui un nom sympathique dans Title (comme, par exemple, le nom de la machine sur laquelle elle est) et collez le contenu du fichier ~/.ssh/id_rsa.pub dans Key.
Cloner un dépôt
Quand vous êtes sur la page gitlab d'un dépôt, pour le cloner, il faut récupérer l'uri. Vous pouvez choisir SSH ou HTTPS.
En SSH, l'url ressemble à git@gitlab.crans.org:namespace/projet.git, en HTTPS https://gitlab.crans.org/namespace/projet.git
Bogues connus
Outdated
C'est des vieux bogues qui ont du être corrigés.
Lors du push d'une nouvelle branche, celle-ci n'est pas correctement chargé par gitlab et n'apparait pas dans le menu déroulant, mais uniquement dans la page branches.
L'issue est registered ici : https://github.com/gitlabhq/gitlabhq/issues/4864
Pour fixe sur geet :
cd /gitlab/gitlab && sudo -u git -H bundle exec rake cache:clear RAILS_ENV=production
Lors de la création d'un dépôt celui-ci apparaît vide ou le README ne se mets pas à jours après un changement.
Pour fixe sur geet :
cd /gitlab/gitlab && sudo -u git -H bundle exec rake cache:clear RAILS_ENV=production