Deprecare e migrare: spegnere un sistema vecchio senza lasciare nessuno indietro

Come decidere se mantenere o ritirare un sistema, e come migrare gli utenti: il codice come passività, deprecazione con scadenza, migrazione graduale, rimozione solo a utilizzo azzerato.

Metodologiametodologiamigrazionedeprecazioneingegneria del software19 novembre 2026 · 3 min di lettura

Ogni riga di codice ha un costo di manutenzione: va letta, aggiornata, protetta, provata. Un sistema vecchio che nessuno ama ma che qualcuno usa ancora è un debito che cresce. Deprecare e migrare significa decidere con metodo quando ritirare qualcosa e come portare gli utenti altrove senza sorprese.

Il codice come passività

Il punto di partenza è un cambio di prospettiva: il codice non è un bene da conservare, è una passività da mantenere. Si tiene perché serve, non perché è già stato scritto. La domanda non è "possiamo spegnerlo?" ma "quanto costa tenerlo rispetto a ciò che dà?".

Decidere se ritirare

Alcune domande aiutano.

  • Chi lo usa ancora, e quanto? (Con dati di utilizzo, non con impressioni.)
  • Esiste un sostituto che copre davvero i casi d'uso, o solo quelli principali?
  • Quanto costa mantenerlo (tempo, rischio, competenze rare)?
  • Che cosa succede agli utenti rimasti, e a quali condizioni si possono accompagnare?

Se la risposta è "non lo sappiamo", il primo lavoro è misurare l'uso.

Il processo di deprecazione

1. Annunciare, con una data. Dire cosa viene ritirato, perché, che cosa lo sostituisce e entro quando. Un annuncio senza data non produce migrazioni.

2. Rendere possibile la migrazione. Fornire il percorso: guida, strumenti, esempi, supporto. Se migrare è difficile, gli utenti non lo faranno.

3. Segnalare l'uso. Il sistema vecchio avvisa chi lo usa (messaggi, intestazioni, log), così nessuno è colto di sorpresa.

4. Migrare gradualmente. Per gruppi, partendo dai più semplici o dai più collaborativi. Si tengono i due sistemi in parallelo per il tempo necessario, e si confrontano i risultati.

5. Spegnere quando l'uso è a zero (o quando l'uso residuo è deciso come accettabile). Non prima. Spegnere un sistema con utenti attivi è una interruzione di servizio.

6. Rimuovere. Si elimina il codice, la configurazione, la documentazione, i dati non più necessari (rispettando gli obblighi di conservazione). Il lavoro finisce quando il codice non c'è più, non quando l'avviso è stato inviato.

Il codice di compatibilità

Il codice che tiene vivo il vecchio comportamento per i vecchi utenti ha una data di fine: se non ce l'ha, diventa permanente. Si segna con un commento che dice chi lo usa e quando si toglie.

Segnali d'allarme

  • Un sistema "deprecato" senza data di spegnimento.
  • Nessuna misura dell'uso reale.
  • Un sostituto che non copre tutti i casi d'uso.
  • Spegnimento con utenti ancora attivi.
  • Codice di compatibilità senza scadenza.
  • Due sistemi in parallelo per anni.

Un esempio

Un'API interna di versione 1 è usata da undici servizi. Si misura l'uso: sette l'hanno già abbandonata, quattro no. Si annuncia lo spegnimento con una data, si prepara la guida di migrazione e si segue ciascuno dei quattro team. A una settimana dalla data l'uso è a zero: si spegne, poi si rimuove il codice.

Quando usarlo

Quando si rimuovono vecchi sistemi, API o funzionalità; quando si migrano utenti da una implementazione a un'altra; quando si decide se mantenere o ritirare il codice esistente.

Questo metodo deriva dalla famiglia di skill open source agent-skills di Addy Osmani (licenza MIT), riscritta e adattata.

Questo articolo è una skill di OIAR

Quello che hai letto è il contenuto di una skill del catalogo OIAR, scritto per le persone. Una conoscenza come questa ma più ricca e profonda, scritta per gli agenti, guida le interviste, l'analisi e il report dentro la piattaforma. Le skill si usano in OIAR: per provarla su un tuo progetto serve un account.

deprecation-and-migrationMetodo per ritirare un sistema e migrare gli utenti: codice come passività, misura dell'uso, annuncio con data, percorso di migrazione, avvisi, migrazione graduale, spegnimento a uso azzerato, rimozione completa. Usarla quando si decide se mantenere o ritirare codice, API o funzionalità.