Généralités
L'accès au service PLMlab est réservé aux personnes ayant activé leur identifiant PLM. Cela signifie aussi que vous devez avoir activé votre identifiant PLM dans votre profil pour utiliser ce service.
Le nombre maximal de projets par utilisateurs est de 100.
- Les services additionnels disponibles sont les suivants :
- Mattermost (système de discussions instantanées en ligne - "chat")
- Pages (génération de sites webs statiques)
- Container Registry (registre d'images de conteneur (ex : Docker))
- CI (Intégration Continue)
- LFS (Large File Storage - stockage de gros fichiers associés à un dépôt GIT)
- L'aide de gitlab est disponible via le menu en haut à droite
Se connecter
Aller sur https://plmlab.math.cnrs.fr et cliquer sur Fédération Renater.
Choisir de se connecter :
- soit à partir de votre compte d'établissement (figurant dans la liste déroulante) ; cliquer sur Connexion.
- soit à partir de votre compte Mathrice de la PLM ; cliquer sur Connexion avec un compte PLM.
Une fois connecté(e), vous arrivez sur la page avec vos projets.
Ajouter des collaborateurs
Si votre collaborateur n'a pas déjà de compte PLM, il faut lui créer un compte invité.
Ajouter une clef ssh
Pour pouvoir utiliser les connexions ssh, il faut avoir ajouté un clef ssh dans les paramètres de son compte sur PLMlab. Le lien direct est le suivant https://plmlab.math.cnrs.fr/profile/keys .
Utiliser l'URL en https pour git
Si vous choisissez d'utiliser git+https (au lieu de git+ssh), c'est l'identifiant et le mot de passe associé de votre compte PLM qu'il faut indiquer.
Manipulation de "gros" fichiers
La manipulation de gros fichiers binaires comme les fichiers audio, vidéo, les images iso pose un problème avec git.
La recommandation est de ne pas avoir un dépôt git d'une taille supérieure à 1Go pour préserver les performances.
Si vous avez tout de même la nécessité de manipuler des gros fichiers dans votre dépôt git, PLMlab propose la fonctionnalité LFS de gitlab : https://plmlab.math.cnrs.fr/help/workflow/lfs/manage_large_binaries_with_git_lfs .
Lien avec Software Heritage
Le service PLMlab étant connu du projet Software Heritage, vous pouvez demander l'archivage de votre projet en vous rendant sur ce lien et en soumettant l'URL de votre projet.
Votre projet doit être accessible publiquement et il est recommandé d'avoir, à la racine, des fichiers README (la description du projet), AUTHOR (les auteurs), LICENSE (la license s'appliquant à votre projet)
Mise à jour du service
Le logiciel gitlab est mis à jour fréquemment [1] et bénéficie en conséquence de nouvelles fonctionnalités. L'ergonomie évolue aussi souvent.
Le calendrier des mises à jour est le suivant : une version majeure tous les 6 mois, une version mineure tous les mois et des patch environ toutes les semaines.
La plage de mise à jour préférentielle de plmlab est le lundi matin entre 8H et 9H. Des perturbations dans l'accès à ce service sont donc à prévoir dans cette plage horaire.
[1] https://about.gitlab.com/2018/03/27/high-efficiency-innovation/
Plus d'aide
Vous trouverez plus d'aide dans la documentation de gitlab.