Publicação de um Snowflake Native App para os clientes¶
Pré-requisitos¶
Você deve ter uma conexão existente em seu arquivo
config.toml.Você deve ter um arquivo
snowflake.ymlem seu projeto Snowflake Native App.Você deve ter uma listagem existente se estiver publicando um Snowflake Native App no Snowflake Marketplace.
Como publicar um Snowflake Native App para os clientes¶
No Snowflake, a publicação de um Snowflake Native App para os clientes é feita por meio da definição de diretrizes de versão. As diretrizes de versão são um conjunto de regras que determinam qual versão e patch do Snowflake Native App está disponível para quais clientes.
Os canais de lançamento oferecem uma maneira de gerenciar processos de lançamento separados para diferentes tipos de clientes. Por exemplo, os clientes de acesso antecipado podem usar o canal ALPHA, a equipe interna de QA pode usar o canal QA e os clientes em geral podem usar o canal DEFAULT.
Se os canais de lançamento estiverem ativados para um pacote de aplicativo, as diretrizes de versão serão vinculadas aos canais de lançamento; caso contrário, as diretrizes de versão serão vinculadas diretamente ao pacote de aplicativo.
Nota
O recurso de canais de lançamento pode não estar disponível em todas as regiões. Entre em contato com o suporte Snowflake para obter mais informações.
Processo com canais de lançamento ativados¶
Para habilitar explicitamente os canais de lançamento, adicione enable_release_channels=true na seção [cli.features] do seu arquivo config.toml. Você precisa recriar ou atualizar o pacote do aplicativo depois de ativar os canais de lançamento. Para confirmar que os canais de lançamento foram ativados, execute o comando snow app release-channel list. Em seguida, é exibida uma lista de canais de lançamento no pacote de aplicativo:
snow app release-channel list
A maneira mais simples de publicar uma versão e um patch existentes para todos os clientes no canal de lançamento padrão é usar o comando snow app publish com as opções --version e --patch:
snow app publish --version v1 --patch 1
Para criar automaticamente uma nova versão e um patch, use a opção --create-version:
snow app publish --version v1 --create-version
Para publicar um Snowflake Native App em um canal de lançamento não padrão, use a opção --channel:
snow app publish --version v1 --patch 1 --channel ALPHA
Para publicar um Snowflake Native App em uma diretriz de versão personalizada direcionada a clientes específicos, use a opção --directive:
snow app publish --version v1 --patch 1 --channel ALPHA --directive customers_group_1
O comando snow app publish adiciona a versão ao canal de lançamento. Se o canal de lançamento já tiver o número máximo de versões permitido, esse comando tentará primeiro remover do canal uma das versões não referenciadas por nenhuma diretriz de versão.
Depois de adicionar a versão ao canal de lançamento, o comando define a diretriz de versão padrão desse canal de lançamento para a versão e o patch especificados.
Para ter mais controle sobre o que está acontecendo, substitua o comando anterior pelos seguintes comandos:
snow app release-channel add-version --version v1 ALPHA
snow app release-directive set customers_group_1 --version v1 --patch 1
Para obter mais informações sobre o gerenciamento de canais de lançamento e diretrizes de versão, consulte as referências de comando snow app release-channel e snow app release-directive.
Processo com canais de lançamento desativados¶
Se os canais de lançamento não estiverem ativados para um pacote de aplicativo, as diretrizes de versão serão vinculadas diretamente ao pacote de aplicativo.
A maneira mais simples de publicar uma versão e um patch existentes para todos os clientes é usar o comando snow app publish com as opções --version e --patch.
snow app publish --version v1 --patch 1
Esse comando define a diretriz de versão padrão do pacote do aplicativo para a versão e o patch especificados. Nesse caso, os canais de lançamento não estão ativados, portanto, nenhum canal de lançamento está envolvido nesse processo.
Se você quiser que o comando publish crie automaticamente uma nova versão e um patch, use a opção --create-version:
snow app publish --version v1 --create-version
Para publicar um Snowflake Native App em uma diretriz de versão personalizada direcionada a clientes específicos, use a opção --directive:
snow app publish --version v1 --patch 1 --directive customers_group_1
Esses comandos snow app publish continuam a funcionar mesmo que os canais de lançamento sejam ativados no futuro. Quando os canais de lançamento estão ativados, o comando começa a usar o canal de lançamento padrão.