Von Monolith zu Headless: Operation am offenen Herzen

Stellen Sie sich vor, Sie wollen den Motor eines Autos tauschen. Während es fährt. Auf der Autobahn. Das ist eine CMS-Migration. Der alte Monolith (Magento, Typo3) läuft noch und bringt Umsatz (Motor), aber Sie wollen ihn durch einen modernen Headless-Stack ersetzen.

Der größte Fehler, den CTOs machen: Der Big Bang Relaunch. "Wir bauen alles im Dunkeln neu, und am Tag X schalten wir um." Das geht fast immer schief. SEO stürzt ab. Umsatz bricht ein. Bugs überfluten den Support.

Die Lösung ist evolutionär: Das Strangler Fig Pattern (Würgefeigen-Muster). Man lässt den alten Baum (Monolith) stehen und lässt den neuen Baum (Headless) langsam darüber wachsen, bis der alte Baum stirbt.

Featured Snippet: Bei der Migration auf Headless gilt das Strangler Pattern als Goldstandard. Statt das alte System komplett abzuschalten ("Big Bang"), werden Features schrittweise (Route für Route) auf das neue System umgezogen. Ein Load Balancer (Proxy) entscheidet, ob der Nutzer die alte /shop Seite oder den neuen /blog sieht. So sinkt das Risiko eines Totalausfalls auf fast Null.

---

The Cost of Inaction: Code-Versteinerung

Wer nicht migriert, versteinert. Der alte Monolith wird immer schwerer zu warten ("Legacy Code"). Neue Entwickler wollen nicht mehr an PHP 5.6 Code arbeiten. Sicherheitslücken häufen sich. Eine Migration ist teuer, aber keine Migration ist auf Dauer tödlich (Insolvenz durch technische Obsoleszenz).

---

Phase 1: Die Strategie (Der Proxy-Layer)

Bevor Sie eine Zeile Frontend-Code schreiben, setzen Sie einen Reverse Proxy (z.B. NGINX oder Vercel Rewrites) vor Ihre Seite. Aktuell leitet er 100% des Traffics auf den alten Server. Aber er ist der "Weichensteller". Er gibt Ihnen die Macht, später zu sagen: "/blog geht ab heute auf den neuen Next.js Server."

Ohne diesen Layer ist keine sanfte Migration möglich.

---

Phase 2: Horizontal vs. Vertikal Slicing

Wie schneiden Sie den Elefanten?

Strategie A: Vertical Slicing (Empfohlen)

Sie nehmen einen kompletten Bereich. Z.B. den Blog. Sie bauen den Blog komplett neu (Headless CMS + Next.js). Sie schalten im Proxy um: /blog/* -> Neues System. Der Shop (/shop) läuft weiter auf dem alten System.

• Vorteil: Sie lernen mit einem risikoarmen Bereich. Wenn der Blog crasht, läuft der Shop weiter.

Strategie B: Horizontal Slicing (Layer)

Sie tauschen erst nur das Frontend (Headless), lassen aber das Backend alt. Oder Sie tauschen erst die Datenbank.

• Nachteil: Sehr komplex, da alte und neue APIs oft nicht kompatibel sind.

---

Phase 3: Daten-Migration (ETL)

Das Härteste. Wie kriegt man 10.000 Artikel aus WordPress in Contentful?

1. Extract: Exportieren Sie alles als XML/CSV.
2. Transform: Hier liegt die Arbeit.
   • WordPress hat HTML-Blobs (<p>Hallo <img src...></p>).
   • Contentful will JSON-Objekte ({ type: paragraph, content: ... }).
   • Sie müssen Skripte schreiben, die HTML parsen und in JSON umwandeln ("Rich Text Migration").
3. Load: Nutzen Sie die Management-API des neuen CMS, um die Daten zu importieren.

Tipp: Migrieren Sie nicht die User-Accounts (Passwörter!). Lassen Sie die Auth beim alten System (oder nutzen Sie Auth0), bis ganz zum Schluss. Passwörter zu migrieren ist ein Sicherheits-Albtraum.

---

Phase 4: Der SEO-Safe-Switch

Der gefährlichste Moment: Go-Live. Google hasst es, wenn URLs sich ändern oder 404 werden.

• URL-Struktur beibehalten: Wenn der alte Artikel /blog/hallo-welt.html hieß, muss er im neuen System auch so heißen (oder einen 301 Redirect haben).
• Meta-Tags: Prüfen Sie, ob Title/Description 1:1 identisch sind.
• Performance: Das neue System muss mindestens so schnell sein wie das alte (Core Web Vitals). Headless ist hier meist im Vorteil.

---

Unasked Question: "Wie lange laufen beide Systeme parallel?"

Oft 6 bis 18 Monate. Das ist okay. Sie haben temporär doppelte Hosting-Kosten. Aber das ist die "Versicherungsprämie" dafür, dass Ihr Business weiterläuft. Schalten Sie den alten Monolithen erst ab, wenn wirklich alles (auch die "vergessene" Landingpage von 2018) migriert ist.

---

FAQ: Headless Migration