Atualizar um app usando canais de lançamento¶

Sobre as atualizações de aplicativos¶

O Snowflake Native App Framework permite que os provedores atualizem um app para uma nova versão ou patch.

Os provedores podem iniciar uma atualização de um app para uma nova versão ou patch definindo a diretiva de lançamento em um canal de lançamento. 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 para atualizar um app¶

Um provedor atualiza um app 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.

1. Crie uma nova versão ou patch para as alterações no canal de lançamento.

   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.

2. Teste a nova versão instalando o app em sua conta de teste.

3. 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 atualize o app manualmente.

Definir uma data e hora de início para um upgrade¶

Os provedores podem definir uma data e hora que especifica quando um upgrade automático deve começar. Essa data e hora são definidas na diretiva de lançamento (padrão ou personalizada) usando a cláusula UPGRADE_AFTER do comando ALTER APPLICATION PACKAGE. Há suporte para diretivas de lançamento padrão e personalizadas.

A data e a hora do upgrade podem ser qualquer tipo válido de data e hora. Se o carimbo de data/hora já tiver passado, o upgrade será agendado imediatamente. Esse é o mesmo comportamento de não definir a cláusula UPGRADE_AFTER.

Você só pode usar a cláusula UPGRADE_AFTER se estiver definindo a versão e o patch. Essa cláusula não pode ser usada para modificar apenas a data e a hora do upgrade.

Início da atualização¶

O processo de atualização começa automaticamente quando um provedor atualiza a diretiva de lançamento (padrão ou personalizada) do canal de lançamento 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
  MODIFY RELEASE CHANNEL DEFAULT
  SET DEFAULT RELEASE DIRECTIVE
  VERSION = v2
  PATCH = 0;

Este comando define a diretiva de lançamento padrão para a versão v2 e o patch 0 para o canal de lançamento padrão.

ALTER APPLICATION PACKAGE my_application_package
  MODIFY RELEASE CHANNEL DEFAULT
  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 Set the release directive for an app (Legacy) 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. Este comando inicia a atualização de uma versão ou patch instalado de um app usando a diretiva de lançamento especificada no canal de lançamento.

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 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 Gerenciar e monitorar as configurações de preenchimento automático para saber 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 fornece várias maneiras de solucionar problemas de atualização, conforme descrito nas seções a seguir:

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