Einen Storefront anlegen

Es gibt zwei Wege zu einem laufenden Storefront, und die Wahl entscheidet, wer ihn die nächsten fünf Jahre pflegt. Treffen Sie sie bewusst.

Zwei Wege

Die meisten Unternehmen sollten mit einem verwalteten Theme anfangen. Eine selbst gehostete Site wählen Sie, wenn Sie ein Frontend-Team haben, ein Design, das kein Theme trägt, oder einen bestehenden Storefront, den Sie migrieren statt ersetzen.

Weg A: ein Theme installieren

1. Öffnen Sie Experience Studio › Marketplace.
2. Öffnen Sie ein Theme und lesen Sie den Eintrag: Anbieter, Version, Engine, Sprachen, Funktionen, Preis und die angeforderten Berechtigungen. Ein Theme arbeitet mit den Daten Ihres Tenants; lesen Sie diese Liste, statt sie wegzuklicken.
3. Wählen Sie Installieren. Das Theme ist jetzt für den Tenant installiert, liefert aber noch nichts aus.
4. Legen Sie eine Domain an und verifizieren Sie sie. Siehe Domains und Go-Live. Ohne verifizierte Domain lässt sich kein Theme aktivieren.
5. Nutzen Sie unter Experience Studio › Installierte Themes die Aktion Auf Domain aktivieren und wählen Sie die Domain, die es bedienen soll.
6. Konfigurieren Sie es im Tab Einstellungen des Themes. Siehe Themes und Branding.

Weg B: eine eigene Site deployen

1. Öffnen Sie Experience Studio › Sites und wählen Sie Site anlegen.
2. Wählen Sie eine Quelle:
   • Aus Git-Repository: GitHub verbinden, Repository und Produktions-Branch wählen. Jeder Push auf diesen Branch löst ein Deployment aus.
   • Manueller Upload: eine .tar.gz Ihres Build-Outputs ablegen. Ein einmaliges Deployment, ohne automatische Redeploys.
3. Bei Git: Installieren Sie die Revenexx GitHub App in der Organisation, der das Repository gehört, wählen Sie das Repo und dann den Produktions-Branch. Das Framework wird für Sie erkannt; überschreiben Sie es, wenn die Erkennung danebenliegt. Setzen Sie das Stammverzeichnis, wenn die Site nicht in der Wurzel des Repositories liegt.
4. Prüfen Sie die Konfiguration: Install-Befehl, Build-Befehl, Ausgabeverzeichnis und die Umgebungsvariablen aus den .env-Schlüsseln des Repositories. Umgebungsvariablen erreichen Build und Laufzeit, markieren Sie Geheimnisse also als geheim.
5. Setzen Sie optional eine eigene Site-ID (Buchstaben, Ziffern, Punkt, Bindestrich und Unterstrich, bis zu 36 Zeichen). Lassen Sie das Feld leer, erzeugt die Plattform eine.
6. Deployen Sie. Der erste Build erscheint in der Liste Deployments der Site.
7. Lassen Sie eine Domain darauf zeigen: Öffnen Sie unter Experience Studio › Domains die Domain, wählen Sie unter Routing Selbst gehosteter Storefront, dann die Site, und wählen Sie Routing übernehmen.

Was Sie prüfen

Öffnen Sie Experience Studio › Sites. Die Zeile Ihres Storefronts zeigt seinen Status; er sollte als gebaut dastehen und nicht als fehlgeschlagen. Öffnen Sie dann die Site und prüfen Sie den Tab Übersicht:

• Live zeigt Ja, nicht Nicht aktuell. Nicht aktuell heißt, es gibt ein neueres Deployment, aber das ältere ist noch das aktive.
• Das aktive Deployment ist das, das Sie erwarten, mit plausibler Build-Größe und Dauer.

Ist der Build fehlgeschlagen, öffnen Sie die Deployment-Zeile und lesen Sie das Build-Log. Build-Fehler in diesem Stadium sind fast immer der Install- oder Build-Befehl oder eine fehlende Umgebungsvariable, derselbe Fehler, den Sie lokal auch bekämen.

Bei einem verwalteten Theme prüfen Sie Installierte Themes: Die Spalte Live auf sollte Ihre Domain nennen.

Wenn es nicht funktioniert

• „Keine verifizierten Domains“ beim Aktivieren eines Themes: Die Domain existiert, aber ihr DNS ist noch nicht verifiziert. Schließen Sie zuerst Domains und Go-Live ab.
• Die Site baut, aber die Domain zeigt nichts: Das Routing wurde nie übernommen. Eine Domain mit Nicht geroutet unter Liefert aus tut genau das.
• Pushes lösen keinen Build aus: Der Push ging auf einen anderen Branch als den konfigurierten Produktions-Branch, oder die GitHub App ist in einer anderen Organisation installiert als der, der das Repository gehört.

Weiter

• Themes und Branding: damit er aussieht wie Ihr Unternehmen.
• Domains und Go-Live: DNS, TLS und der Launch.