Aggiornare un componente software può richiedere pochi secondi: basta cambiare un numero di versione in un file di configurazione. Capire che cosa succede al sistema dopo quel cambio, invece, richiede ingegneria. Questa è la storia di un’applicazione di un ente della Pubblica Amministrazione che aveva accumulato, negli anni, aggiornamenti rimandati, quello che in ambito informatico viene definito debito tecnico, oltre a diverse vulnerabilità di sicurezza. Un’applicazione che oggi è tornata a superare i controlli di qualità e sicurezza, i Quality Gate di SonarQube, senza fermare l’operatività.
“Basta cambiare la versione”
Si sente dire spesso: aggiornare i componenti di un software è un’attività banale. Si apre il file di configurazione, si cambia un numero, si rigenera il programma. Per chi lavora su sistemi giovani, con poche dipendenze e una buona copertura di test, a volte è davvero così.
Sui sistemi critici che vivono da anni è una mezza verità, e la metà mancante è quella che costa.
Ogni componente si porta dietro altri componenti, e ognuno ha un comportamento che il resto del sistema ha imparato a dare per scontato. Cambiare una versione significa cambiare quei presupposti, spesso in punti dell’architettura che nessuno guarda da tempo.
Il punto di partenza
L’applicazione su cui siamo intervenuti serve un ente della Pubblica Amministrazione. Con gli anni aveva accumulato debito tecnico: versioni datate di Java, Apache Axis e Spring Boot, le tecnologie alla base del suo funzionamento, mantenute perché “funzionavano”.
Il problema è emerso dall’analisi automatica del codice. SonarQube, lo strumento che analizza il codice e segnala i problemi, segnalava vulnerabilità di sicurezza che impedivano di superare i Quality Gate, cioè le soglie minime di qualità e sicurezza che il progetto si era dato. Non era più una questione di ordine del codice: il progetto non rispettava quelle soglie, e ogni nuova funzionalità sarebbe stata costruita sopra fondamenta che non superavano il controllo.
Un piano metodico, non un salto di versione
Abbiamo scartato l’idea di aggiornare tutto in un colpo solo. Abbiamo costruito invece un piano di correzione in tre movimenti:
- Analisi automatica del codice, per avere una mappa reale di vulnerabilità e bug prima di toccare qualsiasi componente.
- Aggiornamento progressivo delle tecnologie principali su cui si basa il software: Spring Boot, Java e il framework di integrazione Axis, un passaggio alla volta.
- Risoluzione sistematica delle vulnerabilità e dei bug emersi su SonarQube, verificando a ogni passo l’effetto sul Quality Gate.
La differenza rispetto all’alternativa più rapida è semplice: ogni passaggio veniva verificato prima di procedere con il successivo, mantenendo la possibilità di isolare le modifiche e intervenire in caso di malfunzionamenti su parti che prima funzionavano.
Il momento critico: quando il nuovo non è compatibile con il vecchio
Il punto più delicato è stato gestire le incompatibilità introdotte dagli aggiornamenti di componenti centrali, in particolare Apache Axis e Spring Boot. Il vincolo era doppio: i servizi esistenti dovevano continuare a funzionare con chi li utilizzava, e allo stesso tempo la sicurezza dei dati non poteva essere un compromesso accettato “fino a fine intervento”.
In questa fase i test automatizzati, cioè i controlli che verificano che il software faccia ancora ciò che deve, hanno smesso di essere una buona pratica e sono diventati lo strumento con cui decidere se un passaggio era concluso. Un aggiornamento era riuscito solo quando i test passavano e l’analisi di qualità non peggiorava
Cosa è cambiato
Il progetto ha superato i Quality Gate di SonarQube. Le vulnerabilità critiche segnalate dall’analisi sono state azzerate e la possibilità di sfruttare eventuali falle del sistema si è ridotta sensibilmente. Il codice è oggi più facile da mantenere e pronto a ricevere nuovi sviluppi, senza partire da un debito che cresce.
I dati arrivano dai report di analisi SonarQube, dai log di build e dalle metriche del Quality Gate del progetto.
Quello che ho imparato
Aggiornare i componenti centrali di un sistema senza verificare cosa succede è un rischio enorme. Test continui e analisi automatizzata della qualità non sono opzionali: sono strumenti indispensabili per individuare tempestivamente eventuali problemi ed evitare che un aggiornamento comprometta funzionalità già esistenti.
Il debito tecnico e le vulnerabilità non sono semplicemente elementi da correggere quando emerge il tempo necessario.
Sono fattori che condizionano la capacità di un sistema di evolvere, mantenere i propri livelli di sicurezza e sostenere le esigenze operative dell’organizzazione.
Per chi gestisce sistemi datati, la domanda utile non è se aggiornare, ma quanto si conosce davvero ciò che si sta per cambiare: quale parte del sistema reggerebbe oggi un aggiornamento e quali criticità emergerebbero soltanto in produzione?