Cosa succede dopo che GitLab scarica il codice?

Dopo che GitLab scarica il codice del repository nella directory di lavoro, inizia l'esecuzione del pipeline CI/CD definito nel file .gitlab-ci.yml.

1. Analisi di .gitlab-ci.yml: GitLab Runner (o GitLab stesso, se si utilizza CI integrato) legge la configurazione da .gitlab-ci.yml. Questo file descrive le fasi (stages) e i lavori (jobs) del pipeline.
2. Inizializzazione del Runner: Viene assegnato un GitLab Runner disponibile per eseguire il pipeline. Il Runner ottiene informazioni sul repository, sul commit, sul branch e sulla configurazione di .gitlab-ci.yml.
3. Creazione dell'ambiente di esecuzione: Il Runner prepara un ambiente per eseguire i lavori. Questo può essere:
   • Macchina virtuale
   • Contenitore (Docker, Kubernetes)
   • Server dedicato
   • Shell
4. Esecuzione delle fasi (stages): Il pipeline viene eseguito sequenzialmente per fasi, definite in .gitlab-ci.yml. I lavori in una stessa fase possono essere eseguiti in parallelo.
5. Esecuzione dei lavori (jobs): All'interno di ogni fase, vengono eseguiti i lavori configurati. Un lavoro include:
   • Definizione dell'immagine o dell'esecutore (executor), se non specificato a livello di pipeline o sezione variables.
   • Clonazione del repository (già fatta da GitLab, ma il Runner può eseguire git fetch o git checkout per lo stato necessario).
   • Ripristino della cache (se configurato) per accelerare la build (ad esempio, caricamento delle dipendenze).
   • Esecuzione degli script (script): È il contenuto principale del lavoro, dove vengono eseguiti comandi di build, test, analisi o deploy.
   • Caricamento degli artefatti (se configurato): I risultati del lavoro (ad esempio, binari compilati, report) vengono salvati per uso o download successivi.
   • Salvataggio della cache (se configurato) per accelerare le future esecuzioni.
6. Rapporto sullo stato: Il Runner invia lo stato di ogni lavoro (successo, errore, annullamento) a GitLab. L'utente vede il progresso e i risultati nella pagina del pipeline.
7. Passaggio alla fase successiva: Se tutti i lavori della fase corrente terminano con successo (o se allow_failure è impostato), inizia la fase successiva. Se un lavoro termina con errore e allow_failure non è impostato, l'intero pipeline viene interrotto.
8. Terminazione del pipeline: Dopo aver eseguito tutte le fasi (o in caso di errore), il pipeline termina. I risultati e gli artefatti sono disponibili tramite l'interfaccia web di GitLab.

Esempio di struttura di /.gitlab-ci.yml`:

// Definizione delle fasi del pipeline
stages:
  - build
  - test
  - deploy

// Lavoro di build nella fase build
build_job:
  stage: build
  image: docker:latest // Utilizzo di un'immagine Docker
  script:
    - echo "Costruendo l'applicazione..."
    - docker build -t myapp:$CI_COMMIT_SHORT_SHA . // Costruzione dell'immagine Docker
  artifacts:
    paths:
      - myapp.tar // Salvataggio dell'artefatto di build

// Lavoro di test nella fase test
test_job:
  stage: test
  image: python:3.9 // Utilizzo di un'immagine Python
  script:
    - echo "Esecuzione dei test..."
    - pip install -r requirements.txt
    - pytest // Esecuzione dei test
  needs: ["build_job"] // Dipende dal completamento con successo di build_job

// Lavoro di deploy nella fase deploy
deploy_job:
  stage: deploy
  image: ubuntu:latest // Utilizzo di un'immagine Ubuntu
  script:
    - echo "Deploy dell'applicazione..."
    - echo "Qui va lo script di deploy..." // Script di deploy
  only: // Eseguire solo su commit in master o tag
    - master
    - tags
  needs: ["test_job"] // Dipende dal completamento con successo di test_job

Quindi, il download del codice è solo il primo passo, seguito da un processo complesso di build, test e deploy automatizzato, basato sulla configurazione .gitlab-ci.yml.