Gitlab

  • 4 mins read

Le service informatique vous offre la possibilité d’utiliser une forge gitlab pour vos codes de développement. Ce système basé sur git vous offre également des fonctionnalités de wiki, suivi de bugs ou encore d’intégration continue. Via ce système vous avez la possibilité de créer une arborescence de fichiers dans votre projet pour en conserver toutes les versions ainsi que les différences.

Vous pouvez également mutualiser le développement de votre code avec un groupe d’utilisateurs (externe ou interne au laboratoire). Ce groupe peut intervenir pour modifier le code. Toute modification sera conservée dans le système afin de revenir en arrière si cela s’avère nécessaire.

Pour les collaborateurs externes à l’OSU, veuillez ouvrir un ticket sur le site d’assistance https://assistance.osupytheas.fr afin que le SIP puisse créer un compte dans gitlab associé à votre collaborateur.

Le service est disponible ici : https://gitlab.osupytheas.fr

Gitlab permet également de faire du CI/CD (Continuous Integration, Delivery, and Deployment). En suivant ce lien vous trouverez un tutoriel qui explique comment cela fonctionne dans notre infrastructure informatique.

1. Prise en main

Création d’un projet

Se connecter avec ses identifiants OSU à https://gitlab.osupytheas.fr

Note : Seul le personnel OSU peut se connecter à Git. Dans le cadre de collaborateurs externes, il est possible de les autoriser à se connecter à Git. Il faut alors contacter le SIP afin de créer un compte Gitlab pour les personnels externes.

  • Cliquer sur New Project (à droite)
  • Choisir Create Blank Project

Sur la nouvelle interface (fig.1), il faut remplir les champs suivants:

  • Project Name : Nom de votre Projet
  • Choisir le type de visibilité de votre projet

Visibilité de votre projet :

  • Private : Vous serez seul administrateur à travailler sur votre projet.

Vous pourrez par la suite ajouter des utilisateurs si vous souhaitez partager.

  • Internal : Le projet est disponible pour toutes les personnes se connectant au Git.
  • Public : Votre projet est ouvert au public.
Fig.1 Interface de création d’un projet Git à travers GitLab

Dernière étape, cliquer sur « Create project »

Démarrage du projet

Une nouvelle fenêtre s’ouvre comme ci-dessous (fig.2 et fig.3).

Fig.2 Configuration du projet
Fig.3 Configuration du projet

Le Git donne les commandes et les informations pour importer dans votre répertoire de travail le projet.

Sur votre ordinateur ou sur le cluster ou tout autre environnement sur lequel vous travaillez, il va falloir maintenant importer votre projet.

La suite se déroule en ligne de commande depuis votre espace de travail.

Clonage du projet

Cela signifie que le projet va être créer dans votre répertoire.

Il suffit de taper les commandes suivantes.

Exemple d’un clonage d’un projet existant:

Dans mon espace de travail, un nouveau dossier a été crée au nom de mnh_seasalt comprenant toutes les sources.

On peut alors voir l’ensemble du projet directement dans mon répertoire.

Mise à jour du projet et dépôt des nouvelles sources

Si nous continuons sur l’exemple ci-dessus.

Imaginons que nous avons apporté une modification à un code sur le projet mnh_seasalt.

Il suffit alors de copier cette nouvelle source dans le répertoire et ensuite de mettre à jour le git.

Deux options :

  • vous mettez à jour l’ensemble des sources
  • vous mettez à jour uniquement un fichier

Il suffit alors de faire git add chemindemasource/masource

Et ensuite git commit et git push.

2. Commandes de bases

Pour récupérer le projet

git clone https://gitlab.osupytheas.fr/infrastructure/data-cluster.git

Ajouter un fichier ou appliquer une modification :

git add nom_fichier

git commit -m "modification fonction de clustering"

Pousser un fichier dans le dépot

git push

-> la commande nécessite que vous puissiez modifier le dépot

Historique des commits :

git log

Mettre à jour votre dépot local

La commande suivante vous permet de mettre à jour votre code localement en appliquant les dernières modifications du dépot :

git pull

Partager un projet

Il est possible dans gitlab de partager un projet avec des collaborateurs (personnel d’un laboratoire de l’OSU ou personnel extérieur ne disposant pas de compte informatique) en suivant la procédure ci-dessous. Le collaborateur doit disposer d’un compte au préalable dans le gitlab de l’OSU. Si ce n’est pas le cas merci de faire la demande via le site d’assistance https://assistance.osupytheas.fr.

Depuis l’interface gitlab sélectionnez votre projet, cliquez sur Project information et enfin sur Members.

Cliquez sur le bouton Invite members à droite.

Il ne vous reste plus qu’à remplir les champs spécifiques de la fenêtre d’invitation en spécifiant le compte de l’utilisateur dans la case Username