---
title: Runbook Blueprint
description: Definiert, was ein Migrations-Runbook enthalten muss, wie es für die Delivery strukturiert wird und wie die Readiness vor Wellenläufen validiert wird.
sidebar:
  label: Runbook
  order: 7
source_url: "https://framework.stackit.cloud/de/migration/design-and-mobilize/design/runbook/"
source_file: "docs/de/migration/design-and-mobilize/design/runbook.mdx"
---

## Warum ein Runbook ein Design-Ergebnis ist

In diesem Framework wird das Runbook in der Design-Phase erstellt. Es beschreibt den geplanten
Ablauf, Controls, Rollback-Logik und Handover-Kriterien je Migrationsstrategie.

Migration Factory Setup erstellt nicht die erste Runbook-Version. Dort werden Design-Runbook-Entwuerfe
operativ gehärtet, standardisiert und für die Wellen-Delivery validiert.

## Pflicht-Kapitel eines Runbooks

Jedes Migrations-Runbook sollte diese Kapitel enthalten:

- **Scope und Kontext**: Scope der Anwendung, Kontext von Quelle und Ziel, Annahmen, Ausschlüsse.
- **Owner und Entscheidungsrechte**: Technischer Owner, Release-Owner, Rollback-Verantwortung, Eskalationsweg.
- **Abhängigkeiten und Voraussetzungen**: Plattform-Readiness, Zugriffe, Datenlage, externe Wartungsfenster.
- **Cutover-Plan**: Geordnete Run-Schritte, erwartete Dauer, Freeze-Punkte, Punkte für Kommunikation.
- **Validierungsprüfungen**: Funktionale, nicht-funktionale, Security- und Observability-Checks mit Nachweisen.
- **Rollback und Fallback**: Trigger-Bedingungen, Rollback-Schritte, Fallback-Kommunikationsfluss.
- **Handover und Day-1-Betrieb**: Übergabe an den Betrieb, Incident-Ownership, Post-Cutover-Stabilisierungsphase.

## Qualitätskriterien für ein gutes Runbook

<CardGrid>
  <Card title="Ausführbar">Schritte sind konkret, geordnet und klar Rollen zuweisbar.</Card>
  <Card title="Verifizierbar">
    Validierungspunkte definieren eindeutige Pass/Fail-Kriterien und benötigte Nachweise.
  </Card>
  <Card title="Wiederherstellbar">
    Der Rollback-Pfad ist vollständig, zeitlich geplant und an explizite Trigger-Bedingungen
    gekoppelt.
  </Card>
  <Card title="Handover-ready">
    Day-1-Betrieb und Ownership-Übergabe sind vollständig spezifiziert.
  </Card>
</CardGrid>

## Empfohlener Design-zu-Factory-Ablauf

<Steps>

1. Strategie-spezifischen Runbook-Entwurf in der Design-Phase erstellen.
2. Technische Annahmen mit Plattform-, Security- und Operations-Stakeholdern validieren.
3. Nachweis-Checkpoints und Rollback-Trigger ergänzen.
4. Zur Standardisierung und Readiness-Prüfung an Migration Factory Setup übergeben.
5. Nach Probe oder Pilot-Validierung für Wellen-Ausführung freigeben.

</Steps>

## Konkretes Beispiel-Asset

Nutzen Sie dieses konkrete Beispiel-Runbook für einen klassischen Rehost-Fall (Spring Boot auf VM):

<ScfAssetLoader
  showFilter={false}
  showSearch={false}
  frameworkSlug="migration"
  filterByTag={["runnable-example", "rehost", "vm"]}
  filterTagMode="all"
/>

- **Muster**: Lift-and-Shift auf Ziel-VM (kein Kubernetes)
- **Anwendungstyp**: Typischer Enterprise-Spring-Boot-Service mit PostgreSQL-Backend