Runbooks

Runbooks beschreiben wiederholbare Betriebsprozesse sowie manuelle Eingriffe in die Plattform.

Sie dienen als Referenz für Wartung, Recovery, Migrationen und Troubleshooting.

Zweck

Runbooks dokumentieren:

  • Wiederherstellungsprozesse

  • Wartungsarbeiten

  • Geplante Änderungen

  • Recovery-Szenarien

  • Manuelle Betriebsaufgaben

Ziel ist die reproduzierbare Durchführung betrieblicher Tätigkeiten.

Inhalte

Typische Themen:

  • Cluster Recovery

  • Storage Migrationen

  • Backup und Restore

  • Zertifikatsverwaltung

  • DNS Änderungen

  • Netzwerkumstellungen

  • Kubernetes Wartungsarbeiten

Struktur

Runbooks sollen folgende Eigenschaften besitzen:

  • Schritt-für-Schritt-Anleitungen

  • Klare Voraussetzungen

  • Verifizierbare Ergebnisse

  • Dokumentierte Rollback-Strategien

Kategorien

Plattform

Arbeiten an Kubernetes, Talos Linux, FluxCD und Plattformdiensten.

Storage

Migrationen, Wiederherstellungen und Wartungsarbeiten für persistente Daten.

Netzwerk

DNS, Routing, Gateway API, Pangolin und WireGuard.

Anwendungen

Service-spezifische Betriebsprozesse.

Richtlinien

Ein Runbook sollte mindestens folgende Abschnitte enthalten:

Überblick
Voraussetzungen
Durchführung
Verifikation
Rollback (optional)

Vorhandene Runbooks

Die verfügbaren Runbooks befinden sich in diesem Verzeichnis und den zugehörigen Unterverzeichnissen.

Neue Runbooks sollen thematisch passend einsortiert werden und nicht direkt in dieser Übersichtsseite verlinkt werden.

Die Navigation und Dokumentationsstruktur dienen als primärer Einstiegspunkt.