Mettre à niveau une application à l’aide de canaux de version¶

À propos des mises à niveau de l’application¶

Le Snowflake Native App Framework permet aux fournisseurs de mettre à niveau une application vers une nouvelle version ou un nouveau correctif.

Les fournisseurs peuvent lancer la mise à niveau d’une application vers une nouvelle version ou un nouveau correctif en paramétrant la directive de version sur le canal de version. Lorsque la directive de version est modifiée, Snowflake met automatiquement à niveau toutes les instances installées de la version actuelle de l’application vers la version spécifiée par la directive de version.

Lorsque le fournisseur lance une mise à niveau, Snowflake ajoute chaque application à mettre à niveau à une file d’attente. Chaque application est mise à jour au fur et à mesure de la disponibilité des ressources. Le processus de mise à niveau peut prendre un certain temps pour s’achever sur l’ensemble des versions installées de l’application. Pour accélérer le processus de mise à niveau, les consommateurs peuvent également lancer manuellement la mise à niveau d’une application lorsqu’une nouvelle version ou un correctif est disponible.

Workflow de mise à niveau d’une application¶

Un fournisseur met à niveau une application via le workflow suivant :

1. Mettez à jour l’application pour y inclure toute nouvelle fonction.

2. Si vous créez une nouvelle version de l’application et que deux versions sont actuellement définies pour l’application :

1. Assurez-vous qu’aucun consommateur n’utilise actuellement cette version.

2. Déposez la version de l’application que vous remplacez.

1. Créez une nouvelle version ou un nouveau correctif pour les modifications apportées au canal de version.

   Si la propriété DISTRIBUTION du paquet d’application est définie sur EXTERNAL, l’analyse de sécurité automatisée est lancée. L’analyse de sécurité doit s’effectuer correctement avant que la mise à niveau puisse avoir lieu.

2. Testez la nouvelle version en installant l’application dans votre compte de test.

3. Mettez à jour la directive de version pour la version ou le correctif.

   Cette opération lance une mise à niveau automatisée qui mettra à jour toutes les instances installées de la version précédente. Un fournisseur peut avertir le consommateur qu’une mise à niveau est disponible et lui demander de mettre à niveau manuellement l’application.

Définir une date et une heure de début d’une mise à niveau¶

Les fournisseurs peuvent définir une date et une heure qui spécifient le début d’une mise à niveau automatique. Cette date et cette heure sont définies dans la directive de version (par défaut ou personnalisée) à l’aide de la clause UPGRADE_AFTER de la commande ALTER APPLICATION PACKAGE. Les directives de version par défaut et personnalisées sont prises en charge.

La date et l’heure de la mise à niveau peuvent être n’importe quel type de date et d’heure valide. Si l’horodatage est déjà dépassé, la mise à niveau est immédiatement planifiée. Cela revient à ne pas définir la clause UPGRADE_AFTER.

Vous ne pouvez utiliser la clause UPGRADE_AFTER que si vous définissez la version et le correctif. Cette clause ne peut pas être utilisée pour modifier uniquement la date et l’heure de la mise à niveau.

Démarrer une mise à niveau¶

Le processus de mise à niveau démarre automatiquement lorsqu’un fournisseur met à jour la directive de version (par défaut ou personnalisée) du canal de version pour qu’elle pointe vers une nouvelle version ou un nouveau correctif. Utilisez la commande ALTER APPLICATION PACKAGE … RELEASE DIRECTIVE pour paramétrer la directive de version comme indiqué dans les exemples suivants :

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

Cette commande définit la directive de version par défaut sur la version v2 et le correctif 0 pour le canal de version par défaut.

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;

Cette commande définit la directive de version personnalisée nommée my_custom_release_directive sur la version v2 et le correctif 0 pour le compte USER_ACCOUNT. snowflakecomputing.com.

Pour plus d’informations, voir Set the release directive for an app (Legacy).

Mise à niveau manuelle d’une application¶

Les mises à niveau manuelles permettent à un consommateur de mettre à jour son programme d’installation plus rapidement que les mises à niveau automatisées. Lorsqu’une nouvelle version ou un nouveau correctif est disponible, un fournisseur peut demander au consommateur d’effectuer une mise à niveau manuelle.

Le consommateur effectue une mise à niveau manuelle en exécutant le programme ALTER APPLICATION. Cette commande lance la mise à niveau d’une version installée ou d’un correctif d’une application en utilisant la directive de version spécifiée dans le canal de version.

Pour mettre à niveau une Snowflake Native App installée à la dernière version disponible, un consommateur peut utiliser la clause UPGRADE de la commande ALTER APPLICATION pour modifier l’application :

ALTER APPLICATION <name> UPGRADE

Mise à niveau d’une application dans plusieurs régions¶

Après la mise à niveau d’une application, les modifications apportées à l”Snowflake Native App dans le compte du consommateur peuvent ne pas être visibles tant que l’actualisation des régions distantes n’est pas effectuée.

Vous pouvez utiliser le Vue APPLICATION_STATE dans le schéma Utilisation de Data Sharing pour contrôler le statut. Si la mise à niveau n’est pas terminée plus d’un jour après la première actualisation suivant la mise à niveau, il se peut qu’il y ait un problème avec le processus d’actualisation. Contactez l’assistance Snowflake.

Si un fournisseur publie une Snowflake Native App via Exécution automatique inter-Cloud, les mises à niveau automatisées peuvent prendre un certain temps en fonction de plusieurs facteurs, notamment :

• La valeur de la planification d’actualisation.

• Le nombre d’instances installées de l’application.

• Le nombre de régions dans lesquelles l’application est déployée.

Si la mise à niveau contient une correction urgente qui doit être mise à jour dans une région distante, le fournisseur peut réduire la fréquence d’actualisation de l’annonce à une valeur plus petite. Consultez Gestion et suivi des paramètres d’exécution automatique pour obtenir des informations sur le paramétrage de la fréquence d’actualisation au niveau du compte.

Prudence

La réduction de la fréquence d’actualisation peut augmenter les coûts associés à la réplication.

États de mise à niveau¶

Au cours du processus de mise à niveau, l’application passe par différents états. Le diagramme suivant montre les états possibles lors de la mise à niveau de la version précédente, v1, vers une nouvelle version, v2.

Le tableau suivant présente chaque zone de préparation de la procédure de mise à niveau pour une application dans la même région que celle où se trouve le paquet d’application :

Le tableau suivant présente le processus de mise à niveau pour les applications déployées dans des régions distantes :

La tableau suivant décrit chacun des états possibles du processus de mise à niveau :

Contrôler l’état d’une mise à niveau¶

Pour voir l’état de la mise à niveau d’une application, utilisez la rubrique Vue APPLICATION_STATE.

Par exemple, dans une situation où vous avez mis à niveau la directive de version par défaut et souhaitez voir si toutes les applications ont atteint la version cible. Pour trouver les instances d’application qui n’ont pas encore terminé la mise à niveau, utilisez la requête de l’exemple suivant :

SELECT * FROM snowflake.data_sharing_usage.APPLICATION_STATE

Cette vue comprend des colonnes spécifiques aux mises à niveau, notamment l’état de mise à niveau et la région dans laquelle l’application est déployée. Pour des informations sur les états de mise à niveau, voir États de mise à niveau.

Résoudre les problèmes de mise à niveau¶

Le Snowflake Native App Framework fournit plusieurs moyens de résoudre les problèmes liés à la mise à niveau, comme décrit dans les sections suivantes :

Applications désactivées¶

Lorsqu’une application installée dans le compte du consommateur est désactivée, elle n’est plus utilisable. Une application installée sur le compte d’un consommateur peut être désactivée pour de multiples raisons, notamment :

• Problèmes liés au paquet d’application

• Problèmes liés à l’application installée

• Problèmes avec le compte consommateur

Les fournisseurs comme les consommateurs doivent éviter les situations où une application reste désactivée pendant une période prolongée. Les applications désactivées peuvent devenir inutilisables et doivent être réinstallées