Gitlab

Généralités

Pour notre documentation et notre suivi de maintenance nous utilisons GitLab CE. Pour plus d’informations sur cet outil, rendez-vous sur le site suivant: https://about.gitlab.com/

Utilisation de l’outil

Cet outil est composé par projet :

Il est donc important de sélectionner le bon projet pour accéder aux données recherchées.

Documentation

Toute notre documentation est regroupée dans le wiki du projet TeDomum / Documentation :

Une fois le wiki ouvert, vous aurez alors une page similaire :

En cas d’erreur ou de suggestion de modification sur une de nos documentations, n’hésitez pas à nous en faire par sur matrix ou à faire un ticket, voir chapitre ci-dessous.

Gestion de la partie support (tickets)

Consultation des tickets

Les tickets sont gérés par projet. Pour y accéder, il faut donc sélectionner un projet, exemple avec Peertube :

En cliquant sur le menu liste, vous obtiendrez une page similaire à celle ci-dessous :

Comme vous pourrez le voir, les tickets possèdent différentes étiquettes pour identifier rapidement s’il s’agit d’un bug, d’une suggestion, d’une mise à jour etc… Si vous souhaitez voir que les tickets pour une étiquette donnée (bug par exemple) eh bien il suffit de cliquer sur l’étiquette concernée pour afficher tous les tickets du même style :

Il est également possible de générer un tableau de bord pour les tickets afin de voir facilement dans quelle catégories ils sont classés :

Pour avoir cette page, il suffit d’aller dans le menu Ticket > Tableau.

Maintenant, il reste possible d’afficher l’ensemble de tous les tickets ouverts (tout projet confondu) en utilisant le lien suivant : https://forge.tedomum.net/groups/tedomum/-/issues

Création d’un ticket

Pour créer un ticket, il faut tout d’abord sélectionner le projet pour lequel un ticket doit être ouvert. Par exemple, si vous rencontrez un problème avec PixelFed, il suffit alors de sélectionner le projet TeDomum / Pixelfed et aller dans la partie tickets et cliquer ensuite sur New Issue :

Vous aurez alors le formulaire ci-dessous à remplir :

Dans le cas d’une suggestion pour la mise en place d’un service non exsitant chez TeDomum, nous vous invitons à ouvrir un ticket dans la partie Documentation.

Changer la langue sur Gitlab

Lorsque vous aurez créer votre compte, il vous sera possible de changer la langue de Gitlab dans les paramètres de votre compte.

A noter que la traduction est loin d’être complète pour le moment.

Installer un Runner Gitlab Ci

La forge Gitlab intègre un support d’intégration continue via Gitlab CI. Afin de construire votre projet vous pouvez au choix :

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 :

Pour contruire d’autres projets avec ce runner, merci de contacter un administateur pour 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 est nécessaire que Docker soit installé sur la machine où vous construisez l’image et que l’utilisateur gitlab-runner puisse exécuter des conteneurs Docker. Reportez-vous à la documentation Docker à ce sujet : https://docs.docker.com/install/linux/docker-ce/debian/

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 :

A noter que vous en trouverez certainement d’autres du côté des chatons.