Publication d’une Snowflake Native App à l’intention des clients¶
Conditions préalables¶
Vous devez avoir une connexion existante dans votre fichier
config.toml.Vous devez avoir un fichier
snowflake.ymldans votre projet Snowflake Native App.Vous devez avoir une annonce existante si vous publiez une Snowflake Native App sur le Snowflake Marketplace.
Comment publier une Snowflake Native App à l’intention des clients ?¶
Dans Snowflake, la publication d’une Snowflake Native App à l’intention des clients s’effectue en paramétrant les directives de publication. Les directives de version sont un ensemble de règles qui déterminent quelle version et quel correctif de la Snowflake Native App sont disponibles pour les clients.
Les canaux de version permettent de gérer des processus de version distincts pour différents types de clients. Par exemple, les clients bénéficiant d’un accès anticipé peuvent utiliser le canal ALPHA, l’équipe de QA interne peut utiliser le canal QA et les clients généraux peuvent utiliser le canal DEFAULT.
Si les canaux de version sont activés pour un paquet d’application, les directives de diffusion sont liées aux canaux de version ; dans le cas contraire, les directives de version sont liées directement au paquet d’application.
Note
La fonction de canaux de version peut ne pas être disponible dans toutes les régions. Veuillez contacter l’assistance de Snowflake pour obtenir plus d’informations.
Processus avec canaux de version activés¶
Pour activer explicitement les canaux de version, ajoutez enable_release_channels=true dans la section [cli.features] de votre fichier config.toml. Vous devez recréer ou mettre à jour votre paquet d’application après avoir activé les canaux de version. Pour confirmer que les canaux de version ont été activés, exécutez la commande snow app release-channel list. La liste des canaux de version du paquet d’application s’affiche alors :
snow app release-channel list
La manière la plus simple de publier une version existante et un correctif à tous les clients sur le canal de version par défaut est d’utiliser la commande snow app publish avec les options --version et --patch :
snow app publish --version v1 --patch 1
Pour créer automatiquement une nouvelle version et un nouveau correctif, utilisez l’option --create-version :
snow app publish --version v1 --create-version
Pour publier une Snowflake Native App sur un canal de version autre que celui par défaut, utilisez l’option --channel :
snow app publish --version v1 --patch 1 --channel ALPHA
Pour publier une Snowflake Native App dans une directive de version personnalisée ciblant des clients spécifiques, utilisez l’option --directive :
snow app publish --version v1 --patch 1 --channel ALPHA --directive customers_group_1
La commande snow app publish ajoute la version au canal de version. Si le canal de version contient déjà le nombre maximal de versions autorisé, cette commande tente d’abord de supprimer du canal l’une des versions non référencées par une directive de version.
Après avoir ajouté la version au canal de version, la commande paramètre la directive de version par défaut de ce canal de version sur la version et le correctif spécifiés.
Pour mieux contrôler ce qui se passe, remplacez la commande précédente par les commandes suivantes :
snow app release-channel add-version --version v1 ALPHA
snow app release-directive set customers_group_1 --version v1 --patch 1
Pour plus d’informations sur la gestion des canaux de version et des directives de version, consultez les références des commandes snow app release-channel et snow app release-directive.
Processus avec canaux de version désactivés¶
Si les canaux de version ne sont pas activés pour un paquet d’application, les directives de version sont directement liées au paquet d’application.
La manière la plus simple de publier une version existante et un correctif à tous les clients est d’utiliser la commande snow app publish avec les options --version et --patch.
snow app publish --version v1 --patch 1
Cette commande permet de définir la directive de version par défaut du paquet d’application sur la version et le correctif spécifiés. Dans ce cas, les canaux de version ne sont pas activés, de sorte qu’aucun canal de version n’est impliqué dans ce processus.
Si vous souhaitez que la commande de publication crée automatiquement une nouvelle version et un nouveau correctif, utilisez l’option --create-version :
snow app publish --version v1 --create-version
Pour publier une Snowflake Native App dans une directive de version personnalisée ciblant des clients spécifiques, utilisez l’option --directive :
snow app publish --version v1 --patch 1 --directive customers_group_1
Ces commandes snow app publish continuent de fonctionner même si les canaux de version sont activés à l’avenir. Lorsque les canaux de version sont activés, la commande commence à utiliser le canal de version par défaut.