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.
Table des matières
Mise à jour du projet et dépôt des nouvelles sources
Ajouter un fichier ou appliquer une modification :
Pousser un fichier dans le dépot
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.
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).
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
