FAQ zu Deployment-Prüfung und erstem Login bei Emdash CMS

Veröffentlicht am 2026-04-08 von Emdash Cms Everything

Was sollte ich nach dem Deployment zuerst prüfen?

Drei-Schichten-Abnahme:

1. Frontend erreichbar: Startseite liefert erwarteten Inhalt.
2. Admin erreichbar: /_emdash/admin lädt.
3. Daten schreibbar: ein Content-Item erstellen und lesen.

Nur Erreichbarkeit von Routen ist noch kein abgeschlossenes Deployment.

Warum kann das Frontend laufen, aber die Admin-Initialisierung scheitern?

Häufigste Ursachen:

• Binding-Mismatch (DB, MEDIA usw.)
• fehlende Umgebungsvariablen oder Secrets
• für den Free-Plan nicht unterstützte Config beibehalten

Empfohlene Reihenfolge: zuerst Bindings, dann Env-Vars, dann Feature-Tier-Constraints.

Was passiert beim ersten Admin-Login?

Typischerweise:

• Admin-Identität wird angelegt
• Credentials werden registriert (z. B. Passkey)
• initialer Systemzustand wird geschrieben

Dieser Schritt hängt von Browser und Kontostatus ab. In stabilem Netz und unterstütztem Browser abschließen.

Was zuerst prüfen, wenn die Passkey-Einrichtung fehlschlägt?

In dieser Reihenfolge:

• Browser-Unterstützung und Passkey-Verfügbarkeit
• Systemzeit korrekt
• Cross-Origin- oder Reverse-Proxy-Header-Probleme

Nicht mit Datenbankverdacht starten — die meisten Auth-Fehler sind Client- oder Edge-Proxy-bezogen.

Was ist ein minimales Produktions-Abnahme-Skript?

Wiederholbarer Ablauf:

1. Frontend-Startseite öffnen und Antwort notieren.
2. In Admin einloggen und Ersteinrichtung abschließen.
3. Test-Content erstellen und veröffentlichen.
4. Eine Mediendatei hochladen und Abruf prüfen.
5. Sicherstellen, dass veröffentlichter Content im Frontend sichtbar ist.

Damit validieren Sie Route, Auth, Schreiben, Speicher und Lesen.

Deployment wirkt erfolgreich, aber Content fehlt. Wo anfangen?

Kürzeste Diagnose:

1. Ist der Eintrag veröffentlicht (nicht Entwurf)?
2. Fragt das Frontend die erwartete Collection ab?
3. Laufzeit-Logs auf Query- oder Berechtigungsfehler prüfen.

Meist fehlender Content ist Zustand oder Abfragepfad — kein Plattform-Ausfall.

Wie Teams Abnahmequalität institutionalisieren

In den Release-Workflow aufnehmen:

• pre-merge: Drei-Schichten-Abnahme lokal oder in Staging
• post-release: verantwortliche Person führt minimales Skript innerhalb von 10 Minuten aus
• post-incident: eine neue deterministische Prüfung ergänzen, um Wiederholung zu verhindern

Zuverlässige Launches kommen aus Prozesskontrolle, nicht aus mündlicher Überlieferung.

Verifikations-Befehlsausschnitt

# Beispiel-Laufzeit-Checks
curl -I https://your-site.workers.dev
curl -I https://your-site.workers.dev/_emdash/admin
npx wrangler tail your-worker-name