Upgrade de um aplicativo¶

Sobre upgrades¶

O Snowflake Native App Framework permite que os provedores atualizem um aplicativo para uma nova versão ou patch. Para ver como as atualizações se encaixam no fluxo de trabalho geral para o desenvolvimento de uma nova versão ou patch de um aplicativo, consulte Fluxo de trabalho para atualizar um aplicativo.

Os provedores podem iniciar uma atualização de um aplicativo para uma nova versão ou patch definindo uma diretriz de versão no pacote do aplicativo. Quando a diretriz de versão é modificada, o Snowflake atualiza automaticamente todas as instâncias instaladas da versão atual do aplicativo para a versão especificada pela diretriz de versão.

Quando o provedor inicia uma atualização, o Snowflake adiciona cada aplicativo a ser atualizado a uma fila. Cada aplicativo é atualizado à medida que os recursos estão disponíveis. O processo de atualização pode demorar um pouco para ser concluído em todas as versões instaladas do aplicativo. Para agilizar o processo de atualização, os consumidores também podem iniciar manualmente uma atualização de um aplicativo quando uma nova versão ou patch estiver disponível.

Fluxo de trabalho de atualização¶

Um provedor faz o upgrade de um aplicativo instalado usando o seguinte fluxo de trabalho:

1. Atualize o aplicativo para incluir novos recursos.

2. Se você estiver criando uma nova versão do aplicativo e houver duas versões atualmente definidas para o aplicativo:

   1. Certifique-se de que nenhum consumidor esteja executando a versão no momento.

   2. Descarte a versão do aplicativo que você está substituindo.

3. Crie uma nova versão ou patch para as alterações no pacote de aplicativo.

   Se a propriedade DISTRIBUTION do pacote do aplicativo estiver definida como EXTERNAL, a verificação de segurança automatizada será iniciada. A verificação de segurança deve passar antes que o upgrade possa ocorrer.

4. Teste a nova versão criando a instalação do aplicativo em sua conta de teste.

5. Atualize a diretriz de versão da versão ou patch.

   Isso inicia um upgrade automatizado que atualizará todas as instâncias instaladas da versão anterior. Um provedor pode notificar o consumidor de que uma atualização está disponível e solicitar que ele faça a atualização manual do aplicativo.

Início da atualização¶

O processo de atualização é iniciado automaticamente quando um provedor atualiza a diretriz de versão (padrão ou personalizada) do pacote do aplicativo para apontar para uma nova versão ou patch. Use o comando ALTER APPLICATION PACKAGE … RELEASE DIRECTIVE para definir a diretriz de versão, conforme mostrado nos exemplos a seguir:

ALTER APPLICATION PACKAGE my_application_package SET DEFAULT RELEASE DIRECTIVE
  VERSION = v2
  PATCH = 0;

Esse comando define a diretriz de versão padrão para a versão v2 e o patch 0.

ALTER APPLICATION PACKAGE my_application_package
  SET RELEASE DIRECTIVE my_custom_release_directive
  ACCOUNTS = ( USER_ACCOUNT.snowflakecomputing.com )
  VERSION = v2
  PATCH = 0;

Esse comando define a diretriz de versão personalizada chamada my_custom_release_directive para a versão v2 e o patch 0 para a conta USER_ACCOUNT.snowflakecomputing.com.

Consulte Configuração da diretriz de lançamento para um aplicativo para obter mais informações.

Atualização manual de um aplicativo¶

As atualizações manuais permitem que um consumidor atualize seu aplicativo instalado mais rapidamente do que as atualizações automatizadas. Quando uma nova versão ou patch estiver disponível, o provedor poderá solicitar ao consumidor que faça uma atualização manual.

O consumidor realiza uma atualização manual executando o ALTER APPLICATION. Esse comando inicia a atualização de uma versão instalada ou de um patch de um aplicativo usando a diretriz de versão especificada no pacote do aplicativo.

Para fazer o upgrade de um Snowflake Native App instalado para a versão mais recente disponível, um consumidor pode usar a cláusula UPGRADE do comando ALTER APPLICATION para modificar o objeto do aplicativo:

ALTER APPLICATION <name> UPGRADE

Atualização de um aplicativo em todas as regiões¶

Depois de atualizar o aplicativo, as alterações no Snowflake Native App instalado na conta do consumidor podem não ficar visíveis até que a atualização para regiões remotas seja executada.

Você pode usar o Exibição APPLICATION_STATE no esquema Uso de Data Sharing para monitorar o estado. Se o upgrade não for concluído mais de um dia após a primeira atualização depois do upgrade, pode haver um problema com o processo de atualização. Entre em contato com o suporte Snowflake.

Se um provedor publicar um Snowflake Native App usando o Preenchimento automático entre nuvens, as atualizações automatizadas poderão demorar um pouco para serem atualizadas, dependendo de vários fatores, inclusive:

• O valor do agendamento de atualização.

• O número de instâncias instaladas do aplicativo.

• O número de regiões onde o aplicativo está implantado.

Se a atualização contiver uma correção urgente que precise ser atualizada em uma região remota, o provedor poderá reduzir a frequência de atualização da listagem para um valor menor. Consulte Monitoramento e gerenciamento de configurações de preenchimento automático para obter informações sobre como definir a frequência de atualização no nível da conta.

Cuidado

A redução da frequência de atualização pode aumentar os custos associados à replicação.

Atualização de estados¶

Durante o processo de atualização, o aplicativo passa por diferentes estados. O diagrama a seguir mostra os possíveis estados ao fazer upgrade da versão anterior, v1, para uma nova versão, v2.

A tabela a seguir mostra cada estágio do processo de upgrade de um aplicativo na mesma região em que o pacote do aplicativo está localizado:

A tabela a seguir mostra o processo de upgrade para aplicativos que são implementados em regiões remotas:

A tabela a seguir descreve cada um dos possíveis estados do processo de upgrade:

Monitoramento do estado de uma atualização¶

Para visualizar o estado de atualização de um aplicativo, use o Exibição APPLICATION_STATE.

Por exemplo, em uma situação em que você atualizou a diretriz de versão padrão e deseja verificar se todos os aplicativos atingiram a versão de destino. Para localizar instâncias de aplicativos que ainda não concluíram o upgrade, use a consulta do exemplo a seguir:

SELECT * FROM snowflake.data_sharing_usage.APPLICATION_STATE

Essa exibição inclui colunas específicas para upgrades, incluindo o estado do upgrade e a região onde o aplicativo está implantado. Para obter informações sobre os estados de upgrade, consulte Atualização de estados.

Solução de problemas durante a atualização¶

O Snowflake Native App Framework oferece várias maneiras de solucionar problemas de upgrade:

Aplicativos desativados¶

Quando um aplicativo instalado na conta do consumidor é desativado, ele não pode mais ser usado. Um aplicativo instalado em uma conta de consumidor pode ser desativado por vários motivos, inclusive:

• Problemas com o pacote do aplicativo

• Problemas com o aplicativo instalado

• Problemas com a conta do consumidor

Tanto os provedores quanto os consumidores devem evitar situações em que um aplicativo permaneça desativado por um longo período. Os aplicativos desativados podem se tornar inutilizáveis e precisam ser reinstalados