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 sur la documentation de Stackhero !

Stackhero propose une solution GitLab Runner cloud simple qui facilite l'exécution de vos jobs GitLab CI/CD, de façon efficace et sans contraintes. 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 auto-hébergées.

Une infrastructure privée et dédiée avec un stockage NVMe/SSD rapide garantit 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 : vous pouvez connecter votre premier GitLab Runner et lancer vos pipelines en seulement quelques minutes !

Introduction

Un GitLab Runner est l'agent qui exécute vos jobs GitLab CI/CD. À chaque exécution de pipeline, le runner prend en charge 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 coût à la minute ni quota d'utilisation : vos minutes CI/CD sont illimitées. Selon votre offre, votre runner peut traiter plusieurs jobs simultanés en parallèle, ce qui facilite la montée en charge de vos builds.

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 une offre adaptée à votre workflow. L'offre 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 (uniquement pour GitLab auto-hébergé) : Accédez à 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 traite tous les jobs, même ceux sans tag.

GitLab vous fournit un jeton d'authentification runner commençant par glrt-. Gardez ce jeton en sécurité, car il permet à votre runner de 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 renseignez 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 utilisez GitLab sur Stackhero, cela peut ê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 connecte à GitLab et apparaît 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éclenche un pipeline et votre runner Stackhero exécute 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 désormais 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.