GitLab Runners
Auteur
Introduction
Cette page de tutoriel explique comment installer simplement sur linux un runner utilisable pour un projet hébergé sur un serveur GitLab. Ces runners sont utilisés dans le cadre de l'intégration continue sur GitLab. Bien entendu, il existe de nombreuses configurations différentes et même plusieurs types de runners. Ici, nous viserons l'installation la plus simple, c'est à dire un runner spécifique éxécuté par shell, donc avec les caractéristiques de la machine sur laquelle le runner est installé. Pour d'autres configurations, n'hésitez pas à parcourir les sources.
La documentation du runner officiel de GitLab se trouve ici : https://docs.gitlab.com/runner/.
Installation
# Linux x86-64 sudo wget -O /usr/local/bin/gitlab-runner https://gitlab-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-runner-linux-amd64
OU
# Linux x86 sudo wget -O /usr/local/bin/gitlab-runner https://gitlab-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-runner-linux-386
OU
# Linux arm sudo wget -O /usr/local/bin/gitlab-runner https://gitlab-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-runner-linux-arm
PUIS
sudo chmod +x /usr/local/bin/gitlab-runner sudo useradd --comment 'GitLab Runner' --create-home gitlab-runner --shell /bin/bash sudo gitlab-runner install --user=gitlab-runner --working-directory=/home/gitlab-runner sudo gitlab-runner start
Configuration
sudo gitlab-runner register
L'URL et le token à spécifier pour configurer le runner se trouvent dans les options du projet GitLab sous Settings -> CI/CD -> Runners, dans la section Set up a specific Runner manually
Astuces
- Afficher les runners existants : sudo gitlab-runner list
- Afficher l’état des runners : sudo gitlab-runner verify
- Supprimer les runners retirés de GitLab : sudo gitlab-runner verify --delete
- Retirer un runner :
- par url & token : gitlab-runner unregister --url <url> --token <token>
- par nom (le premier du nom sera retiré) : gitlab-runner unregister --name <name>
- tous : gitlab-runner unregister --all-runners
Sources
Configurer un runner
Configurer les runners du projet
Documentation du runner GitLab
Installation du runner GitLab
Installation du runner sous Linux
Explication des executeurs