Engineering
CI/CD pipeline setup: dal commit alla produzione senza ansia
Le fasi, i controlli e la strategia di rollback dietro una CI/CD pipeline che permette a team piccoli di fare deploy ogni giorno con serenità. Senza dover tenere d'occhio tutto manualmente.
TL;DR
Una CI/CD pipeline ben strutturata trasforma il deployment da rito manuale a evento in background. Si fa il build una volta sola, si promuove lo stesso artifact, e il rollback diventa un'operazione di prima classe.

La differenza tra un team che rilascia ogni giorno e uno che teme ogni release di solito non è il talento. È la pipeline. Una CI/CD pipeline ben costruita trasforma il deployment in un evento in background che avviene in silenzio, decine di volte al giorno, senza che nessuno trattenga il fiato.
Continuous integration: fallire subito, fallire in modo evidente
La CI gira su ogni push e pull request. Il suo compito è intercettare i problemi prima che raggiungano chiunque altro. Eseguire queste fasi in ordine, dalla più veloce alla più lenta:
- Controlli di lint e formattazione. Feedback istantaneo. Non c'è motivo di aspettare.
- Controlli di tipo. Con TypeScript, un errore di tipo intercetta un'intera classe di bug prima che venga eseguito un singolo test.
- Unit e integration test. La rete di sicurezza principale. Mantenerli veloci in modo che nessuno li aggiri.
- Build. Verificare che l'applicazione si compili effettivamente in un artifact deployabile.
L'ordine conta più di quanto la maggior parte dei team realizzi. Se un errore di lint deve attendere dieci minuti mentre gira l'intera suite di test, le persone smettono di correggere il lint. Mantenere l'esecuzione totale sotto i dieci minuti. Oltre quella soglia, gli sviluppatori iniziano a fare il merge comunque e a controllare dopo, il che vanifica lo scopo.
Build una volta sola, promuovere lo stesso artifact
Uno degli errori più comuni nella CI/CD è ricompilare l'applicazione separatamente per staging e produzione. Si costruisce invece un unico artifact. Un'immagine Docker funziona bene per questo: si tagga con il commit SHA, si fa il push una volta sola, e si promuove quell'immagine esatta attraverso ogni ambiente. Se ha superato i test in staging, gli stessi byte identici vanno in produzione. La classe di bug del tipo "funzionava in staging" scompare quasi completamente.
Questo rende anche i rollback più veloci e prevedibili, perché si torna sempre a un'immagine già eseguita, non si ricompila qualcosa da un commit precedente.
Continuous delivery: automatizzare la routine, presidiare ciò che conta
Il merge su main dovrebbe attivare un deploy automatico sullo staging per la maggior parte dei team. La produzione può restare un passo approvato indietro, oppure essere completamente automatizzata quando si ha fiducia nella copertura dei test. Il principio è che il deployment è uno script, non un runbook che qualcuno segue a mano alle 23.
Utilizzare una strategia di rollout sicura in modo che una release problematica non mandi tutto giù contemporaneamente:
- Blue-green deployment mantengono la versione precedente attiva. Se qualcosa va storto, il traffico torna indietro in pochi secondi.
- Canary release inviano una piccola percentuale di traffico reale alla nuova versione, permettono di monitorare error rate e latenza, e procedono solo se le metriche reggono.
La scelta dipende dall'infrastruttura e dalla propensione al rischio. Il canary fornisce più segnali prima del rollout completo; il blue-green è più semplice da gestire. Entrambi sono meglio che fare il deploy al 100% degli utenti in una volta sola e sperare per il meglio.
Il rollback come operazione di prima classe
Prima o poi tutto si rompe. Ciò che distingue i team sereni da quelli nel panico è la velocità di recupero. Il rollback dovrebbe essere un unico comando ben testato che ripristina l'ultima versione funzionante in meno di un minuto. Se il ripristino è complesso, manuale o lento, si esiterà esattamente nel momento in cui la velocità è più importante.
Esercitarsi. Eseguire una prova di rollback un pomeriggio di martedì, non durante un incidente. I team che non hanno mai praticato il rollback lo scoprono nel modo peggiore: il comando è rotto, nessuno sa dove si trova, oppure funziona per il codice applicativo ma non per le migration del database. Trattarlo come una prova antincendio.
Per le migration del database in particolare: preferire modifiche additive e retrocompatibili ogni volta che è possibile. Una nuova colonna che il vecchio codice ignora è sicura da deployare prima dell'applicazione. Eliminare una colonna che il vecchio codice legge ancora non lo è. Questo vincolo determina come si struttura la migration, non come si struttura il deployment.
Proteggere la pipeline stessa
Due regole prevengono la maggior parte dei disservizi auto-inflitti. Prima: i secret non vanno mai incorporati nelle immagini né devono emergere nei log di build. Si iniettano a runtime da un secrets manager. Seconda: proteggere il branch main richiedendo che i controlli CI siano superati e almeno una revisione prima del merge. La pipeline è l'unico percorso verso la produzione, e nessuno può aggirarla.
Insieme, queste regole rendono la pipeline autorevole. Se passa, si rilascia. Se fallisce, nulla si muove. Questa chiarezza è ciò che rende i deploy quotidiani noiosi anziché coraggiosi.
Iniziare con il minimo che aiuta davvero
Non serve tutto il giorno uno. Si parte con test automatizzati su ogni pull request e uno script di deploy in un solo comando. Si aggiungono canary rollout e monitoring in produzione man mano che le esigenze crescono. Anche una pipeline essenziale (test più deploy automatizzato) cambia il modo di lavorare di un team, perché "ho rotto qualcosa?" smette di essere una paura e diventa un fatto a cui risponde la macchina.
Se i rilasci comportano ancora passaggi manuali e momenti di ansia, parliamone.
Domande frequenti
quanto tempo dovrebbe impiegare una ci/cd pipeline per completarsi
Meno di dieci minuti per l'esecuzione completa. Oltre quella soglia, gli sviluppatori iniziano a saltarla o a distrarsi. Eseguire prima i controlli meno costosi permette di far emergere un errore di lint in pochi secondi, non dopo l'intera suite di test.
devo ricompilare l'applicazione per ogni ambiente
No. Si fa il build di un unico artifact, idealmente un'immagine Docker, e si promuove esattamente la stessa immagine dallo staging alla produzione. Build separati significano modalità di errore separate, ed è da lì che nascono i bug del tipo "funzionava in staging".
quando il deploy in produzione dovrebbe essere completamente automatizzato
Quando la copertura dei test è significativa e si dispone di canary release o blue-green deployment. Nel frattempo, si automatizza il deploy sullo staging e si mantiene la produzione un'approvazione manuale indietro.
come si proteggono i secret in una ci/cd pipeline
I secret non vanno mai incorporati nelle immagini né devono comparire nei log di build. Si iniettano a runtime da un secrets manager come AWS Secrets Manager, HashiCorp Vault, o l'equivalente della propria piattaforma. Questo vale anche per le API key usate durante il build stesso.
Come può aiutare Pykero
Servizi collegati a questo articolo.
State costruendo qualcosa di simile?
Pykero Agency progetta e rilascia prodotti web, mobile, SaaS e AI pronti per la produzione.
Parliamone


