CMS-Site prüfen und veröffentlichen

Führen Sie eine CMS-Site in getrennten Schritten vom Quellstand bis zur Live-Auslieferung. Eine grüne Developer-Readiness bestätigt Bearbeitung und Vorschau. Sie sagt nicht aus, dass bereits ein Release gebaut oder veröffentlicht wurde.

Richten Sie die lokale Domain bei Bedarf zuerst mit Lokale Storefront-Domain einrichten ein. Dieser Quickstart ist abgeschlossen, wenn die Live-Domain den bewusst veröffentlichten Release ausliefert und die Operations-Readiness keine Blocker meldet.

Zustände unterscheiden

ZustandBedeutungNächster Schritt
Kein BuildDie Site kann bearbeitet und in der Vorschau geprüft werden, besitzt aber noch keinen Release.Vorschau fachlich prüfen und Build starten.
Build läuftWorkspace erzeugt einen unveränderlichen Release.Abschluss abwarten.
Build fehlgeschlagenDer Release wurde nicht zuverlässig erzeugt. Der Status nennt einen redigierten Fehlercode, retryable und eine Attempt-ID.Recovery-Klasse prüfen; nicht automatisch erneut bauen oder veröffentlichen.
Release unveröffentlichtEin Build ist vorhanden, aber noch nicht live.Release prüfen und bewusst veröffentlichen.
Release veröffentlichtDer gewählte Release ist live.Live-Domain und Operations-Readiness prüfen.
Live-Release unvollständigDer aktive Release besitzt keinen vollständigen Runtime-Katalog und wird deshalb sicherheitshalber vollständig mit HTTP 503 gesperrt.Einen runtime-bereiten Release auswählen oder neu bauen, prüfen und bewusst veröffentlichen.

Wenn Site-Domain-Bindung, DNS und TLS bereit sind, liefert Workspace vor der ersten Veröffentlichung erwartbar HTTP 404 statt Live-Inhalten. Ordnen Sie 404 nur in diesem Fall als fehlenden Live-Release ein. Das gilt auch direkt nach der Initialisierung und nach einem erfolgreichen Build ohne Veröffentlichung. Blockierte Domain-, DNS-, TLS- oder Bindungschecks bleiben ein eigenständiges Hindernis. Ein beschädigter oder unlesbarer Live-Zustand liefert weiterhin HTTP 503 und gilt nicht als unveröffentlicht.

Von der Vorschau zur Live-Site

  1. Öffnen Sie CMS > Sites und wählen Sie die Site.
  2. Initialisieren Sie eine leere Site einmal mit dem Default-Kit.
  3. Starten Sie eine Dev-Session und bearbeiten Sie die Dateien im Tab Editor.
  4. Erzeugen Sie einen Vorschau-Link und prüfen Sie den Stand fachlich.
  5. Öffnen Sie den Tab Releases und starten Sie den Build.
  6. Warten Sie, bis der neue Release in der Liste erscheint.
  7. Prüfen Sie den Release und den Publish-Plan für genau diesen Stand. Beheben Sie verbleibende Blocker vor der Veröffentlichung.
  8. Bestätigen Sie Publish ausdrücklich für diesen Release.
  9. Prüfen Sie anschließend die Live-Domain, den Zugriff auf geschützte Seiten und die Operations-Readiness.

Ein Build veröffentlicht nichts automatisch. Auch ein neuer erfolgreicher Build verändert einen bereits live geschalteten Release erst nach einer ausdrücklichen Veröffentlichung.

Tenantgeschützte Seiten prüfen

Bei tenantgeschützten CMS-Seiten muss der aktive Tenant der Browsersitzung zum Tenant der Site passen. Danach gelten die konfigurierten Seitenrechte und gegebenenfalls die Gruppen der Zielgruppe (Audience). Eine Mitgliedschaft in mehreren Tenants ersetzt den passenden aktiven Kontext nicht.

Prüfen Sie vor der Veröffentlichung den anonymen Aufruf, ein berechtigtes Mitglied und eine Identität, die ausschließlich einem anderen Tenant angehört. Ohne Anmeldung darf kein geschützter Seiteninhalt erscheinen. Eine angemeldete Identität mit falschem aktivem Tenant erhält HTTP 403. Testen Sie diese Fälle in der Vorschau und nach der Veröffentlichung erneut. Ein Vorschau-Link ersetzt die Seitenrechte nicht. Falls die Site eine eigene Anmeldeseite verwendet, muss sie öffentlich erreichbar sein; ein Login-Redirect gehört ausschließlich zur Antwort auf fehlende Anmeldung (HTTP 401), damit HTTP 403 keine Anmeldeschleife auslöst.

Buildfehler sicher behandeln

Bewahren Sie die vom Build zurückgegebene attemptId auf. nucli sites build <site-id> --wait wartet nur auf den Status dieses Versuchs. Geben Sie bei einer Eskalation die Attempt-ID, failure.code und failure.retryable an, aber keine internen Logs, Dateipfade oder Rohfehler.

FehlercodesBedeutungRecovery
SITE_BUILD_AUTHORING_REFRESH_FAILED, SITE_BUILD_REDIRECTS_FAILED, SITE_BUILD_ASSETS_FAILED, SITE_BUILD_RENDER_FAILED, SITE_BUILD_PUBLIC_FILES_FAILED, SITE_BUILD_ROUTING_FAILED, SITE_BUILD_DYNAMIC_ROUTES_FAILED, SITE_BUILD_SITEMAP_FAILED, SITE_BUILD_SEARCH_MANIFEST_FAILED, SITE_BUILD_IMAGES_FAILEDEine autorenabhängige Buildstufe konnte die validierten Quellen nicht verarbeiten.Betroffene Quellen erneut validieren und erst danach einen neuen Build bewusst starten.
SITE_BUILD_CAPACITY_UNAVAILABLE, SITE_BUILD_STORAGE_PREPARE_FAILED, SITE_BUILD_SOURCE_SNAPSHOT_FAILED, SITE_BUILD_STAGING_FAILED, SITE_BUILD_RELEASE_FINALIZE_FAILEDEine externe Buildvoraussetzung war nicht verfügbar. Diese Codes sind als retryable markiert.Dokumentierte Kapazitäts-, Storage-, Snapshot-, Staging- oder Release-Voraussetzung durch den Betrieb wiederherstellen lassen. Erst danach einen neuen Build bewusst starten.
SITE_BUILD_RUNTIME_SNAPSHOT_FAILED, SITE_BUILD_RUNTIME_CATALOG_FAILED, SITE_BUILD_PRECOMPRESSION_FAILED, SITE_BUILD_PUBLISH_FAILED, SITE_BUILD_INTERNALDer Fehler benötigt Produktdiagnose oder ist keiner öffentlichen Recovery sicher zuzuordnen.Mit Attempt-ID an das Produktteam eskalieren. Keinen automatischen Retry oder Publish ausführen.

retryable: true bedeutet ausschließlich, dass ein neuer Versuch nach einer nachweislich behobenen externen Voraussetzung sinnvoll sein kann. Der aktuelle Live-Release bleibt bei einem fehlgeschlagenen Build unverändert.

Navigation, Seitenauflösung und Page-Feed gehören zum unveränderlichen Release. Änderungen im Editor erscheinen deshalb nur in Dev und Vorschau. Sie verändern die Live-Site erst nach einem neuen Build und einer ausdrücklichen Veröffentlichung.

Nach einem Produktupdate veröffentlichen

Lassen Sie das Produktupdate mit dem erforderlichen Serverneustart abschließen, bevor Sie den Veröffentlichungszustand erneut prüfen. Ein Produktupdate veröffentlicht keinen Site-Release automatisch.

Ein älterer Live-Release ohne vollständigen Runtime-Katalog kann mit HTTP 503 und ERR_SITE_RELEASE_RUNTIME_UNAVAILABLE gesperrt sein. Das ist kein normaler Seitenfehler und kein Anlass, Authoring-Dateien zurückzusetzen.

  1. Prüfen Sie die vorhandenen Releases. Verwenden Sie einen bereits gebauten, fachlich geprüften und runtime-bereiten Zielrelease, wenn er vorhanden ist. Bauen Sie andernfalls einen neuen Release.
  2. Prüfen Sie den Publish-Plan für genau diesen Zielrelease. Die Prüfung release_runtime_ready muss bereit sein. Lassen Sie verbleibende Infrastruktur-, Bindungs- oder Lesefehler durch den Betrieb klären.
  3. Veröffentlichen Sie den ausgewählten Release ausdrücklich.
  4. Kontrollieren Sie Live-Inhalte, Zugriff auf geschützte Seiten und Operations-Readiness.

Der Publish-Vorgang lehnt einen unvollständigen Zielrelease ab, ohne den aktiven Live-Release umzuschalten. Eine Zustandsprüfung repariert oder veröffentlicht nichts und erfordert keinen vorsorglichen Neubau eines gültigen Releases.

Der Vorschau-Link läuft mit dem gewählten Review-Zeitfenster ab. Er wird einmalig im vorgesehenen Browser eingelöst und setzt dort den Vorschauzugang. Öffnen Sie den Link nicht probeweise und lassen Sie ihn nicht automatisiert aufrufen. Das würde die Übergabe verbrauchen.

Speichern Sie konkrete Vorschau-Tokens weder in Logs noch in Tickets, Screenshots oder Dokumentation. Erzeugen oder kopieren Sie einen Link nur für den vorgesehenen Reviewer. Ein Vorschau-Link veröffentlicht die Site nicht.

Mit nucli prüfen

bash
nucli --tenant <tenant> sites readiness <site-id>
nucli --tenant <tenant> web readiness <site-id>
nucli --tenant <tenant> sites build <site-id> --wait
nucli --tenant <tenant> sites build-status <site-id>
nucli --tenant <tenant> sites releases list <site-id>
nucli --tenant <tenant> sites inspect <site-id> --strict
nucli --tenant <tenant> sites publish plan <site-id> --release <release-id>
nucli --tenant <tenant> sites publish <site-id> --release <release-id>

sites readiness bewertet Authoring und Vorschau. Verwenden Sie inspect --strict erst als Launch-Gate. web readiness bewertet Domain, DNS, TLS, Build und Live-Release. Der Publish-Plan ist read-only: Er darf einen unveröffentlichten Release und den Wechsel von einem gesperrten alten Live-Release akzeptieren, wenn der ausgewählte Zielrelease runtime-bereit ist. Liefert der alte Release HTTP 503, gilt diese Ausnahme nur, wenn Workspace selbst einen Runtime-Fehler des gebundenen Releases feststellt und die Antwort mit einem verifizierten Nachweis eindeutig der Anfrage, Domain, Site und ihrem aktiven Site-Release im aktuellen Arbeitsbereich zuordnet. Diagnose-Header oder HTTP 503 allein genügen nicht. Andere HTTP-Fehler sowie Infrastruktur-, Release-Lese- und Buildfehler bleiben blockierend.

Mutierende MCP-Aufrufe freigeben

Wenn ein MCP-Agent den Ablauf übernimmt, verlangen genau diese 13 Site- und Domain-Tools den erforderlichen JSON-Boolean approved: true:

  • nucleus_site_files_apply
  • nucleus_site_backup_save
  • nucleus_site_restore_apply
  • nucleus_site_dev_start
  • nucleus_site_preview_link_request
  • nucleus_site_dependencies_add
  • nucleus_site_dependencies_sync
  • nucleus_site_build
  • nucleus_site_publish
  • nucleus_tenant_domain_create
  • nucleus_tenant_domain_start_verification
  • nucleus_tenant_domain_verify_dns
  • nucleus_site_domain_bind

Geben Sie nur den konkreten Tool-Aufruf mit seinem vollständigen Payload frei. Fehlt approved, ist der Wert false, null oder kein Boolean, stoppt nucli vor Datei-, Secret-, Netzwerk- und Serverzugriff. Das Feld bleibt lokal und ersetzt weder Anmeldung, Berechtigungen, Tenantbindung noch die Prüfungen von Workspace. Read-only-Tools sowie nucleus_site_validate und nucleus_site_restore_preview bleiben unverändert.

Fehlerseiten vorbereiten

Verwenden Sie für eigene Fehlerseiten mit den Namen 401, 403, 404 und 500 die Zugriffsregel access.surface: public. Das gilt auch für Pfade wie de/404 oder hilfe/404. Geschützte Fehlerseiten werden beim Build abgelehnt. Vorhandene Quelldateien bleiben beim Serverstart mit ihren Zugriffsregeln ladbar. Verwenden Sie dort nur Inhalte, die ohne Anmeldung sichtbar sein dürfen.

Bei bestehenden Releases erscheint eine generische Fehlerseite, wenn die eigene Fehlerseite geschützt ist oder ihre öffentliche Zugriffsregel im Release fehlt. Die übrige Site bleibt erreichbar. Korrigieren Sie die Fehlerseite und veröffentlichen Sie einen neuen Build, um wieder die eigene Darstellung zu verwenden.

Geschützte Seiten aus Sitemaps ausschließen

Neue Builds übernehmen nur Seiten mit gültigem access.surface: public und sitemap: true in öffentliche Sitemaps. Ein sitemap: true auf einer geschützten Seite gibt deren URL nicht frei. Veröffentlichen Sie einen neuen Build, um bestehende Sitemap-Dateien zu ersetzen.

Gleichzeitige Änderungen bearbeiten

Beim Speichern prüft Workspace, ob die geladene Dateiversion noch aktuell ist. Hat jemand dieselbe Datei inzwischen geändert, erhalten Sie einen Versionskonflikt. Ihr Entwurf bleibt im Editor erhalten. Vergleichen Sie ihn mit dem aktuellen Dateiinhalt und führen Sie die Änderungen zusammen, bevor Sie erneut speichern. Änderungen an anderen Dateien lösen keinen solchen Konflikt aus.

Weitere Eingaben während einer Speicheranfrage bleiben als ungespeichert markiert. Eine Speicherbestätigung gilt für den dabei gesendeten Inhalt. Neue Quellzugriffe verwenden den aktuellen Stand; bereits laufende Vorgänge beenden ihre Arbeit mit ihrem zuvor ausgewählten Stand. Die öffentliche Website verwendet weiter den zuletzt ausdrücklich veröffentlichten Release.

Wenn Änderungen nicht gespeichert werden können

Bei ausgeschöpfter Quellkapazität meldet Workspace ERR_SITE_SOURCE_GENERATION_LIMIT. Der Editor behält den ungespeicherten Entwurf. Prüfen Sie den Zustand im richtigen Mandanten:

bash
nucli --tenant <tenant> sites sources status <site-id> --json
nucli --tenant <tenant> sites sources cleanup <site-id> --json

Der erste Befehl benötigt Leserechte für die Site, der zweite das Recht zur Workspace-Verwaltung der Site. Cleanup zeigt zunächst nur einen Plan. Mit --apply beantragen Sie die Bereinigung im laufenden Server. Sie setzt ein freigegebenes Leserprotokoll voraus; bei protocolState: bridge bleibt sie gesperrt. Laufende Leser behalten ihre Quelldateien bis zum Abschluss. trashGenerationCount zeigt bereits ausgesonderte Stände, deren Löschung noch aussteht. Quellbereinigung veröffentlicht keinen Release.

ERR_SITE_SOURCE_RETENTION_UNAVAILABLE bedeutet, dass der Server einen sicheren Quellzugriff derzeit nicht gewährleisten kann. ERR_SITE_SOURCE_STORAGE_EXHAUSTED bezeichnet fehlenden Speicherplatz oder eine ausgeschöpfte Quote. Lassen Sie diese Ursachen administrativ prüfen. Die Behebung ist am Status und einem anschließend erfolgreich gespeicherten Entwurf erkennbar.

Ergebnis prüfen

Die Veröffentlichung ist abgeschlossen, wenn der ausgewählte Release als live markiert ist, web readiness keine Blocker meldet und die Live-Domain den geprüften Inhalt statt des erwarteten Vorab-404 ausliefert.