Sites entwickeln und bereitstellen

Diese Anleitung richtet sich an externe Entwickler und Agenturen. Sie entwickeln eine Website, einen Shop oder ein Portal in einem lokalen Projektordner und veröffentlichen die Site anschließend im Sites-Katalog. Dafür benötigen Sie weder Zugang zu einem Kunden-Workspace noch Git oder eine CI-Umgebung.

Voraussetzungen

Sie benötigen:

  • eine Einladung zum Publisher-Bereich,
  • eine aktuelle nucli-Installation,
  • einen lokalen Ordner mit editierbaren Sitegenerator-Quellen.

Ein Site Package enthält die vollständigen Quellen, nicht den Build-Ausgang. Build-Verzeichnisse, node_modules, Git-Metadaten, Secrets und lokale Umgebungsdateien werden nicht übernommen.

Publisher und Site anlegen

Der Betreiber lädt Sie zum Publisher-Bereich ein und sendet Ihnen dessen direkte Adresse https://www.schukai.com/de/apps/workspace/sites/publisher. Eine offene Registrierung gibt es während des Piloten nicht. Der öffentliche Katalog zeigt deshalb auch keinen Link für Publisher. Nach dem Einlösen der Einladung melden Sie sich an und legen beim ersten Aufruf eine Publisher-Organisation an, beispielsweise „Nordlicht Digital“.

Erstellen Sie anschließend die Site. Der Eintrag enthält den sichtbaren Namen, die Kategorie, optional eine öffentliche Vorschau-URL sowie eine deutsche und eine englische Zusammenfassung und Beschreibung. Beide Sprachen müssen vollständig sein, bevor Sie eine Version zur Prüfung einreichen können. Nach dem Speichern zeigt der Publisher-Bereich die Store-Site-ID für den späteren CLI-Upload an.

Lokales Projekt vorbereiten

Initialisieren Sie im Projektordner die Paketmetadaten:

bash
nucli sites package init . \
  --publisher nordlicht \
  --site commerce \
  --license MIT

nucli speichert die stabile Paket-ID und die Koordinaten geschützt unter .nucli/site-package.json. Diese Datei bleibt außerhalb des Site Packages. Bewahren Sie sie zusammen mit dem Projekt auf, damit spätere Versionen dieselbe Paket-ID verwenden.

Prüfen Sie die Quellen, bevor Sie eine Version bauen:

bash
nucli sites package validate .

Für Abhängigkeiten ist eine exakte Bindung im Lockfile erforderlich. Versionsbereiche und latest werden abgewiesen. Auch versteckte Pfade, symbolische Links, kollidierende Dateinamen und zu große Dateien führen zu einem Fehler.

Site Package bauen

Erzeugen Sie eine semantisch versionierte ZIP-Datei:

bash
nucli sites package build . \
  --version 1.0.0 \
  --output nordlicht-commerce-1.0.0.zip

Der Befehl erstellt das Manifest, berechnet die Prüfsummen und validiert das fertige Archiv. Eine vorhandene ZIP-Datei lässt sich erneut prüfen:

bash
nucli sites package validate nordlicht-commerce-1.0.0.zip

Entwurf hochladen

Erzeugen Sie bei der Site ein zeitlich begrenztes nucli-Upload-Token. Das Site Package wird immer mit nucli hochgeladen; Git und eine CI-Umgebung sind dafür nicht erforderlich. Übergeben Sie das Token ausschließlich über die Standardeingabe:

bash
nucli --host https://www.schukai.com/apps/workspace/sites \
  sites store upload nordlicht-commerce-1.0.0.zip \
  --site-id <store-site-id> \
  --token-stdin

Leiten Sie das Token in die Standardeingabe und schließen Sie diese anschließend. Das Token gehört weder in die Befehlszeile noch in das Projekt, die ZIP-Datei oder ein Protokoll. Der Store legt den Upload als privaten Entwurf an.

Version einreichen

Prüfen Sie zuerst, ob die deutschen und englischen Metadaten vollständig sind. Öffnen Sie dann den Entwurf im Publisher-Bereich und wählen Sie Zur Prüfung einreichen. Während der Moderation bleibt die Version privat. Nach der Freigabe erscheint sie öffentlich im Katalog und kann in einen leeren Workspace installiert werden.

Eine veröffentlichte Version ist unveränderlich. Korrekturen erhalten eine neue semantische Version und ein neues Site Package.

Git und CI optional nutzen

Git kann Quellstände, Zusammenarbeit und Reviews unterstützen. Eine CI-Pipeline kann denselben Build- und Upload-Ablauf automatisieren. Beides ist optional; der lokale nucli- und Browser-Ablauf bleibt vollständig unterstützt.

Ein öffentliches Repository darf Sitegenerator-Quellen enthalten. Publisher-Tokens, Workspace-Sitzungen, lokale Umgebungsdateien, Build-Ausgaben und exportierte ZIP-Dateien gehören nicht hinein.

Aus einem Workspace exportieren

Wenn Sie bereits in einem Workspace entwickeln und die Berechtigung site:packages:export besitzen, können Sie die dortigen Development-Quellen weiterhin serverseitig exportieren:

bash
nucli --tenant <tenant> sites package export <site-id> \
  --publisher nordlicht \
  --site commerce \
  --version 1.0.0 \
  --license MIT \
  --output nordlicht-commerce-1.0.0.zip

Dieser Komfortweg ist keine Voraussetzung für externe Publisher.

Prüfung

Die Veröffentlichung ist vorbereitet, wenn:

  • nucli sites package validate ohne Fehler endet,
  • der Upload als privater Entwurf im Publisher-Bereich erscheint,
  • Koordinate und Version im Entwurf dem lokalen Projekt entsprechen.

Nach der Moderation zeigt der öffentliche Katalog die Site und ihre freigegebene Version.

Grenzen der ersten Version

Der Pilot unterstützt kostenlose öffentliche Sites. Verkauf, Abrechnung, Auszahlungen, automatische Updates installierter Sites, eine offene Publisher-Registrierung und Installationen in bereits gefüllte Sites gehören nicht zu diesem Vertrag.