D
Documentation
LA FORGE LOGICIELLE GITLAB CIRAD
CIRAD : Céline Blitz Frayret - Pascal Degenne - Alice Boizet - Facundo Muñoz
0 - Evènements
- 8 juin 2023 - Séminaire "Pratiques sur les logiciels scientifiques et les forges logicielles", Cirad
I - Présentation
- CGU / RGPD
- Présentation de la forge logicielle -accès restreint-
- Services disponibles -accès restreint-
- Fonctionnalités disponibles sur la forge logicielle Gitlab Cirad
II - Documentation utilisateurs
II-1 - Bonnes pratiques de sécurité -accès restreint-
II-2 - Organisation de la forge logicielle Gitlab Cirad
- Généralités Gitlab : définition du projet logiciel
- Généralités Gitlab : l'interface graphique pour gérer le projet logiciel
- Généralités Gitlab : espaces de noms
- Spécificités Gitlab Cirad : organisation des projets dans des groupes
II-3 - Rôles et permissions des membres sous Gitlab
II-4 - Travailler dans un projet logiciel de la forge Gitlab Cirad
- Conditions de création des groupes, sous-groupes et projets
- Créer un groupe à la racine de la forge
- Configuration d'un groupe (ou d'un sous-groupe)
- Créer un sous-groupe
- Créer un projet
- Création d'un projet à partir du template
- Déposer du code source dans un projet logiciel (en interactif)
- Rejoindre un groupe ou un sous-groupe
- Rejoindre un projet
- Affilier des membres à un projet
- Affilier des membres à un groupe ou sous-groupe
- Suppression d'un projet
- Suppression d'un groupe ou sous-groupe
- Migration d'un projet en provenance d'une autre forge
- Transfert d'un projet vers un groupe
- S'entraîner sur la forge Gitlab Cirad - Bac à sable
II-5 - Utilisation du gestionnaire de version Git
- Installation de Git: Windows, Linux, RStudio
- Configuration de Git et Gitlab: SSH, configuration de Git
- Pourquoi utiliser un gestionnaire de version ?
- Principe du commit
- Interactions du dépôt local avec le dépôt distant (forge logicielle)
- Association de l'URL du dépôt distant (forge logicielle) au dépôt local
- Principe des branches
- Exemple de workflow de Git
- Bonnes pratiques de Git
III - Documentation référents
III-1 - Rôles du référent
III-2 - Accès et demande d'extension de droits
III-3 - Gérer un groupe
- Avantage d'une structuration en groupe
- Conditions de création des groupes, sous-groupes et projets
- Les scénarios
- Configuration d'un groupe
- Configuration d'un bac à sable
- Transfert d'un projet vers un groupe
IV - Pour aller plus loin : documentations officielles
IV-1 - Documentation Gitlab (liens vers gitlab.com en anglais)
- Organisation sous Gitlab
- Les projets logiciels
- Planification des travaux : milestones, issues, conversations
- Développement d'un logiciel : opérations Git, merge request, intégration continue
- Déploiement d'un logiciel
IV-2 - Documentation Git (liens vers git-scm.com)
IV-3 - Références diverses
Bases de Git : https://www.freecodecamp.org/news/learn-git-basics/
Support interactif (et multilingue) : https://ndpsoftware.com/git-cheatsheet.html#loc=workspace
- Cliquer sur les zones permet de voir les commandes qui sont en relation avec, passer la souris sur une commande permet de voir une description
Commandes Git (multilingue) : https://training.github.com/ (fr)
- Avec GitHub indiqué partout
Git et RStudio (en anglais) : https://epiverse-trace.github.io/git-rstudio-basics/index.html
- En mode plutôt CLI avec le package gert
- Un peu orienté GitHub
Tutoriels Atlassian : https://www.atlassian.com/fr/git
- Particulièrement intéressant pour les workflows (GitFlow)
Livre en ligne 'Happy Git and GitHub for the useR' : https://happygitwithr.com/
- Très orienté R et GitHub, comme son titre le suggère.
- Bons contenus plus généraux. E.g. sur le choix d'un client GUI pour Git, ou la configuration de clés SSH.
- Décliné en fonction du système d'exploitation (i.e. Windows, iOS, Linux), très bonnes explications.
Cours en ligne (Software carpentry) 'Version Control with Git' : https://swcarpentry.github.io/git-novice/index.html
- Plus détaillé par rapport au flux de travail en git.
- Toujours très GitHub
Git+GitLab crash course : https://forgemia.inra.fr/umr-astre/training/forgemia-tutorial
- Tutoriel rapide pour commencer rapidement avec git et GitLab
- Très basique, mais peut se faire dans une demi-journée. Vous pouvez l'utiliser et adapter librement (CC BY-SA).
- Pour l'instant il est dans Forgemia (Inrae).