GitLab Runner: Prime configurazioni

Collega il tuo Stackhero GitLab Runner a GitLab.com o a una istanza GitLab self-managed ed esegui la tua prima pipeline

👋 Benvenuto nella documentazione di Stackhero!

Stackhero ti offre una soluzione GitLab Runner cloud facile da usare, progettata per gestire in modo efficiente i tuoi job GitLab CI/CD. Ecco cosa puoi aspettarti:

• Minuti CI/CD illimitati: nessuna fatturazione al minuto, le tue pipeline possono essere eseguite ogni volta che ne hai bisogno.
• Job concorrenti multipli: esegui più job contemporaneamente per velocizzare l'intera pipeline.
• Docker executor con supporto Docker-in-Docker: semplifica la creazione e il push delle tue immagini container.
• Compatibile sia con GitLab.com che con qualsiasi istanza GitLab self-managed.
• Una VM privata e dedicata alimentata da dischi NVMe/SSD veloci per build affidabili e costanti.
• Disponibile sia nelle regioni 🇪🇺 Europa che 🇺🇸 USA.

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

Introduzione

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

Con Stackhero, il tuo runner opera su una VM privata e dedicata. Non ci sono costi al minuto né limiti di utilizzo, e le tue minuti CI/CD sono illimitate. In base al piano scelto, il runner può gestire decine di job concorrenti contemporaneamente.

Questa guida ti accompagna nella connessione del tuo runner Stackhero a GitLab in pochi minuti.

Passo 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 alle tue esigenze. Il piano determina la CPU, la RAM disponibili e il numero di job concorrenti (che corrisponde all'impostazione concurrent di GitLab Runner, ovvero il numero di job che possono essere eseguiti simultaneamente).

Il tuo runner sarà operativo in circa 2 minuti.

Passo 2: Crea un runner in GitLab

Il tuo runner si collega a GitLab tramite un runner authentication token. Questo token viene generato su GitLab, dove puoi anche definire l'ambito del runner:

• Project runner: Apri il tuo progetto, quindi vai su Settings > CI/CD > Runners > New project runner.
• Group runner: Apri il tuo gruppo, quindi 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 facilitare la selezione di questo runner nei tuoi job.
• Permettere l'esecuzione di job senza tag se desideri che il runner prenda in carico tutti i job.

GitLab ti fornirà un runner authentication token che inizia con glrt-. Assicurati di conservare questo token in modo sicuro, poiché viene utilizzato dal runner per autenticarsi.

Il vecchio flusso con il registration token è deprecato. Utilizza il runner authentication token (glrt-...) creato insieme al runner, come descritto sopra.

Passo 3: Collega il tuo runner

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

• La tua GitLab URL: Usa https://gitlab.com per GitLab.com, oppure l'URL della tua istanza GitLab self-managed (ad esempio, se stai utilizzando GitLab su Stackhero, potrebbe essere https://git.tua-azienda.com).
• Il runner authentication token (glrt-...) ottenuto al Passo 2.
• Il numero di job concorrenti che desideri consentire.

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

Passo 4: Esegui la tua prima pipeline

Per iniziare, aggiungi un file .gitlab-ci.yml nella root del tuo 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

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

Ecco fatto. Le tue pipeline ora vengono eseguite sul tuo runner dedicato, con minuti di build illimitati.

Prossimo passo

Vuoi costruire e pubblicare immagini Docker dalle tue pipeline? Continua con Building Docker images.