Ein Marktplatz-Paket veröffentlichen

Die meisten nützlichen Dinge sind kein einzelnes Primitiv. Eine Beleg-Erfassung ist eine App, die man am Handy öffnet, und ein Workflow, der ablegt, was man schickt. Ein Dashboard ist eine Oberfläche und die Abfrage dahinter.

Ein Paket (Eintragsart bundle) ist EIN Marktplatz-Eintrag, der mehrere Primitive deines Workspace zusammen trägt. Wer ihn installiert, bekommt das ganze Produkt in einem Schritt — statt zwei Einträge zu suchen und sie aus einer README zusammenzustöpseln.

Das Verkäufer-Dashboard des Marktplatzes mit dem Veröffentlichen-Tab und der Auswahl der Listing-Art.

Voraussetzungen

Du brauchst Workspace-Admin — dieselbe Berechtigung wie jeder andere Veröffentlichungsweg.
Die zu bündelnden Primitive müssen im Workspace bereits existieren: die Apps, Workflows, Skripte und Connector-Node-Typen, die dazugehören sollen.
Überlege, welche Ressourcen-Arten das fertige Produkt gebunden braucht. Das sind die Verbindungen, die der Installierende beisteuern muss — eine Storage-Bibliothek, eine Datenbank.

Paket veröffentlichen

Verkäufer-Bereich öffnen. Gehe zu Marktplatz → Verkaufen, dann auf den Tab Veröffentlichen.
Paket wählen. Die Zeile der Eintragsarten bietet App, Paket, Runner-Angebot, Workflow, Skript und Connector-Node. Wähle Paket.
Inhalt auswählen. Jede Art listet die Primitive deines Workspace; hake alles an, was zu diesem Produkt gehört. Die Zahl in der Abschnittsüberschrift zeigt deine Auswahl.

Eine ausgewählte App wandert mit ihrem vollständigen Quellbaum in den Eintrag — das Paket installiert also auf einer nackten Instanz, ohne dass irgendetwas nachgeladen werden müsste.
Eintrag benennen. Vergib einen Slug (klein, mit Bindestrichen — das ist die Katalog-Adresse), einen Anzeigenamen, optional eine Zusammenfassung und eine Version.
Benötigte Ressourcen-Arten angeben. Kommagetrennt, z. B. seafile_webdav, postgresql. Genau danach wird der Installierende gefragt, bevor die Installation weitergeht.

Was ein ausgewählter Connector bereits deklariert, musst du nicht wiederholen — diese Arten kommen automatisch dazu.
Preis setzen (optional). Standard ist kostenlos; ein Einmal- oder Monatspreis macht daraus einen bezahlten Eintrag, genau wie bei einem einzelnen Primitiv.
Benennen, was der Käufer außerhalb von SupaCloud braucht (optional). Manche Produkte funktionieren erst, wenn anderswo etwas eingerichtet ist — ein Schalter in der Admin-Oberfläche eines Anbieters, eine bei der Bank registrierte Produkt-ID. Das gehört hierher, auf Deutsch und Englisch, statt ins Readme: es erscheint als eigener Schritt im Installations-Assistenten, oberhalb der Ressourcen-Zuordnung, und auf der Artikelseite. Setze muss bestätigt werden, wenn ein Übersehen still fehlschlagen würde; die Installation wird dann bis zur Bestätigung verweigert — von der API ebenso wie vom Assistenten, damit die Bestätigung nicht überklickt werden kann.
Veröffentlichen. Das Paket landet als EIN Eintrag im Katalog. Wie jede Veröffentlichung startet es unverifiziert und durchläuft das Review-Gate, bevor es installiert werden kann.

Was der Käufer sieht

Die Installations-Vorschau listet jedes Teil auf, das das Paket anlegen wird — jede App, jeden Workflow, jedes Skript, jeden Connector namentlich — plus jede Ressourcen-Bindung, die das Produkt braucht, egal ob du sie am Paket deklariert hast oder ein gebündelter Connector sie für sich selbst deklariert.

Nichts installiert, solange nicht alle nötigen Bindungen zugeordnet sind. Die Bindungen gehören dem Installierenden: Deine Zugangsdaten reisen nie mit dem Eintrag mit, und die Ressourcen-Bindungen eines Workflows werden beim Veröffentlichen entfernt.

Eine Installation legt alles davon an, in einem Schritt.

Ein Paket aktuell halten

Veröffentliche denselben Slug erneut mit erhöhter Version. Der Katalog aktualisiert den Eintrag an Ort und Stelle, und bestehende Installationen bekommen das Update-Signal — wie bei jeder anderen Eintragsart.