GitLab Runner: Premiers pas

Connectez votre GitLab Runner Stackhero à GitLab.com, Stackhero for GitLab ou à votre propre serveur GitLab et lancez votre premier pipeline en quelques minutes

👋 Bienvenue dans la documentation Stackhero !

Stackhero offre une solution GitLab Runner cloud simple qui rend l’exécution de vos jobs GitLab CI/CD efficace et sans tracas. Voici ce que vous pouvez attendre :

Minutes CI/CD illimitées : exécutez vos pipelines aussi souvent que nécessaire, sans facturation à la minute ni frais imprévus.

Plusieurs jobs simultanés : accélérez votre développement en lançant plusieurs jobs en parallèle.

L’executor Docker avec prise en charge de Docker-in-Docker : construisez et poussez facilement des images de conteneurs dans vos processus CI/CD.

Fonctionne parfaitement avec GitLab.com et les instances GitLab autogérées.

Une infrastructure privée et dédiée avec stockage NVMe/SSD rapide assure des performances de build stables et prévisibles.

Disponible dans les régions 🇪🇺 Europe et 🇺🇸 USA pour répondre aux besoins de votre équipe.

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 qui exécute vos jobs GitLab CI/CD. À chaque exécution de pipeline, le runner prend chaque job, l’exécute dans un conteneur Docker isolé, puis remonte les résultats à GitLab.

Avec Stackhero, votre runner fonctionne toujours sur une infrastructure privée et dédiée. Il n’y a aucun frais à la minute ni de quota d’utilisation : vos minutes CI/CD sont illimitées. Selon votre forfait, votre runner peut traiter plusieurs jobs simultanés en parallèle, ce qui rend la montée en charge de vos builds très simple.

Ce guide vous aide à connecter votre runner Stackhero à GitLab et à lancer rapidement votre premier pipeline.

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

Depuis votre tableau de bord Stackhero, vous pouvez créer un nouveau service GitLab Runner et choisir un forfait adapté à votre workflow. Le forfait détermine les ressources CPU, RAM et le nombre de jobs simultanés (correspondant au paramètre concurrent du GitLab Runner : combien de jobs le runner peut traiter en parallèle).

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

Étape 2 : Créez un runner dans GitLab

Votre runner se connecte à GitLab à l’aide d’un jeton d’authentification runner. Vous générez ce jeton dans GitLab et choisissez également la portée du runner :

Runner de projet : Ouvrez votre projet, puis allez dans Settings > CI/CD > Runners > New project runner.
Runner de groupe : Ouvrez votre groupe, puis allez dans Settings > CI/CD > Runners > New group runner.
Runner d’instance (pour GitLab auto-hébergé seulement) : Accédez à la Admin area > CI/CD > Runners > New instance runner.

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

Ajouter des tags (par exemple docker ou stackhero) pour cibler ce runner depuis vos jobs.
Autoriser l’exécution de jobs sans tag si vous souhaitez qu’il traite tous les jobs, même ceux sans tag.

GitLab vous fournira un jeton d’authentification runner commençant par glrt-. Gardez ce jeton en sécurité, car votre runner l’utilise pour s’authentifier auprès de GitLab.

L’ancien mode de fonctionnement avec le registration token est obsolète. Veuillez utiliser le jeton d’authentification runner (glrt-...) créé lors de l’ajout du runner, comme décrit ci-dessus.

Vous trouverez plus de détails dans la documentation officielle sur l’enregistrement des runners GitLab.

Étape 3 : Connectez votre runner

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

URL GitLab : Utilisez https://gitlab.com pour GitLab.com, ou l’URL de votre instance GitLab auto-hébergée. (Si vous exécutez GitLab sur Stackhero, cela pourrait être https://git.votre-entreprise.com.)
Jeton d’authentification runner (glrt-...) obtenu à l’étape 2.
Nombre de jobs simultanés que vous souhaitez autoriser.

Après avoir enregistré votre configuration, votre runner se connectera à GitLab et apparaîtra comme en ligne sur la page Runners où vous l’avez configuré.

Étape 4 : Lancez votre premier pipeline

Ajoutez un fichier .gitlab-ci.yml à la racine de votre dépôt pour définir votre pipeline :

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 déclenchera 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

Vos pipelines s’exécutent maintenant sur votre runner dédié, avec des minutes de build illimitées et sans limite d’utilisation à gérer.

Étape suivante

Si vous souhaitez builder et pousser des images Docker depuis vos pipelines, poursuivez avec Builder des images Docker.