Support & Automatisierung

Runbook

Overview

Ein Runbook beschreibt, wie eine konkrete, wiederkehrende Aufgabe im IT-Betrieb erledigt wird: einen Dienst neu starten, ein Zertifikat erneuern, einen Server patchen oder auf einen bestimmten Monitoring-Alert reagieren. Es richtet sich an den Bearbeiter im Moment der Ausführung und soll auch Kollegen ohne Spezialwissen in die Lage versetzen, die Aufgabe korrekt zu erledigen.

Der Begriff hat zwei Bedeutungen. Im Betrieb ist ein Runbook ein Dokument, das manuell, teilautomatisiert oder vollautomatisiert ausgeführt wird. In Azure Automation heißt das ausführbare Skript selbst Runbook (PowerShell, Python oder grafisch), gestartet per Zeitplan, Webhook, Alarm oder manuell. In der Praxis wachsen beide zusammen: Aus einer bewährten manuellen Anleitung wird nach und nach ein automatisiertes Runbook.

Abgrenzung: Das IT-Betriebshandbuch ist der Rahmen, in dem Runbooks stehen. Eine Standard Operating Procedure ist verbindlicher und organisatorischer, sie legt einen freigegebenen Standardablauf fest, das Runbook beschreibt die technische Ausführung. Ein Playbook, etwa im Incident Response, steuert die Reaktion auf ein größeres Ereignis und verweist dabei auf mehrere Runbooks. Ein Knowledgebase-Artikel beschreibt die Lösung eines bereits aufgetretenen Problems.

Azure Automation unterstützt aktuell PowerShell 7.6, 7.4 und 5.1 sowie Python 3.10. Für Runbooks auf PowerShell 7.1 und 7.2 sowie Python 2.7 und 3.8 endete der Support am 30. September 2026.

How it works

Ein brauchbares Runbook ist kurz und folgt einem festen Aufbau:

  1. Auslöser: Wann es genutzt wird, z. B. Alarmname aus dem Monitoring, Ticketkategorie oder Termin im Wartungsfenster.
  2. Voraussetzungen: Berechtigungen, Werkzeuge, Zugangswege, betroffene Systeme und Abhängigkeiten.
  3. Schritte: Nummerierte Einzelhandlungen mit Befehl und erwarteter Ausgabe, damit der Bearbeiter nach jedem Schritt weiß, ob alles stimmt.
  4. Erfolgskontrolle und Rückweg: Woran der Erfolg erkennbar ist und wie eine Änderung zurückgenommen wird.
  5. Eskalation: Wen der Bearbeiter einbindet, wenn ein Schritt fehlschlägt, mit Verweis auf die Eskalationsmatrix.

Es gibt drei Automatisierungsstufen: manuell (der Bearbeiter folgt den Schritten), teilautomatisiert (Skripte für einzelne Schritte, die Entscheidung bleibt beim Menschen) und vollautomatisiert, etwa ein Azure-Automation-Runbook, das ein Azure-Monitor-Alarm über eine Aktionsgruppe startet. Für lokale Systeme führt ein Hybrid Runbook Worker unter Windows oder Linux die Runbooks im eigenen Netz aus, auch auf Azure-Arc-fähigen Servern.

Benefits

  • Seltene Aufgaben gelingen auch nachts und in Vertretung, weil der Bearbeiter nicht aus dem Gedächtnis arbeiten muss
  • Die Reaktion auf Alarme wird schneller, wenn im Alarm direkt der Link zum passenden Runbook steht
  • Gleiche Schritte führen zu gleichen Ergebnissen, dadurch werden Fehler nachvollziehbar und Ursachen leichter gefunden
  • Ein erprobtes manuelles Runbook ist die beste Vorlage für eine spätere Automatisierung

Practical example

Ein Kunststoffverarbeiter mit 180 Mitarbeitenden hat drei Admins in der Rufbereitschaft, nur einer kennt das ERP-System genau. Nachts fielen wiederholt die ERP-Anwendungsdienste aus, und die Bereitschaft musste jedes Mal den Kollegen wecken. Die IT schrieb ein Runbook mit Diagnosebefehlen, Neustart-Reihenfolge und Meldeweg an den ERP-Dienstleister und verlinkte es im Monitoring-Alert. Später wurde der Neustart als Azure-Automation-Runbook auf einem Hybrid Runbook Worker automatisiert, die Bereitschaft wird nur noch alarmiert, wenn der automatische Neustart scheitert.

Things to keep in mind

  • Jedes Runbook von einer zweiten Person probeweise ausführen lassen, bevor es im Ernstfall gilt, so fallen fehlende Schritte auf
  • Runbooks bei jeder Systemänderung im Change Request mit anpassen, eine veraltete Anleitung richtet mehr Schaden an als eine fehlende
  • Keine Zugangsdaten ins Runbook schreiben, in Azure Automation Managed Identities und die verschlüsselt gespeicherten Anmeldeinformationen des Automation-Kontos nutzen
  • Runbooks auch offline verfügbar halten, damit sie bei einem Ausfall von Wiki oder SharePoint erreichbar bleiben
  • Automatisierte Runbooks über die Quellcodeverwaltung versionieren und auf unterstützte Laufzeitversionen umstellen, bevor alte Versionen auslaufen

Conclusion

Runbooks machen Betriebswissen ausführbar, zuerst als Anleitung und später als Skript. Fang mit den Alarmen an, die am häufigsten nachts oder in Vertretung auflaufen.

Further reading

Related articles