Come configurare Ci/Cd con Ollama (Passo dopo Passo) Agent 101

📖 7 min read•1,258 words•Updated Apr 4, 2026

Come Configurare CI/CD con Ollama (Passo dopo Passo)

Molto bene, andiamo dritti al sodo. Configurare CI/CD con Ollama potrebbe sembrare complicato all’inizio, ma a dire il vero, non è così male una volta che hai capito come funziona. In questo tutorial, ti guiderò passo dopo passo per mettere tutto in piedi, garantendoti che potrai distribuire le tue applicazioni automaticamente come un professionista – e sì, rendere la tua vita molto più facile nel processo.

Ciò che Costruiremo e Perché È Importante

Creeremo un pipeline efficace utilizzando Ollama per l’integrazione e il deployment continui (CI/CD), il che automatizzerà il processo di test e distribuzione del codice. Questo è cruciale perché garantisce che ogni modifica venga validata, liberandoti così le serate da quel terribile panico del deployment all’ultimo minuto.

Prerequisiti

Ollama installato sul tuo sistema (controlla l’ultima versione su la documentazione ufficiale)
Python 3.11+
Node.js 14+ (se stai lavorando con progetti basati su JavaScript)
Un repository GitHub o qualsiasi altro sistema di controllo versione
Uno strumento CI/CD a tua scelta che supporti Ollama (GitHub Actions, GitLab CI, ecc.)

Passo 1: Installare Ollama

Per iniziare a utilizzare Ollama, devi prima installarlo. Questo passaggio è importante perché Ollama non appare magicamente. Devi effettivamente scaricare e installare il software. Ecco come puoi farlo.

curl -sSL https://ollama.com/install.sh | sh

Se incontri problemi, assicurati che il comando curl sia disponibile nel tuo terminale. Altrimenti, potrebbe essere necessario installarlo con il tuo gestore di pacchetti. Potresti riscontrare problemi di permesso; in tal caso, prova a eseguirlo con sudo.

Passo 2: Configurare il Tuo Repository Git

Non puoi usare CI/CD senza un repository di codice. Creiamo un repository Git se non ne hai già uno. Questo è cruciale perché è qui che vive il tuo codice e qui che CI/CD monitorerà le modifiche.

git init your-project
cd your-project
git add .
git commit -m "Commit iniziale"

Assicurati di aggiungere un file README.md per avere un’idea chiara di cos’è il tuo progetto. Questo può sembrare un piccolo dettaglio, ma può farti risparmiare tempo a te e agli altri nel lungo periodo. E sì, ho dimenticato questo passaggio troppe volte in passato.

Passo 3: Configurare Ollama nel Tuo Progetto

Ollama funziona tramite un file di configurazione chiamato ollama.yaml. Devi configurarlo affinché Ollama sappia quali azioni intraprendere quando si verificano modifiche nel tuo repository di codice. Ecco un semplice esempio che puoi utilizzare:

name: MyOllamaCI
version: 1.0
jobs:
 build:
 runs-on: ubuntu-latest
 steps:
 - name: Checkout code
 uses: actions/checkout@v2
 - name: Set up Python
 uses: actions/setup-python@v2
 with:
 python-version: '3.11'
 - name: Install dependencies
 run: |
 pip install -r requirements.txt
 - name: Run tests
 run: |
 python -m unittest discover

Avere un file come questo può farti brillare gli occhi, ma credimi, è il tuo piano per l’automazione. Assicurati di adattarlo in base alle tue esigenze e dipendenze specifiche.

Passo 4: Creare il Tuo Pipeline CI/CD

Ora che Ollama è configurato, vorrai creare un pipeline che ascolti i cambiamenti nel tuo repository. Questa parte è cruciale perché automatizza le fasi di test e distribuzione. Quando pubblichi nuovo codice, il pipeline si metterà al lavoro. Il codice appare così:

name: CI/CD Pipeline
on:
 push:
 branches:
 - main
jobs:
 build:
 runs-on: ubuntu-latest
 steps:
 - name: Checkout code
 uses: actions/checkout@v2
 - name: Set up Python
 uses: actions/setup-python@v2
 with:
 python-version: '3.11'
 - name: Install dependencies
 run: |
 pip install -r requirements.txt
 - name: Run tests
 run: |
 python -m unittest discover
 - name: Deploy
 run: |
 echo "Deploying to production!"

Quando registri le tue modifiche, il pipeline si attiva, installando le dipendenze, eseguendo i test e poi distribuendo la tua applicazione! Tuttavia, fai attenzione perché un deploy errato può portare a variabili d’ambiente mancanti in produzione. Puoi sempre configurarli nell’interfaccia di amministrazione della tua piattaforma di hosting.

Passo 5: Gestione degli Errori

Quindi, per quanto possa sembrare incredibile questo processo, incontrerai degli ostacoli. Ecco una panoramica degli errori più comuni che potresti incontrare e come risolverli:

Errori di Dipendenza: Se le tue dipendenze non vengono trovate, controlla il tuo file requirements.txt e assicurati che i pacchetti specificati siano installati nel tuo ambiente.
Test Falliti: I test unitari falliscono spesso a causa di un semplice errore di battitura o di dipendenze obsolete. Esegui i test localmente prima di pubblicare il tuo codice per assicurarti che passino.
Fallimento del Deploy in Produzione: Questo potrebbe essere dovuto a variabili d’ambiente mancanti necessarie durante la fase di deployment. Conferma che siano configurate correttamente sulla tua piattaforma di hosting.

Le Insidie

Ci sono diverse cose che possono nuocerti in produzione che la maggior parte dei tutorial non menziona. Ecco alcune delle mie preferite:

Mismatch di Ambiente: Il tuo ambiente locale può funzionare perfettamente, ma la produzione può essere una bestia diversa. Prova sempre in un ambiente che imita la produzione il più vicino possibile.
File Ignorati: Assicurati che il tuo file .gitignore non escluda file di cui hai realmente bisogno in produzione (come il tuo ollama.yaml o file di configurazione sensibili).
Problemi di Controllo di Versione: Se hai più branch, assicurati di sviluppare nella giusta. Pubblicare nel branch sbagliato può causare comportamenti imprevisti.

Esempio di Codice Completo

Ecco l’interezza di ciò che abbiamo costruito finora in un pezzo coerente. Quando lo metti insieme, dovrebbe apparire così:

name: CI/CD Pipeline
on:
 push:
 branches:
 - main
jobs:
 build:
 runs-on: ubuntu-latest
 steps:
 - name: Checkout code
 uses: actions/checkout@v2
 - name: Set up Python
 uses: actions/setup-python@v2
 with:
 python-version: '3.11'
 - name: Install dependencies
 run: |
 pip install -r requirements.txt
 - name: Run tests
 run: |
 python -m unittest discover
 - name: Deploy
 run: |
 echo "Deploying to production!"

Qual È il Prossimo Passo

Se ti senti avventuroso, questo è il momento di integrare Ollama con altri strumenti! Ti consiglio vivamente di esplorare strumenti di osservabilità (come Prometheus) per tenere d’occhio le prestazioni della tua applicazione dopo il deploy. Questo ti fornisce dati su tutto ciò di cui il tuo pipeline CI/CD ha bisogno per migliorare nel tempo.

FAQ

D: Cosa fare se i miei test sono poco affidabili?

R: I test poco affidabili possono essere un incubo, soprattutto quando passano a volte e falliscono altre. Controlla le condizioni di concorrenza, le dipendenze sul tempo o i servizi esterni che potrebbero non essere sempre disponibili. Isola i tuoi test il più possibile.

D: Posso usare Ollama con altri strumenti CI/CD?

R: Assolutamente! Sebbene gli esempi forniti qui si concentrino su GitHub Actions, Ollama può funzionare con strumenti come GitLab CI, CircleCI o Jenkins. Segui semplicemente la documentazione per la configurazione specifica dello strumento che hai scelto.

D: Come faccio a sapere quando il mio pipeline CI/CD ha fallito?

R: La tua piattaforma di solito ti notificherà via email o tramite il dashboard quando un job fallisce. Assicurati che le notifiche siano attivate affinché tu venga informato dei problemi non appena si verificano.

Funzionalità	Ollama	GitLab CI	Jenkins
Stars	165,553	135,959	36,024
Forks	15,055	35,893	14,138
Problemi Aperti	2,682	1,579	2,915
Licenza	MIT	MIT	MIT
Ultimo Aggiornamento	2026-03-19	2023-04-12	2023-05-25

Scegliere uno strumento CI/CD che soddisfi le tue esigenze è cruciale. Ollama è migliore di GitLab CI per i piccoli progetti grazie alla sua semplicità, mentre Jenkins ha il suo posto in ambienti aziendali più ampi.

Se non l’hai capito, sono un grande fan di Ollama. È quasi infallibile se segui questi passaggi. Ti fa chiedere come hai fatto a sopravvivere senza di esso.

Dati a partire dal 19 marzo 2026. Fonti: Ollama Stats, GitLab, Jenkins.

Come configurare Ci/Cd con Ollama (Passo dopo Passo)