GitLab Runner: Aan de slag

Verbind uw Stackhero GitLab Runner met GitLab.com, Stackhero for GitLab of uw eigen GitLab-server en voer uw eerste pipeline uit in enkele minuten

👋 Welkom bij de Stackhero-documentatie!

Stackhero biedt een eenvoudige GitLab Runner cloud oplossing waarmee u uw GitLab CI/CD-jobs efficiënt en zonder gedoe kunt uitvoeren. Dit kunt u verwachten:

• Onbeperkte CI/CD-minuten: voer uw pijplijnen zo vaak uit als nodig, zonder kosten per minuut of onverwachte extra kosten.
• Meerdere gelijktijdige jobs: versnel uw ontwikkeling door verschillende jobs parallel uit te voeren.
• De Docker executor met ondersteuning voor Docker-in-Docker: bouw en push eenvoudig container images als onderdeel van uw CI/CD-proces.
• Werkt naadloos met zowel GitLab.com als self-managed GitLab-omgevingen.
• Een privé, dedicated infrastructuur met snelle NVMe/SSD-opslag zorgt voor stabiele en voorspelbare build-prestaties.
• Beschikbaar in de regio's 🇪🇺 Europa en 🇺🇸 USA om aan de behoeften van uw team te voldoen.

Bespaar tijd: u kunt uw eerste GitLab Runner koppelen en binnen enkele minuten starten met het uitvoeren van pijplijnen!

Introductie

Een GitLab Runner is het agent dat uw GitLab CI/CD-jobs uitvoert. Telkens wanneer een pipeline draait, pikt de runner elke job op, voert deze uit in een geïsoleerde Docker-container en rapporteert de resultaten terug aan GitLab.

Met Stackhero draait uw runner altijd op private, dedicated infrastructuur. Er zijn geen kosten per minuut of gebruiksquota: uw CI/CD-minuten zijn onbeperkt. Afhankelijk van uw gekozen plan kan uw runner meerdere gelijktijdige jobs verwerken, waardoor het opschalen van uw buildcapaciteit eenvoudig is.

Deze handleiding helpt u om uw Stackhero runner te koppelen aan GitLab en snel uw eerste pipeline te laten draaien.

Stap 1: Maak uw GitLab Runner aan op Stackhero

Via uw Stackhero-dashboard kunt u een nieuwe GitLab Runner-service aanmaken en een plan kiezen dat past bij uw workflow. Het plan bepaalt uw beschikbare CPU, RAM en het aantal gelijktijdige jobs (overeenkomstig de concurrent-instelling van GitLab Runner: hoeveel jobs de runner parallel kan verwerken).

Uw runner is binnen ongeveer 2 minuten klaar voor gebruik.

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 en kiest daarbij ook de scope van de runner:

• 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 verwerkt, ook die zonder tags.

GitLab geeft u een runner authentication token dat begint met glrt-. Bewaar dit token veilig, want uw runner gebruikt het om zich te authenticeren bij GitLab.

De eerdere registration token-methode is verouderd. Gebruik het runner authentication token (glrt-...) dat wordt aangemaakt wanneer u de runner toevoegt, zoals hierboven beschreven.

Meer informatie vindt u in de officiële GitLab runner registratie documentatie.

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:

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

Nadat u uw configuratie heeft opgeslagen, maakt uw runner verbinding met GitLab en verschijnt deze als online op de Runners-pagina waar u hem heeft ingesteld.

Stap 4: Voer uw eerste pipeline uit

Voeg een .gitlab-ci.yml-bestand toe aan de root van uw repository om uw pipeline te definiëren:

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 start een pipeline en uw Stackhero runner voert de jobs uit. 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

Uw pipelines draaien nu op uw dedicated runner, met onbeperkte build-minuten en zonder gebruikslimieten om te beheren.

Volgende stap

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