snow app release-directive set¶
Legt eine Release-Richtlinie fest; target_accounts kann nicht für Standard-Release-Richtlinien angegeben werden. Das Feld target_accounts ist erforderlich, wenn Sie eine neue, nicht standardmäßige Release-Richtlinie erstellen.
Syntax¶
snow app release-directive set
<directive>
--channel <channel>
--target-accounts <target_accounts>
--version <version>
--patch <patch>
--package-entity-id <package_entity_id>
--app-entity-id <app_entity_id>
--project <project_definition>
--env <env_overrides>
--connection <connection>
--host <host>
--port <port>
--account <account>
--user <user>
--password <password>
--authenticator <authenticator>
--private-key-file <private_key_file>
--token-file-path <token_file_path>
--database <database>
--schema <schema>
--role <role>
--warehouse <warehouse>
--temporary-connection
--mfa-passcode <mfa_passcode>
--enable-diag
--diag-log-path <diag_log_path>
--diag-allowlist-path <diag_allowlist_path>
--oauth-client-id <oauth_client_id>
--oauth-client-secret <oauth_client_secret>
--oauth-authorization-url <oauth_authorization_url>
--oauth-token-request-url <oauth_token_request_url>
--oauth-redirect-uri <oauth_redirect_uri>
--oauth-scope <oauth_scope>
--oauth-disable-pkce
--oauth-enable-refresh-tokens
--oauth-enable-single-use-refresh-tokens
--client-store-temporary-credential
--format <format>
--verbose
--debug
--silent
--enhanced-exit-codes
Argumente¶
directive
Name der zu setzenden Release-Richtlinie.
Optionen¶
--channel TEXT
Name des zu verwendenden Release-Kanals. Standard: DEFAULT.
--target-accounts TEXT
Liste der Konten, auf die die Release-Richtlinie angewendet werden soll. Das Format muss
org1.account1,org2.account2
sein.--version TEXT
Version des zu verwendenden Anwendungspakets.
--patch INTEGER
Patch-Nummer, die für die ausgewählte Version verwendet werden soll.
--package-entity-id TEXT
Die ID der Paketentität, mit der gearbeitet werden soll, wenn definition_version 2 oder höher ist.
--app-entity-id TEXT
Die ID der Anwendungsentität, mit der gearbeitet werden soll, wenn die definition_version 2 oder höher ist.
-p, --project TEXT
Pfad, unter dem das Snowflake-Projekt gespeichert ist. Standardmäßig wird das aktuelle Verzeichnis als Arbeitsverzeichnis verwendet.
--env TEXT
Zeichenfolge im Format Schlüssel=Wert. Überschreibt die Variablen aus dem Abschnitt env, die für Vorlagen verwendet werden. Standard: [].
--connection, -c, --environment TEXT
Name der Verbindung, wie in Ihrer
config.toml
-Datei definiert. Standard:Standard
.--host TEXT
Host-Adresse für die Verbindung. Überschreibt den für die Verbindung angegebenen Wert.
--port INTEGER
Port für die Verbindung. Überschreibt den für die Verbindung angegebenen Wert.
--account, --accountname TEXT
Name, der Ihrem Snowflake-Konto zugewiesen wurde. Überschreibt den für die Verbindung angegebenen Wert.
--user, --username TEXT
Benutzername für die Verbindung zu Snowflake. Überschreibt den für die Verbindung angegebenen Wert.
--password TEXT
Snowflake-Kennwort. Überschreibt den für die Verbindung angegebenen Wert.
--authenticator TEXT
Snowflake-Authentifikator. Überschreibt den für die Verbindung angegebenen Wert.
--private-key-file, --private-key-path TEXT
Dateipfad zum privaten Snowflake-Schlüssel. Überschreibt den für die Verbindung angegebenen Wert.
--token-file-path TEXT
Pfad zur Datei mit einem OAuth-Token, das bei der Verbindung mit Snowflake verwendet werden soll.
--database, --dbname TEXT
Zu verwendende Datenbank. Überschreibt den für die Verbindung angegebenen Wert.
--schema, --schemaname TEXT
Zu verwendendes Datenbankschema. Überschreibt den für die Verbindung angegebenen Wert.
--role, --rolename TEXT
Zu verwendende Rolle. Überschreibt den für die Verbindung angegebenen Wert.
--warehouse TEXT
Zu verwendendes Warehouse. Überschreibt den für die Verbindung angegebenen Wert.
--temporary-connection, -x
Verwendet eine mit Befehlszeilenparametern definierte Verbindung anstelle einer in config definierten. Standard: false
--mfa-passcode TEXT
Für die mehrstufige Authentifizierung (MFA) zu verwendendes Token.
--enable-diag
Ob ein Verbindungsdiagnosebericht erstellt werden soll. Standard: false
--diag-log-path TEXT
Pfad für den generierten Bericht. Standardmäßig wird das temporäre Verzeichnis des Systems verwendet. Standard: <system_temporary_directory>.
--diag-allowlist-path TEXT
Pfad zu einer JSON-Datei, die allowlist-Parameter enthält.
--oauth-client-id TEXT
Wert der Client-ID, die vom Identitätsanbieter für die Snowflake-Integration bereitgestellt wird.
--oauth-client-secret TEXT
Wert des Client-Geheimnisses, das vom Identitätsanbieter für die Snowflake-Integration bereitgestellt wird.
--oauth-authorization-url TEXT
Endpunkt des Identitätsanbieters, der den Autorisierungscode an den Treiber liefert.
--oauth-token-request-url TEXT
Endpunkt des Identitätsanbieters, der die Zugriffstoken für den Treiber bereitstellt.
--oauth-redirect-uri TEXT
Für die Umleitung des Autorisierungscodes zu verwendende URI.
--oauth-scope TEXT
Bereich, der in der Autorisierungsanfrage des Identitätsanbieters angefordert wird.
--oauth-disable-pkce
Deaktiviert den Proof Key For Code Exchange (PKCE). Standard:
False
.--oauth-enable-refresh-tokens
Ermöglicht eine stille Neuauthentifizierung, wenn das aktuelle Zugriffstoken veraltet ist. Standard:
False
.--oauth-enable-single-use-refresh-tokens
Ob Sie sich für die Semantik des einmaligen Aktualisierungs-Tokens entscheiden. Standard:
False
.--client-store-temporary-credential
Speichern der temporären Anmeldeinformationen.
--format [TABLE|JSON]
Gibt das Ausgabeformat an. Standard: TABLE.
--verbose, -v
Zeigt Protokolleinträge für die Protokolliergrade
info
und höher an. Standard: false--debug
Zeigt Protokolleinträge für die Protokollebenen
debug
und höher an; Debug-Protokolle enthalten zusätzliche Informationen. Standard: false--silent
Schaltet Zwischenausgaben auf der Konsole aus. Standard: false
--enhanced-exit-codes
Exit-Fehlercodes nach Art des Fehlers unterscheiden. Standard: false
--help
Zeigt den Hilfetext für diesen Befehl an.
Nutzungshinweise¶
Der Befehl snow app release-directive set
setzt die Release-Richtline für ein Anwendungspaket. Es gibt zwei Typen von Release-Richtlinien: Standard und benutzerdefiniert.
Beim Festlegen der Standard-Release-Richtlinie werden Zielkonten nicht akzeptiert.
Wenn Sie eine neue benutzerdefinierte Release-Richtlinie setzen, sind die Zielkonten erforderlich.
Wenn Sie eine vorhandene benutzerdefinierte Release-Richtlinie aktualisieren, sind die Zielkonten optional.
Zielkonten werden im Format ORGANIZATION_NAME.ACCOUNT_NAME, durch Kommas getrennt, angegeben.
Wenn Release-Kanäle im Anwendungspaket aktiviert sind, ist die Release-Richtlinie auf den angegebenen Release-Kanal beschränkt, andernfalls auf das Anwendungspaket.
Snowflake empfiehlt die Verwendung des Befehls snow app publish zur Veröffentlichung des Anwendungspakets und die Verwendung des Befehls snow app release-directive set
zum Erstellen benutzerdefinierter Release-Richtlinien. Weitere Informationen dazu finden Sie unter Veröffentlichen einer Snowflake Native App für Kunden.
Beispiele¶
Standard-Release-Richtlinie für ein Anwendungspaket festlegen
snow app release-directive set DEFAULT --version v1 --patch 1
Kundenspezifische Release-Richtlinie für ein Anwendungspaket festlegen
snow app release-directive set CUSTOM_DIR --version v1 --patch 1 --target-accounts ORG1.ACCT1,ORG2.ACCT2
Aktualisieren einer vorhandenen benutzerdefinierten Release-Richtlinie für ein Anwendungspaket:
snow app release-directive set CUSTOM_DIR --version v1 --patch 2
Festlegen der Standard-Release-Richtlinie eines Release-Kanals, wenn das Anwendungspaket Release-Kanäle aktiviert hat:
snow app release-directive set DEFAULT --version v1 --patch 1 --channel ALPHA