GitLab Runner: Aan de slag

Verbind uw Stackhero GitLab Runner met GitLab.com of een self-managed GitLab en voer uw eerste pipeline uit

👋 Welkom bij de Stackhero-documentatie!

Stackhero biedt u een gebruiksvriendelijke GitLab Runner cloud oplossing, speciaal ontworpen om uw GitLab CI/CD-jobs efficiënt uit te voeren. Dit kunt u verwachten:

Onbeperkte CI/CD-minuten: er is geen facturatie per minuut, dus uw pipelines kunnen draaien wanneer u dat nodig heeft.

Meerdere gelijktijdige jobs: voer verschillende jobs tegelijkertijd uit om uw volledige pipeline te versnellen.

De Docker executor met ondersteuning voor Docker-in-Docker: maak het bouwen en pushen van uw container images eenvoudiger.

Compatibel met GitLab.com en elke self-managed GitLab-instantie.

Een privé, dedicated VM aangedreven door snelle NVMe/SSD-schijven voor consistente en betrouwbare builds.

Beschikbaar in zowel 🇪🇺 Europa als 🇺🇸 USA regio's.

Bespaar tijd: u kunt uw eerste GitLab Runner koppelen en binnen enkele minuten pipelines uitvoeren!

Introductie

Een GitLab Runner is de agent die verantwoordelijk is voor het uitvoeren van uw GitLab CI/CD-jobs. Elke keer dat een pipeline wordt gestart, pikt de runner elke job op, voert deze uit in een schone Docker-container en rapporteert vervolgens de resultaten terug aan GitLab.

Met Stackhero draait uw runner op een privé, dedicated VM. Er zijn geen kosten per minuut of gebruiksquota, en uw CI/CD-minuten zijn onbeperkt. Afhankelijk van uw gekozen plan kan uw runner tientallen gelijktijdige jobs tegelijk verwerken.

Deze handleiding begeleidt u bij het verbinden van uw Stackhero runner met GitLab in slechts een paar minuten.

Stap 1: Maak uw GitLab Runner aan op Stackhero

Via uw Stackhero-dashboard kunt u een nieuwe GitLab Runner-service aanmaken en het plan kiezen dat bij uw behoeften past. Het plan bepaalt uw beschikbare CPU, RAM en het aantal gelijktijdige jobs (dit komt overeen met de concurrent-instelling van de GitLab Runner, oftewel het aantal jobs dat gelijktijdig kan draaien).

Uw runner is binnen ongeveer 2 minuten operationeel.

Stap 2: Maak een runner aan in GitLab

Uw runner maakt verbinding met GitLab via een runner authentication token. U genereert dit token in GitLab, waar u ook het bereik van de runner bepaalt:

Project runner: Open uw project en ga naar Settings > CI/CD > Runners > New project runner.
Group runner: Open uw groep en ga naar Settings > CI/CD > Runners > New group runner.
Instance runner (alleen voor self-managed GitLab): Ga naar de Admin area > CI/CD > Runners > New instance runner.

Bij het aanmaken van de runner kunt u:

Tags toevoegen (zoals docker of stackhero) om deze runner vanuit uw jobs te targeten.
Toestaan dat de runner untagged jobs uitvoert als u wilt dat hij alle jobs oppakt.

GitLab zal een runner authentication token genereren dat begint met glrt-. Zorg ervoor dat u dit token veilig bewaart, want hiermee authentiseert uw runner zich.

De oude registration token-methode is verouderd. Gebruik het runner authentication token (glrt-...) dat samen met de runner is aangemaakt, zoals hierboven beschreven.

Stap 3: Verbind uw runner

Ga terug naar uw Stackhero-dashboard, open de configuratie van uw GitLab Runner-service en vul de volgende gegevens in:

Uw GitLab URL: Gebruik https://gitlab.com voor GitLab.com, of de URL van uw self-managed GitLab-instantie (bijvoorbeeld, als u GitLab op Stackhero draait, kan dit https://git.uw-bedrijf.com zijn).
Het runner authentication token (glrt-...) dat u in Stap 2 heeft verkregen.
Het aantal gelijktijdige jobs dat u wilt toestaan.

Zodra u uw configuratie opslaat, maakt uw runner automatisch verbinding met GitLab en verschijnt deze als online op de Runners-pagina waar u hem heeft aangemaakt.

Stap 4: Voer uw eerste pipeline uit

Om te beginnen voegt u een .gitlab-ci.yml-bestand toe aan de root van uw repository:

stages:
  - build
  - test

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

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

Commit en push uw wijzigingen. GitLab zal een pipeline starten en uw Stackhero runner zal de jobs uitvoeren. Als u tags heeft toegevoegd bij het aanmaken van de runner, kunt u deze in uw jobs targeten zoals hieronder:

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

Dat is alles. Uw pipelines draaien nu op uw eigen dedicated runner, met onbeperkte build-minuten.

Volgende stap

Wilt u Docker-images bouwen en pushen vanuit uw pipelines? Ga dan verder met Docker-images bouwen.