GitLab - 5.25 Installer GitLab Runner sur votre machine
Un runner local tourne sur votre propre machine, séparément de l'instance GitLab. Cette leçon présente l'installation sur Linux, puis l'enregistrement du runner auprès de GitLab. Une fois enregistré, le runner peut exécuter les pipelines de votre projet.
Télécharger et installer le paquet
Le guide d'installation de GitLab Runner couvre Linux, macOS, FreeBSD et Windows. La vidéo suit le guide Linux, mais les étapes sont proches sur les autres systèmes.
La commande de téléchargement utilise curl et contient une variable qui dépend de l'architecture de la machine. Il faut donc d'abord connaître cette architecture, puis remplacer la variable par sa valeur, par exemple amd64.
L'installation nécessite les droits administrateur. Une fois le paquet installé, vérifiez le résultat en affichant l'aide de la commande gitlab-runner.
- Trouver l'architecture de votre système avec une commande du terminal.
- Remplacer la variable de la commande de téléchargement par cette valeur.
- Installer le paquet avec les droits administrateur.
- Afficher l'aide avec gitlab-runner help.
Enregistrer le runner
L'enregistrement relie le runner à GitLab. Il nécessite les droits administrateur et demande trois informations : l'adresse de l'instance GitLab, le jeton d'enregistrement et une description.
L'adresse est celle de gitlab.com dans la vidéo, ou celle de votre propre instance si elle est installée ailleurs. Le jeton se trouve dans les paramètres du projet, dans la section Runners.
Indiquez ensuite les tags, séparés par des virgules, puis choisissez l'exécuteur. La vidéo retient l'exécuteur shell, le plus simple à configurer.
sudo gitlab-runner registerVérifier le runner dans GitLab
Après le redémarrage du service gitlab-runner, le runner apparaît dans la liste des runners du projet, avec sa description et ses tags. Depuis cette page, vous pouvez le mettre en pause, le supprimer ou modifier sa configuration.
En résumé
Un runner s'installe à partir du paquet officiel, puis se relie à votre projet avec un jeton d'enregistrement. L'exécuteur shell est le choix le plus simple pour commencer. Une fois visible dans GitLab, le runner est prêt à exécuter des pipelines.
Points clés
- GitLab Runner s'installe sur une machine distincte de l'instance GitLab.
- La variable d'architecture doit être remplacée avant le téléchargement.
- Le jeton d'enregistrement se trouve dans les paramètres du projet.
- L'exécuteur shell est le plus simple à configurer.
- Le runner apparaît dans la liste après le redémarrage du service.
Questions fréquentes
Faut-il installer le runner sur le même serveur que GitLab ?
Non. La vidéo montre un runner sur une machine locale, distincte de l'instance GitLab. Les deux communiquent après l'enregistrement.
Qu'est-ce qu'un exécuteur ?
C'est l'environnement dans lequel chaque job s'exécute. La vidéo retient le shell pour sa simplicité.
Comment mettre en pause ou supprimer un runner ?
Depuis la liste des runners du projet, un bouton permet de le mettre en pause et un autre de le supprimer.