Snowflake Native App を顧客に公開します。¶
前提条件¶
config.toml
ファイルに既存の接続が必要です。Snowflake Native App プロジェクトに
snowflake.yml
ファイルが必要です。Snowflake Marketplace に Snowflake Native App を公開する場合は、既存のリストが必要です。
Snowflake Native App を顧客に公開する方法¶
Snowflake では、 Snowflake Native App を顧客に公開するには、リリースディレクティブをセットします。リリースディレクティブは、 Snowflake Native App のどのバージョンとパッチがどの顧客に可用性を与えるかを決定するルールのセットです。
リリース・チャネルは、顧客のタイプごとに別々のリリース・プロセスを管理する方法を提供します。例えば、早期アクセスの顧客は ALPHA チャネルを、社内の QA チームは QA チャネルを、一般の顧客は DEFAULT チャネルをご利用いただけます。
リリースチャネルがアプリケーションパッケージに有効である場合、リリースディレクティブはリリースチャネルに関連付けられます。そうでない場合には、リリースディレクティブはアプリケーションパッケージに直接関連付けられます。
注釈
リリースチャンネル機能はリージョンによって可用性が異なる場合があります。詳細については、Snowflakeサポートにお問い合わせください。
リリースチャネルが有効なプロセス¶
リリースチャネルを明示的に有効にするには、 config.toml
ファイルの [cli.features]
セクションに:codenowrap:enable_release_channels=true
を追加します。リリースチャネルを有効にした後、アプリケーションパッケージを再作成または更新する必要があります。リリースチャネルが有効になっていることを確認するには、 snow app release-channel list コマンドを実行します。アプリケーションパッケージ内のリリースチャネルのリストが表示されます。
snow app release-channel list
既存のバージョンとパッチをデフォルトのリリースチャンネルですべての顧客に公開する最も簡単な方法は、 snow app publish コマンドに:codenowrap:--version
と:codenowrap:--patch
オプションを付けることです。
snow app publish --version v1 --patch 1
新しいバージョンとパッチを自動的に作成するには、--create-version
オプションを使います。
snow app publish --version v1 --create-version
Snowflake Native App をデフォルト以外のリリースチャネルに公開するには、:codenowrap:`--channel ` オプションを使います。
snow app publish --version v1 --patch 1 --channel ALPHA
特定の顧客をターゲットにしたカスタムリリースディレクティブに Snowflake Native App を発行するには、--directive
オプションを使います。
snow app publish --version v1 --patch 1 --channel ALPHA --directive customers_group_1
snow app publish
コマンドは、バージョンをリリースチャネルに追加します。リリースチャネルがすでに許容される最大数のバージョンを持っている場合、このコマンドはまず、どのリリースディレクティブでも参照されていないバージョンの一つをチャネルから削除しようとします。
リリースチャネルにバージョンを追加した後、コマンドはそのリリースチャンネルのデフォルトのリリースディレクティブを指定されたバージョンとパッチにセットします。
何が起こっているかをよりコントロールするには、前のコマンドを次のコマンドに置き換えてください。
snow app release-channel add-version --version v1 ALPHA
snow app release-directive set customers_group_1 --version v1 --patch 1
リリースチャネルおよびリリースディレクティブの管理に関する詳細情報は、 snow app release-channel および snow app release-directive コマンドリファレンスを参照してください。
リリースチャンネルを無効にしたプロセス¶
リリースチャネルがアプリケーションパッケージで有効になっていない場合、リリースディレクティブはアプリケーションパッケージに直接関連付けられます。
既存のバージョンとパッチをすべての顧客に公開する最も簡単な方法は、 snow app publish コマンドに:codenowrap:--version
と:codenowrap:--patch
オプションを付けることです。
snow app publish --version v1 --patch 1
このコマンドは、アプリケーションパッケージのデフォルトのリリースディレクティブを、指定されたバージョンとパッチにセットします。この場合、リリース・チャネルは有効になっていないため、この処理にはリリース・チャネルは関与しません。
publishコマンドで自動的に新しいバージョンとパッチを作成したい場合は、--create-version
オプションを使います。
snow app publish --version v1 --create-version
特定の顧客をターゲットにしたカスタムリリースディレクティブに Snowflake Native App を発行するには、--directive
オプションを使います。
snow app publish --version v1 --patch 1 --directive customers_group_1
これらの snow app publish
コマンドは、将来リリースチャンネルが有効になっても機能し続けます。リリース・チャネルが有効になっている場合、コマンドはデフォルトのリリース・チャネルを使用して開始します。