GUIDA · CONTINUITÀ E DISASTER RECOVERY

Runbook operativi: come scriverli perché funzionino nel momento critico

Dopo questa guida saprai che cosa rende un runbook utilizzabile durante un'emergenza, come scriverlo passo dopo passo, come verificarlo con una persona che non lo ha scritto e come tenerlo aggiornato. Il documento deve essere eseguibile da chi è sotto pressione.

Aggiornata a ottobre 2026
7 min di lettura
Redazione Tecnica Altovar

1. Perché un runbook serve nel momento critico

Un runbook è una procedura operativa scritta per eseguire un compito specifico, come riavviare un servizio, ripristinare un database o isolare un computer compromesso. Nel momento critico la persona che lo usa è sotto pressione, magari non è quella che ha eseguito il compito l'ultima volta, e deve prendere decisioni rapide. Un buon runbook riduce le scelte a quelle necessarie e riduce gli errori, perché il lettore non deve ricostruire la sequenza da zero.

Il runbook è diverso dal piano di continuità e dal piano di disaster recovery. Questi definiscono cosa fare e chi decide; il runbook definisce come eseguire un singolo passo. Senza runbook, il piano resta un elenco di intenzioni. Con i runbook, ogni passo diventa verificabile e ripetibile da più persone, anche da chi non ha mai visto il sistema in funzione e deve arrivare a una risposta senza aiuto.

2. Prerequisiti

Prima di scrivere un runbook servono alcune condizioni. Il compito deve essere chiaro e circoscritto: un runbook che copre tutto il ripristino dell'azienda non è utilizzabile. Serve la persona che conosce davvero la procedura, perché scrivere senza osservarla produce passi sbagliati o incompleti. E serve un luogo di conservazione accessibile anche in emergenza, con una copia offline che non dipenda dalla rete interna o da un singolo computer.

Verifica infine gli accessi. Un runbook che richiede un account personale di chi non è disponibile, o una password custodita in un sistema non raggiungibile, non serve in quel momento. Le credenziali di emergenza vanno gestite a parte, con una procedura di accesso documentata e controllata. Il runbook indica dove trovarle e chi può autorizzarne l'uso, senza contenerle. In questo modo il documento può circolare senza esporre segreti.

3. Come scriverlo: i passi

Scrivi il runbook osservando un'esecuzione reale o simulata, poi riduci tutto a passi verificabili. Questa sequenza produce un documento uniforme, che è più facile da seguire sotto pressione. Il primo passo è sempre dichiarare a cosa serve il documento, perché senza scopo chiaro il lettore non sa se è quello giusto. Ogni passo successivo parte da questa base e deve restare coerente con essa.

Usa un linguaggio diretto e lo stesso formato per tutti i runbook dell'azienda. Il lettore non deve interpretare: deve eseguire, controllare il risultato e passare al passo successivo. Evita frasi generiche come «se necessario», che in emergenza non dicono nulla, e sostituiscile con condizioni osservabili. Ad esempio, invece di «verificare la connessione», scrivi cosa deve comparire sullo schermo e cosa fare se non compare.

  1. Definisci lo scopo in una frase e il risultato atteso al termine
  2. Indica quando usarlo e quando non usarlo, con i segnali che lo attivano
  3. Elenca i prerequisiti: accessi, strumenti e persone da avvisare
  4. Scrivi ogni passo come una sola azione, con il comando o la schermata da usare
  5. Aggiungi per ogni passo il risultato atteso e cosa fare se non si ottiene
  6. Segnala i punti di decisione in cui serve una conferma o un'autorizzazione
  7. Chiudi con le verifiche finali e con la comunicazione da fare

4. Errori comuni

Il primo errore è scrivere un runbook troppo generico, del tipo «verificare il servizio». Chi legge non sa cosa controllare né come. Il secondo è dare per scontato ciò che il lettore non sa: un percorso di menu, un nome di server, un'abbreviazione interna. Il terzo è non indicare cosa fare quando un passo fallisce, che è proprio la situazione per cui il runbook esiste. Un runbook che descrive solo il caso felice non ha valore nel momento critico.

Un altro errore frequente è conservare il runbook in un posto che non sarà raggiungibile durante l'emergenza, oppure lasciarlo aggiornare solo dalla persona che lo ha scritto. Quando questa persona cambia ruolo, il documento diventa un ricordo e nessuno sa più se è ancora valido. Anche le versioni duplicate creano confusione, perché in emergenza non è chiaro quale copia seguire.

5. Come verificare che funzioni

Un runbook si verifica eseguendolo. La prova migliore è affidarlo a una persona competente che non lo ha scritto, in un ambiente di prova, e osservare dove si ferma o dove esita. Ogni domanda che la persona fa è un punto da chiarire nel documento, e va riscritta finché la domanda non serve più. Questa prova è più utile di qualsiasi revisione fatta da chi conosce già la procedura, perché quella persona dà per scontate le stesse cose del lettore reale.

Misura anche il tempo di esecuzione e confrontalo con l'obiettivo del processo collegato. Un runbook corretto ma più lento dell'obiettivo va ripensato: spesso si possono anticipare le verifiche o preparare in anticipo gli accessi, così che il tempo in emergenza si riduca. Annota il tempo misurato nella scheda del runbook, insieme alla data della prova. Il tempo va confrontato con l'obiettivo a ogni revisione, non solo la prima volta.

6. Cosa fare dopo la prima versione

Ogni runbook va collegato a una data di revisione e a un responsabile. Le modifiche ai sistemi, come un aggiornamento o un cambio di fornitore, devono attivare la revisione dei runbook interessati. Dopo ogni incidente reale, verifica quali passi hanno funzionato e quali no, e aggiorna il documento con quanto emerso, senza aspettare la revisione periodica prevista. Le correzioni più urgenti sono quelle che hanno fatto perdere tempo durante un evento reale.

Ogni scheda di runbook dovrebbe riportare almeno questi elementi, così che chi la trova durante un'emergenza sappia subito se il documento è affidabile, quando è stato verificato l'ultima volta e a chi rivolgersi per un dubbio. Conviene collocarli nella prima parte del documento, prima di qualsiasi passo operativo, perché sono le informazioni che il lettore cerca per prime. Sono pochi campi, ma fanno la differenza:

  • Data dell'ultima verifica ed esito
  • Responsabile del documento e suo sostituto
  • Versione e registro delle modifiche
  • Collegamento al processo e al piano di riferimento
  • Posizione della copia offline

7. Come iniziare

Questa settimana scegli la procedura che il tuo team esegue più spesso sotto pressione, per esempio il riavvio di un servizio di posta o l'accesso di emergenza a un sistema. Chiedi alla persona che la esegue di mostrartela mentre la fa, e prendi nota di ogni passo, anche di quelli che sembrano ovvi. Le cose ovvie per chi esegue la procedura sono spesso proprio quelle che mancano nel documento.

Poi scrivi la prima versione seguendo la struttura della sezione tre, fallo leggere a un collega e registra le domande che ti fa. Quel primo runbook diventerà il modello per gli altri, e la sua verifica ti darà la misura del lavoro da fare. Conserva una copia offline già da questa prima versione. Una copia dimenticata sul proprio computer non serve a nulla quando il computer è fuori uso.

Domande frequenti

Qual è la differenza tra runbook e playbook?

Il termine runbook indica di solito una procedura operativa per un compito tecnico ripetibile, come riavviare un servizio. Il playbook è più spesso usato per scenari di risposta a un incidente, con più fasi, decisioni e attori coinvolti. Nella pratica i due termini si sovrappongono, e conta più la chiarezza del testo che il nome che gli dai.

Il runbook può essere automatizzato?

Alcuni passi possono essere automatizzati, ma l'automazione va introdotta con prudenza. Un passo automatico che fallisce in silenzio è più pericoloso di uno manuale. Prima di automatizzare, il runbook manuale deve essere stato verificato con successo. L'automazione va poi testata come qualsiasi altra modifica.

Quanto deve essere lungo un runbook?

Quanto basta a essere eseguito senza domande da una persona competente. Un compito semplice può stare in una pagina, uno più articolato può essere diviso in fasi. La lunghezza non è un indicatore di qualità: un runbook breve e preciso è migliore di uno lungo e ambiguo.

Chi deve scrivere i runbook?

Chi esegue la procedura, con la supervisione di un responsabile tecnico che controlla precisione e sicurezza. Il fornitore IT può contribuire per i sistemi che gestisce. Il testo finale deve essere verificato da una persona diversa da chi lo ha scritto, perché è lei che individua i salti logici e i passaggi dati per scontati.

Come si proteggono i runbook che contengono dettagli sensibili?

Non inserire password o chiavi nel testo. Il runbook indica dove trovare le credenziali di emergenza e chi può autorizzarne l'uso, ma le credenziali restano in una custodia separata e controllata. Limita l'accesso al documento a chi ne ha bisogno, e registra chi lo consulta quando il sistema lo consente.

Nota sul contenuto

Guida informativa di carattere generale. Norme e requisiti tecnici cambiano nel tempo: verifica sempre le fonti ufficiali e valuta il tuo caso specifico con un consulente tecnico o legale qualificato.

CONTATTACI

Parla con il nostro team.

Mostriamo come Altovar si integra nella tua infrastruttura. Nessun impegno, nessun sales pitch. Solo una conversazione tecnica.

PRENOTA UNA DEMO →