Quellen für Workspace Sites steuern

Bei der Installation übernimmt Workspace eine Site als vollständiges, editierbares Sitegenerator-Projekt. Dabei entsteht weder ein Live-Release noch eine Veröffentlichung. Build und Veröffentlichung bleiben eigene, bewusste Schritte.

Quellmodus wählen

Die installationsweite Einstellung cms.site_packages.source_mode kennt drei Modi:

ModusZulässige Quellen
store_onlyNur der unter cms.site_packages.store_base_url konfigurierte zentrale Katalog.
store_plus_allowlistZentraler Katalog und die ausdrücklich unter cms.site_packages.external_allowed_destinations freigegebenen HTTPS-Ziele.
store_plus_public_httpsZentraler Katalog und öffentliche HTTPS-Ziele. Private und lokale Netze bleiben gesperrt.

In einer gehosteten Umgebung empfiehlt sich store_only, damit freie Quellen zentral und mandantenübergreifend abgewiesen werden. Bewusst gilt die Richtlinie nicht je Tenant: Einzelne Mandanten können sie nicht lockern.

Die Store-Adresse darf einen festen Dienstpfad enthalten. Für den zentralen schukai-Katalog lautet sie https://www.schukai.com/apps/workspace/sites. Weiterleitungen, Deskriptoren und Archive müssen innerhalb dieses Pfads bleiben. Ein Wechsel auf einen anderen Pfad derselben Domain wird genauso behandelt wie eine externe Quelle.

Unter cms.site_packages.store_trusted_public_keys hinterlegen Sie die vertrauenswürdigen Ed25519-Schlüssel des Katalogs. Vor der Installation prüft Workspace den signierten Release-Deskriptor, den SHA-256-Wert des Archivs und die Hashes aller enthaltenen Dateien. Private Signierschlüssel gehören nicht in die Workspace-Konfiguration. In der gehosteten Lösung bleibt store_only gesperrt; ein Tenant kann dort keine freie Quelle aktivieren.

Eine Site installieren

Im öffentlichen Katalog wählen Sie In Workspace installieren und geben die Basis-URL Ihres Workspace ein. Nach der Anmeldung wählen Sie unter Sites die leere Ziel-Site. Deren Sites-Katalog öffnet sich mit der ausgewählten Vorlage. Die Installation beginnt erst, nachdem Sie den Plan geprüft und bestätigt haben.

  1. Legen Sie unter CMS > Sites eine leere Site an.
  2. Starten Sie eine Development-Session.
  3. Öffnen Sie den Tab Sites und wählen Sie eine veröffentlichte Version.
  4. Prüfen Sie den Installationsplan. Bestehende Dateien, vorhandene Releases oder fehlende Capabilities blockieren die Installation.
  5. Bestätigen Sie die Installation des unveränderten Plans.
  6. Bearbeiten und prüfen Sie die übernommenen Quellen im Editor.
  7. Bauen und veröffentlichen Sie erst danach einen eigenen Release.

Nach der Installation bleibt die Kopie unabhängig von der Vorlage. Automatische Updates sind in der ersten Version nicht vorgesehen.

Mit nucli arbeiten

bash
nucli --tenant <tenant> sites catalog
nucli --tenant <tenant> sites install plan <site-id> \
  --publisher <publisher> --site <site> --version <version>
nucli --tenant <tenant> sites install apply <site-id> \
  --publisher <publisher> --site <site> --version <version> \
  --plan-digest <digest>
nucli --tenant <tenant> sites install status <site-id>

Für eine externe Quelle verwenden Plan und Apply stattdessen --descriptor-url <https-url>. Die URL muss zum konfigurierten Quellmodus passen. Ein lokaler ZIP-Upload gehört nicht zum Vertrag.

Ergebnis prüfen

Abgeschlossen ist die Installation, wenn sites install status die erwartete Koordinate, Version sowie Manifest- und Archiv-Digests ausgibt und die editierbaren Dateien im Development-Projekt vorhanden sind. Allein dadurch darf sich ein Live-Aufruf nicht verändern.