GitLab Runner: Guida introduttiva

Collega il tuo Stackhero GitLab Runner a GitLab.com, Stackhero for GitLab o al tuo server GitLab personale ed esegui la tua prima pipeline in pochi minuti

👋 Benvenuto nella documentazione di Stackhero!

Stackhero offre una soluzione GitLab Runner cloud semplice che rende l'esecuzione dei tuoi job GitLab CI/CD efficiente e senza complicazioni. Ecco cosa puoi aspettarti:

• Minuti CI/CD illimitati: esegui le tue pipeline tutte le volte che vuoi, senza costi al minuto o spese impreviste.
• Più job in contemporanea: accelera lo sviluppo eseguendo diversi job in parallelo.
• L'executor Docker con supporto Docker-in-Docker: costruisci e pubblica facilmente immagini container come parte del tuo processo CI/CD.
• Funziona perfettamente sia con GitLab.com che con istanze GitLab self-managed.
• Un'infrastruttura privata e dedicata con storage NVMe/SSD veloce garantisce prestazioni di build stabili e prevedibili.
• Disponibile nelle regioni 🇪🇺 Europa e 🇺🇸 USA per soddisfare le esigenze del tuo team.

Risparmia tempo: puoi collegare il tuo primo GitLab Runner e iniziare a eseguire pipeline in pochi minuti!

Introduzione

Un GitLab Runner è l'agente che esegue i job CI/CD di GitLab. Ogni volta che viene eseguita una pipeline, il runner prende in carico ogni job, lo esegue all'interno di un container Docker isolato e riporta i risultati a GitLab.

Con Stackhero, il tuo runner viene sempre eseguito su infrastruttura privata e dedicata. Non ci sono costi al minuto né limiti di utilizzo: i tuoi minuti CI/CD sono illimitati. In base al piano scelto, il runner può gestire più job in parallelo contemporaneamente, rendendo semplice aumentare la capacità di build.

Questa guida ti aiuta a collegare il tuo runner Stackhero a GitLab e a far partire rapidamente la tua prima pipeline.

Passaggio 1: Crea il tuo GitLab Runner su Stackhero

Dal tuo dashboard Stackhero, puoi creare un nuovo servizio GitLab Runner e scegliere il piano più adatto al tuo workflow. Il piano determina le risorse CPU, RAM e il numero di job concorrenti (corrispondente all'impostazione concurrent di GitLab Runner: quanti job il runner può gestire in parallelo).

Il tuo runner sarà pronto all'uso in circa 2 minuti.

Passaggio 2: Crea un runner in GitLab

Il runner si collega a GitLab tramite un runner authentication token. Questo token viene generato su GitLab e puoi anche scegliere l'ambito del runner:

• Project runner: Apri il tuo progetto, poi vai su Settings > CI/CD > Runners > New project runner.
• Group runner: Apri il tuo gruppo, poi vai su Settings > CI/CD > Runners > New group runner.
• Instance runner (solo per GitLab self-managed): Vai su Admin area > CI/CD > Runners > New instance runner.

Durante la creazione del runner puoi:

• Aggiungere tag (come docker o stackhero) per indirizzare questo runner dai tuoi job.
• Permettere di eseguire job senza tag se desideri che gestisca tutti i job, anche quelli senza tag.

GitLab fornirà un runner authentication token che inizia con glrt-. Conserva questo token in modo sicuro, poiché il runner lo utilizza per autenticarsi con GitLab.

Il precedente flusso basato sul registration token è deprecato. Utilizza il runner authentication token (glrt-...) creato quando aggiungi il runner, come descritto sopra.

Puoi trovare maggiori dettagli nella documentazione ufficiale di registrazione dei runner GitLab.

Passaggio 3: Collega il tuo runner

Torna al tuo dashboard Stackhero, apri la configurazione del servizio GitLab Runner e inserisci i seguenti dati:

• GitLab URL: Usa https://gitlab.com per GitLab.com, oppure l'URL della tua istanza GitLab self-managed. (Se stai utilizzando GitLab su Stackhero, potrebbe essere https://git.tua-azienda.com.)
• Runner authentication token (glrt-...) ottenuto al Passaggio 2.
• Numero di job concorrenti che desideri consentire.

Dopo aver salvato la configurazione, il runner si collegherà a GitLab e apparirà come online nella pagina Runners dove lo hai configurato.

Passaggio 4: Esegui la tua prima pipeline

Aggiungi un file .gitlab-ci.yml nella root del tuo repository per definire la 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

Effettua il commit e il push delle modifiche. GitLab avvierà una pipeline e il tuo runner Stackhero eseguirà i job. Se hai aggiunto dei tag durante la creazione del runner, puoi indirizzarli nei tuoi job in questo modo:

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

Le tue pipeline ora vengono eseguite sul tuo runner dedicato, con minuti di build illimitati e senza limiti di utilizzo da gestire.

Passaggio successivo

Se desideri creare e pubblicare immagini Docker dalle tue pipeline, puoi proseguire con Creazione di immagini Docker.