Gitlab
Inscriptions libres.
Interface Web : https://forge.tedomum.net
Généralités
Notre service de forge est basé sur le logiciel libre GitLab CE.
Nous l’utilison pour nos propres projets et le proposons en accès libre, incluant :
- l’hébergement de projets (tickets, wiki, etc.) ;
- l’hébergement de dépôts Git ;
- la fonction Gitlab CI (intégration continue) avec des runners de groupe sur demande ;
- la fonction Gitlab pages (sites statiques) ;
- la fonction support par ticket (y-compris par e-mail).
Accès et utilisation de Gitlab
Gitlab est organisé en projets :
Vous pouvez créer vos propres projets, ou accéder aux projets de votre choix directement depuis le menu principal.
L’interface est ensuite déclinée par projet, avec les fonctionnalités de gestion de code, de gestion de projet, d’intégration continue, de support, etc.
Pour plus de détails, voir la documentation de Gitlab : https://docs.gitlab.com/
Créer son propre projet
Après vous être connecté via Hiboo, une page listant les projets publics (ou privés auxquels vous avez accès) s’affichera. Si vous souhaitez créer votre propre projet, il suffit alors de cliquer sur le bouton New project :
Ce qui vous ouvrira la page suivante :
À partir de là, vous pouvez choisir entre :
- créer un projet vierge où il faudra tout créer ;
- partir sur un template qui préconfigurera le projet ;
- importer un projet venant d’ailleurs pour en avoir une copie conforme ;
- suivre les instructions pour créer un projet via votre terminal.
Changer la langue sur Gitlab
Lorsque vous aurez créé votre compte, il vous sera possible de changer la langue de Gitlab dans les paramètres de votre compte.
À noter que la traduction est loin d’être complète pour le moment.
Installer un Runner Gitlab Ci
La forge Gitlab intègre Gitlab CI pour l’intégration continue. Afin de construire votre projet, vous pouvez au choix nous solliciter pour disposer d’un runner pour votre groupe, sous réserve d’une consommation raisonnable de ressources sur notre infrastructure, et d’une gestion des droits sur vos projets empêchant l’exécution de builds par des acteurs malveillants ; ou bien utiliser votre propre runner.
Afin d’installer un runner, suivez d’abord les instructions à cette adresse : https://docs.gitlab.com/runner/install/. Nous recommandons une installation sur une machine virtuelle Debian 10 au minimum et le déploiement via le dépôt APT de Gitlab.
Puis, démarrez la commande gitlab-runner register et répondez aux questions suivantes :
- serveur :
https://forge.tedomum.net/; - token : utilisez le token de l’un de vos dépôts, idéalement du premier dépôt pour lequel vous souhaitez tester .
Pour construire d’autres projets avec ce runner, merci de contacter un administrateur afin qu’il active le runner sur ces autres projets. Si tous les projets que vous souhaitez construire sont dans un même groupe Gitlab, vous pouvez également enregistrer le runner avec un token de groupe ; en revanche, il ne pourra plus être activé sur un projet en dehors de ce groupe, même par un administrateur.
Si vous souhaitez construire des images Docker, vous pouvez activer le mode AutoDevops de Gitlab, paramétré sur notre forge exclusivement pour construire et publier sur le dépôt Gitlab les images Docker des projets. Afin que la construction réussisse, il faut utiliser un runner configuré en mode docker.
Autres instances
Il existe d’autres instances Gitlab. Si vous ne trouvez pas votre bonheur chez nous, peut-être le trouverez-vous ailleurs ? Ci-dessous une liste d’instances :
À noter que vous en trouverez certainement d’autres du côté des chatons.