Veröffentlichen einer Snowflake Native App für Kunden¶
Voraussetzungen¶
Sie müssen eine bestehende Verbindung in Ihrer
config.toml-Datei haben.In Ihrem Snowflake Native App-Projekt muss eine
snowflake.yml-Datei vorhanden sein.Sie müssen ein bestehendes Freigabeangebot haben, wenn Sie eine Snowflake Native App auf dem Snowflake Marktplatz veröffentlichen.
So veröffentlichen Sie eine Snowflake Native App für Kunden¶
In Snowflake erfolgt die Veröffentlichung einer Snowflake Native App für Kunden durch die Festlegung von Release-Richtlinien. Release-Richtlinien sind eine Reihe von Regeln, die festlegen, welche Version und welcher Patch der Snowflake Native App für welche Kunden verfügbar sind.
Release-Kanäle bieten eine Möglichkeit, getrennte Release-Prozesse für verschiedene Arten von Kunden zu verwalten. So können z. B. Early-Access-Kunden den ALPHA-Kanal, das interne QA-Team den QA-Kanal und allgemeine Kunden den DEFAULT-Kanal nutzen.
Wenn die Release-Kanäle für ein Anwendungspaket aktiviert sind, sind die Release-Richtlinien an die Release-Kanäle gebunden. Andernfalls sind die Release-Richtlinien direkt an das Anwendungspaket gebunden.
Bemerkung
Das Release-Kanal-Feature ist möglicherweise nicht in allen Regionen verfügbar. Weitere Informationen dazu erhalten Sie vom Snowflake-Support.
Prozess mit aktivierten Release-Kanälen¶
Um Release-Kanäle explizit zu aktivieren, fügen Sie enable_release_channels=true in den Abschnitt [cli.features] Ihrer Datei config.toml ein. Sie müssen Ihr Anwendungspaket neu erstellen oder aktualisieren, nachdem Sie Release-Kanäle aktiviert haben. Um zu bestätigen, dass die Release-Kanäle aktiviert wurden, führen Sie den Befehl snow app release-channel list aus. Es wird dann eine Liste der Release-Kanäle im Anwendungspaket angezeigt:
snow app release-channel list
Der einfachste Weg, eine bestehende Version und einen bestehenden Patch für alle Kunden im Standard-Release-Kanal zu veröffentlichen, ist die Verwendung des Befehls snow app publish mit den Optionen --version und --patch:
snow app publish --version v1 --patch 1
Um automatisch eine neue Version und einen neuen Patch zu erstellen, verwenden Sie die Option --create-version:
snow app publish --version v1 --create-version
Um eine Snowflake Native App in einem Nicht-Standard-Release-Kanal zu veröffentlichen, verwenden Sie die Option --channel:
snow app publish --version v1 --patch 1 --channel ALPHA
Um eine Snowflake Native App in einer benutzerdefinierten Release-Richtlinie zu veröffentlichen, die sich an bestimmte Kunden richtet, verwenden Sie die Option --directive:
snow app publish --version v1 --patch 1 --channel ALPHA --directive customers_group_1
Der Befehl snow app publish fügt die Version dem Release-Kanal hinzu. Wenn der Release-Kanal bereits die maximal zulässige Anzahl von Versionen enthält, versucht dieser Befehl zunächst, eine der Versionen, auf die keine Release-Richtlinie verweist, aus dem Kanal zu entfernen.
Nachdem die Version zum Release-Kanal hinzugefügt wurde, legt der Befehl die Standard-Release-Richtlinie dieses Release-Kanals auf die angegebene Version und den angegebenen Patch fest.
Um mehr Kontrolle über die Vorgänge zu erhalten, ersetzen Sie den vorherigen Befehl durch die folgenden Befehle:
snow app release-channel add-version --version v1 ALPHA
snow app release-directive set customers_group_1 --version v1 --patch 1
Weitere Informationen zur Verwaltung von Release-Kanäle und Release-Richtlinien finden Sie in den Befehlsreferenzen snow app release-channel und snow app release-directive.
Prozess mit deaktivierten Release-Kanälen¶
Wenn die Release-Kanäle für ein Anwendungspaket nicht aktiviert sind, sind die Release-Richtlinien direkt an das Anwendungspaket gebunden.
Der einfachste Weg, eine bestehende Version und einen bestehenden Patch für alle Kunden zu veröffentlichen, ist die Verwendung des Befehls snow app publish mit den Optionen --version und --patch.
snow app publish --version v1 --patch 1
Dieser Befehl legt die Standard-Release-Richtlinie des Anwendungspakets auf die angegebene Version und den angegebenen Patch fest. In diesem Fall sind die Release-Kanäle nicht aktiviert, sodass kein Release-Kanal an diesem Vorgang beteiligt ist.
Wenn Sie möchten, dass der Veröffentlichungsbefehl automatisch eine neue Version und einen neuen Patch erstellt, verwenden Sie die Option --create-version:
snow app publish --version v1 --create-version
Um eine Snowflake Native App in einer benutzerdefinierten Release-Richtlinie zu veröffentlichen, die sich an bestimmte Kunden richtet, verwenden Sie die Option --directive:
snow app publish --version v1 --patch 1 --directive customers_group_1
Diese snow app publish-Befehle funktionieren auch dann noch, wenn in Zukunft Release-Kanäle aktiviert werden. Wenn Release-Kanäle aktiviert sind, startet der Befehl mit dem Standard-Release-Kanal.