Schrittweise Migration

Der sichere Weg ist der schrittweise. Ihre öffentliche Website läuft unverändert weiter, während Sie jeden Teil in Development anbinden und prüfen.

Die Regeln, die es sicher halten

• Das Design darf sich nicht ändern. Jede Seite muss identisch aussehen, ob Atlas Inhalte dafür hat oder nicht.
• Ein Fallback ist Pflicht. Wenn Atlas nicht erreichbar ist oder für eine Seite nichts veröffentlicht ist, liefert die Site ihre integrierten Inhalte aus.
• Text, nie HTML. CMS-Werte werden als Text oder über Ihre Komponenten gerendert.
• Zuerst Development. Nichts erreicht Production, bis ein Release seine Prüfungen besteht und eine Person es freigibt.

Stufe 1: eine Seite anbinden (etwa ein Tag)

1. Erstellen Sie die Site in Studio und entwerfen Sie einen minimalen Contract mit einem Seitentyp.
2. Folgen Sie Eine Next.js-Website anbinden.
3. Veröffentlichen Sie diese eine Seite in Development und vergleichen Sie sie mit der Live-Seite.

Fertig, wenn die Seite aus Atlas gerendert wird, gleich aussieht und auch mit abgeschaltetem Atlas funktioniert.

Stufe 2: die ganze Site modellieren

1. Listen Sie jede Route auf, die die Site ausliefert, und ordnen Sie jede einem Seitentyp zu.
2. Schreiben Sie das Contract-Bundle: Komponenten mit typisierten Feldern, Seitentypen mit ihren Regionen, Collections, Medienprofile und die Header- und Footer-Globals. Halten Sie es in Ihrem Repository als atlas/contract.bundle.json.
3. Validieren und schlagen Sie es vor. Ein Site-Admin aktiviert es in Studio (Site setup).
4. Refaktorieren Sie jede Seitenkomponente so, dass Atlas-Abschnitte Reihenfolge und Inhalt bestimmen, mit den integrierten Daten als Fallback.

Fertig, wenn Studio die Website als In sync with the active contract anzeigt.

Stufe 3: Inhalte und Bilder übernehmen

1. Laden Sie Bilder mit dem passenden Medienprofil hoch. Dehnen oder skalieren Sie nie hoch; listen Sie die auf, die nicht passen.
2. Erstellen Sie Einträge für jedes wiederkehrende Element und verweisen Sie mit Alt-Text per Asset-ID auf Bilder.
3. Befüllen Sie die Header- und Footer-Globals mit den heutigen Inhalten.
4. Erstellen Sie für jede Route aus ihrem Seitentyp eine Seite und passen Sie deren Abschnitte an, bis der Entwurf der heutigen Seite entspricht.
5. Entwerfen Sie Übersetzungen und lassen Sie sie von Muttersprachlern prüfen.

Ein per MCP angebundener KI-Coding-Agent kann das meiste davon als Entwürfe erledigen. Eine Person prüft jede Seite mit Preview on website und veröffentlicht sie.

Stufe 4: Aktualisierung, SEO und Weiterleitungen

• Fügen Sie den Webhook-Empfänger hinzu, damit eine Veröffentlichung die Site innerhalb von Sekunden aktualisiert.
• Lesen Sie SEO-Titel, -Beschreibungen und noindex aus der Delivery API und bauen Sie die Sitemap aus /routes.
• Laden Sie /redirects und wenden Sie die Weiterleitungen an, damit alte URLs ihre Rankings behalten.

Stufe 5: live gehen

1. Schulen Sie Redakteure in Studio, Entwürfen, Vorschau und Veröffentlichung.
2. Erstellen Sie ein Release. Atlas prüft, dass der Contract synchron ist, keine Veröffentlichungsprobleme bestehen, die Website gesund ist und ein Backup aktuell ist.
3. Eine Person mit Freigaberechten gibt es frei. Ein Site-Admin schaltet Production ein, und Sie erstellen ein Production-Delivery-Token.
4. Deployen Sie Ihre Website mit dem Production-Token. Lassen Sie den Fallback aktiv.

Was Production ausliefert

Production liefert die Inhalte, Formulare, Chatbots und Sucheinstellungen in ihrem aktiven Release aus. Die Vorschau bleibt nur Development vorbehalten. Die genauen Schritte finden Sie unter Live gehen.

Zurücksetzen

• Ein inhaltlicher Fehler: auf eine frühere Revision oder ein früheres Production-Release zurücksetzen.
• Ein Codefehler: Ihren vorherigen Website-Build erneut deployen, wie Sie es heute tun.
• Atlas nicht verfügbar: Der Fallback liefert integrierte Inhalte aus, bis Atlas wieder da ist.