GitLab

Description du service

GitLab est un service d’hébergement git collaboratif. Notre instance est destinée aux utilisateurs académiques membres du réseau eduGAIN et à leurs collaborateurs pour un usage strictement professionnel. GitLab est déployé dans sa version Community Edition.

En cas de problème, veuillez contacter le support utilisateurs.

Avertissement

Qualité de service

Notre engagement est de type best effort : nous nous engageons à mettre en œuvre tous les moyens pour assurer la continuité du service.

Respect des conditions d’utilisation

Nous nous réservons le droit de désactiver/supprimer les comptes ou dépôts qui ne respecteraient pas les conditions d’utilisation, en particulier les droits sur la propriété intellectuelle.

Niveaux de visibilité des dépôts

Il existe 3 niveaux de visibilité pour les dépôts (et donc le code qu’il contiennent) :

  • Privé : le dépôt n’est visible et ne peut être cloné que par le priétaire et les utilisateurs ou groupe qu’il aura explicitement ajoutés;
  • Interne : le dépôt est visible et peut être cloné par tout utilisateur connecté;
  • Public : le dépôt est visible et peut être cloné sans aucune authentification. Il sera également répertorié dans le répertoire d’accès public (/public).

Par défaut, les nouveaux dépôts sont privés mais peuvent hériter la visibilité du groupe parent.

Comptes utilisateur

Création de compte/S’enregistrer

  • les utilisateurs académiques doivent s’enregistrer par la fédération eduGAIN, en cliquant [Shibboleth]
  • les autres doivent s’enregistrer en cliquant [Sign-up]

Il est préférable que l’e-mail soit institutionnel.

Pour les utilisateurs non-eduGAIN qui souhaitent obtenir un accès complet, un garant doit confirmer la demande de création au support utilisateurs. Les nouveaux utilisateurs non-eduGAIN sont external par défaut. Les administrateurs débloqueront le compte après validation.

Configuration SSH

La méthode privilégiée pour interagir avec les dépôts git est SSH. Vous pouvez suivre cette aide pour configurer votre clef SSH.

Activer Shibboleth

Lorsqu’un compte est créé par [Sign-up], on ne peut pas utiliser l’authentification Shibboleth : il faut l’ajouter dans son profile :

Profile Settings > Account > Social sign-in

L’intérêt est de pouvoir utiliser le Single Sign On proposé par les fédérations d’identité.

Doublons Shibboleth

Lors d’un enregistrement par Shibboleth, GitLab construit le champ username en prenant le début de l’adresse mail jusqu’au caractère @. Ce qui peut conduire à des collisions pour des homonymes d’organisations différentes. La solution consiste à :

  • s’enregistrer par [Sign-up] en choisissant un username différent de l’homonyme;
  • activer Shibboleth pour ce compte.

Intégration/Déploiement Continu

La plateforme d’intégration continue est basée sur GitLab. Il faut configurer votre projet GitLab de sorte à utiliser un Runner; ainsi chaque commit ou push déclenche l’exécution des pipelines d’intégration continue.

Les informations concernants l’intégration continue (pipelines, jobs, environnements, etc) sont affichées dans le menu “CI/CD” du menu vertical GitLab.

Pour tout problème vous pouvez contacter notre support utilisateurs

Dépôt de fichiers volumineux

GitLab lui-même n’est pas fait pour stocker des fichiers binaires volumineux. Pour la gestion de fichiers tels que fichiers audio, video graphique ou images de machines virtuelles, GitLab supporte “git lfs”.