GitLab Runners

From air
Jump to navigation Jump to search

Auteur

CHANET Zoran

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