Runbooks mit Auslöser, Voraussetzungen, Prüfschritten und Rückweg strukturieren, damit sie im Betrieb tatsächlich nutzbar sind.
Für wen ist das hilfreich? Teams, die wiederkehrende Betriebsaufgaben und Störungen nachvollziehbar dokumentieren möchten.
Einsatzfälle und Einordnung
Ein Runbook beschreibt eine konkrete Aufgabe für eine bestimmte Ausgangslage. Es ist weder eine allgemeine Produktdokumentation noch eine Sammlung unkommentierter Befehle. Eine Person mit den vereinbarten Grundkenntnissen sollte erkennen können, wann das Runbook passt und wann sie Unterstützung benötigt.
Besonders wichtig sind erkennbare Grenzen: benötigte Berechtigungen, Auswirkungen auf Nutzer und Abbruchbedingungen. Kommandos mit schreibender Wirkung werden von reinen Prüfungen getrennt. Geheimnisse gehören in einen vorgesehenen sicheren Speicher, nicht in die Anleitung.
Vorgehen im Detail
- Zweck und Auslöser beschreiben. Betroffene Anwendung, Umgebung, Zuständigkeit und Voraussetzungen angeben.
- Schritte mit erwartetem Ergebnis formulieren. Für Abweichungen einen nächsten Prüfpunkt oder eine Eskalation nennen, statt stillschweigend Erfolg vorauszusetzen.
- Ergebnisprüfung und Rückweg ergänzen. Das Runbook durch eine zweite Person in einer geeigneten Umgebung erproben und notwendige Korrekturen übernehmen.
Ergebnisse auf einen Blick
- Klarer Geltungsbereich und erkennbare Voraussetzungen
- Schritte mit überprüfbaren Zwischenergebnissen
- Benannte Abbruch- und Eskalationsbedingungen
- Verantwortlichkeit für Pflege und erneute Prüfung
Gut vorbereitet entscheiden
Eine sinnvolle Gliederung lautet: Zweck, Auslöser, Voraussetzungen, Prüfung, Durchführung, Erfolgskontrolle, Rückweg und Eskalation. Ergänzen Sie Links zu Architektur und weiterführenden Anleitungen.
Notieren Sie, mit welchem Stand das Verfahren geprüft wurde. Ändern sich Anwendungen oder Berechtigungen, ist eine erneute Prüfung sinnvoll. Ein Datum allein beweist nicht, dass die Anleitung noch funktioniert.
Fragen und Antworten
Soll ein Runbook alle möglichen Fehler abdecken?
Es sollte die häufigen und relevanten Fälle abdecken. Für unbekannte Zustände sind sichere Abbruch- und Eskalationswege wichtiger als spekulative Befehlsfolgen.
Wie detailliert müssen Befehle beschrieben werden?
So, dass Zielumgebung, Parameter, erwartete Wirkung und Risiken verständlich sind. Wiederverwendbare Platzhalter dürfen nicht mit echten Geheimnissen verwechselt werden.