GitLab Runner: Premiers pas

Connectez votre GitLab Runner Stackhero à GitLab.com ou à un GitLab autogéré et exécutez votre premier pipeline

👋 Bienvenue dans la documentation Stackhero !

Stackhero vous offre une solution GitLab Runner cloud facile à utiliser, conçue pour gérer efficacement vos jobs GitLab CI/CD. Voici ce à quoi vous pouvez vous attendre :

Minutes CI/CD illimitées : aucune facturation à la minute, vos pipelines s’exécutent dès que vous en avez besoin.

Plusieurs jobs simultanés : exécutez plusieurs jobs en même temps pour accélérer l’ensemble de votre pipeline.

Docker executor avec prise en charge de Docker-in-Docker : simplifiez la création et le push de vos images de conteneurs.

Compatible avec GitLab.com ainsi qu’avec toute instance GitLab autogérée.

Une VM privée et dédiée propulsée par des disques NVMe/SSD rapides pour des builds fiables et constants.

Disponible dans les régions 🇪🇺 Europe et 🇺🇸 USA.

Gagnez du temps : connectez votre premier GitLab Runner et commencez à exécuter vos pipelines en quelques minutes seulement !

Introduction

Un GitLab Runner est l’agent responsable de l’exécution de vos jobs CI/CD GitLab. Chaque fois qu’un pipeline est déclenché, le runner prend chaque job, l’exécute dans un conteneur Docker propre, puis transmet les résultats à GitLab.

Avec Stackhero, votre runner fonctionne sur une VM privée et dédiée. Il n’y a aucun frais à la minute ni quota d’utilisation, et vos minutes CI/CD sont illimitées. Selon votre forfait, votre runner peut gérer des dizaines de jobs simultanés.

Ce guide vous explique comment connecter votre runner Stackhero à GitLab en seulement quelques minutes.

Étape 1 : Créer votre GitLab Runner sur Stackhero

Depuis votre tableau de bord Stackhero, vous pouvez créer un nouveau service GitLab Runner et choisir le forfait adapté à vos besoins. Le forfait détermine la puissance CPU, la RAM disponible et le nombre de jobs simultanés (ce qui correspond au paramètre concurrent du GitLab Runner, soit le nombre de jobs pouvant s’exécuter en parallèle).

Votre runner sera prêt à l’emploi en environ 2 minutes.

Étape 2 : Créer un runner dans GitLab

Votre runner se connecte à GitLab à l’aide d’un jeton d’authentification runner. Vous allez générer ce jeton dans GitLab, où vous définirez également la portée du runner :

Project runner : Ouvrez votre projet, puis allez dans Settings > CI/CD > Runners > New project runner.
Group runner : Ouvrez votre groupe, puis allez dans Settings > CI/CD > Runners > New group runner.
Instance runner (pour GitLab autogéré seulement) : Rendez-vous dans la Admin area > CI/CD > Runners > New instance runner.

Lors de la création du runner, vous pouvez :

Ajouter des tags (comme docker ou stackhero) pour cibler ce runner depuis vos jobs.
Autoriser l’exécution de jobs sans tag si vous souhaitez qu’il prenne tous les jobs.

GitLab vous fournira un jeton d’authentification runner commençant par glrt-. Assurez-vous de garder ce jeton en sécurité, car il permet à votre runner de s’authentifier.

L’ancien mode avec le registration token est obsolète. Veuillez utiliser le jeton d’authentification runner (glrt-...) créé en même temps que le runner, comme décrit ci-dessus.

Étape 3 : Connecter votre runner

Retournez sur votre tableau de bord Stackhero, ouvrez la configuration de votre service GitLab Runner et saisissez les informations suivantes :

Votre URL GitLab : Utilisez https://gitlab.com pour GitLab.com, ou l’URL de votre instance GitLab autogérée (par exemple, si vous utilisez GitLab sur Stackhero, cela pourrait être https://git.votre-entreprise.com).
Le jeton d’authentification runner (glrt-...) obtenu à l’étape 2.
Le nombre de jobs simultanés que vous souhaitez autoriser.

Une fois la configuration enregistrée, votre runner se connectera automatiquement à GitLab et apparaîtra comme en ligne sur la page Runners où vous l’avez créé.

Étape 4 : Exécuter votre premier pipeline

Pour commencer, ajoutez un fichier .gitlab-ci.yml à la racine de votre dépôt :

stages:
  - build
  - test

build:
  stage: build
  image: node:22
  script:
    - npm ci
    - npm run build

test:
  stage: test
  image: node:22
  script:
    - npm test

Validez et poussez vos modifications. GitLab lancera un pipeline et votre runner Stackhero exécutera les jobs. Si vous avez ajouté des tags lors de la création du runner, vous pouvez les cibler dans vos jobs comme ceci :

build:
  stage: build
  tags:
    - stackhero
  image: node:22
  script:
    - npm ci
    - npm run build

Voilà, vos pipelines s’exécutent maintenant sur votre runner dédié, avec des minutes de build illimitées.

Étape suivante

Vous souhaitez construire et pousser des images Docker depuis vos pipelines ? Continuez avec Construire des images Docker.