GitLab Runner: Premiers pas

Connectez votre GitLab Runner Stackhero à GitLab.com ou à un GitLab auto-hébergé et exécutez votre premier pipeline

👋 Bienvenue sur la documentation de Stackhero !

Stackhero vous propose une solution GitLab Runner cloud simple à utiliser, conçue pour exécuter efficacement vos jobs GitLab CI/CD. Voici ce dont vous pouvez bénéficier :

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

Jobs simultanés : lancez plusieurs jobs en parallèle pour accélérer l'ensemble de votre pipeline.

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

Compatible avec GitLab.com ainsi que toute instance GitLab auto-hébergé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 lancez vos pipelines en quelques minutes seulement !

Introduction

Un GitLab Runner est l'agent chargé d'exécuter vos jobs CI/CD GitLab. À chaque déclenchement d'un pipeline, le runner prend en charge chaque job, l'exécute dans un conteneur Docker propre, puis remonte les résultats à GitLab.

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

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

Etape 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 l'offre adaptée à vos besoins. L'offre 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, c'est-à-dire le nombre de jobs pouvant s'exécuter en parallèle).

Votre runner sera opérationnel en environ 2 minutes.

Etape 2 : Créez 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 le périmètre 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 (uniquement pour GitLab auto-hébergé) : 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 en charge tous les jobs.

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

L'ancien mode de fonctionnement 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.

Etape 3 : Connectez votre runner

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

Votre URL GitLab : Utilisez https://gitlab.com pour GitLab.com, ou l'URL de votre instance GitLab auto-hébergée (par exemple, si vous utilisez GitLab sur Stackhero, cela peut ê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éé.

Etape 4 : Exécutez 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

C'est tout. Vos pipelines s'exécutent désormais sur votre runner dédié, avec des minutes de build illimitées.

Etape suivante

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