Déploiement canari pour une application - Serverless App Engine

Configurez un déploiement canari pour déployer progressivement une nouvelle version d'application et revenez à la version précédente en cas de problème.

Prérequis

L'application dispose de plusieurs instances.

Informations générales

Le déploiement canari vous permet de déployer une nouvelle version de votre application parallèlement à la version existante. Cette stratégie permet de tester les performances de la nouvelle version avec un petit sous-ensemble du trafic, ce qui aide à identifier et à corriger les problèmes tôt tout en maintenant la stabilité globale du système.

Lors d'un déploiement canari, le lot canari ne peut pas dépasser 50 % du nombre total d'instances afin de garantir la stabilité. Les instances restantes sont déployées dans les lots suivants. Après la publication du premier lot, vous pouvez décider manuellement de poursuivre ou non avec le lot suivant, ce qui permet de recueillir des commentaires et de surveiller les performances avant un déploiement complet.

Un déploiement canari utilise l'une des deux approches principales suivantes :

Répartition du trafic : acheminez un pourcentage du trafic vers la nouvelle version. Par exemple, envoyez 20 % du trafic vers la nouvelle version et 80 % vers l'ancienne version.
Routage basé sur le contenu : acheminez le trafic en fonction des attributs de la requête, tels que les en-têtes ou les ID utilisateur. Par exemple, dirigez les requêtes d'utilisateurs spécifiques vers la nouvelle version.

Par rapport à un déploiement par phases, le déploiement canari offre un contrôle plus granulaire du trafic. Pour plus d'informations sur les déploiements par phases, consultez la rubrique Effectuer un déploiement par phases pour une application.

Scénario d'exemple

Une application comporte 10 instances exécutant la version 1 (Ver.1). Vous devez mettre à niveau toutes les instances vers la version 2 (Ver.2). Dans ce scénario, effectuez d'abord un déploiement canari sur 2 instances, puis déployez les 8 instances restantes en 3 lots. Le diagramme suivant illustre ce processus.

Procédure

Avertissement

Après le redéploiement d'une application, celle-ci est redémarrée. Afin d'éviter des erreurs imprévisibles telles que des interruptions d'activité, nous vous recommandons de déployer les applications pendant les heures creuses.

Sur la page Liste des applications SAE, sélectionnez une région et un namespace en haut de la page, puis cliquez sur l'ID de l'application cible pour ouvrir la page des détails de l'application.
Sur la page Basic Information de l'application cible, cliquez sur Deploy Application.
Configurez les paramètres de déploiement.

Remarque
La méthode de déploiement d'une application dépend de la méthode sélectionnée lors du premier déploiement. Configurez les paramètres en fonction de la méthode sélectionnée.
- Déploiement avec des packages WAR : téléchargez un autre package WAR ou saisissez le chemin d'accès d'un package WAR nouvellement déployé, et configurez l'environnement d'exécution et d'autres paramètres.
- Déploiement avec des packages JAR : téléchargez un autre package JAR ou saisissez le chemin d'accès d'un package JAR nouvellement déployé, et configurez l'environnement d'exécution et d'autres paramètres.
- Déploiement avec des packages ZIP : téléchargez un autre package ZIP ou saisissez le chemin d'accès d'un package ZIP nouvellement déployé, et configurez l'environnement d'exécution et d'autres paramètres.
- Image : dans la section Configure Image, cliquez sur Modify Image. Dans le panneau Modify Image, sélectionnez un autre référentiel d'images ou une autre version d'image.

Dans la section Release Policy Settings, configurez le déploiement canari.

Paramètre	Description
Release Policy	Sélectionnez Canary Release (Phased).
Instances for Canary Release	Spécifiez le nombre d'instances à inclure dans le lot canari initial.
Remaining Batches After Canary Release	Après le déploiement canari, les instances restantes sont déployées sur le nombre de lots spécifié.
Peak Volume	Correspond au paramètre Kubernetes `MaxSurge` : nombre maximal d'instances pouvant être créées au-delà du nombre souhaité lors d'une mise à jour. Important Cette fonctionnalité est en aperçu sur invitation. Pour demander l'accès, contactez notre équipe dans le groupe DingTalk (ID : 32874633). Remarque Si le paramètre Minimum Available Instances est défini sur 100 % (ce qui signifie que `MaxUnavailable` est égal à 0), le paramètre Peak Volume ne peut pas être égal à 0. Si vous utilisez un pourcentage, la valeur est arrondie à l'entier supérieur. Par exemple, si vous disposez de 5 instances et que vous définissez cette valeur sur 25 %, la valeur du paramètre Peak Volume est 2.
Minimum Available Instances	Nombre minimal d'instances qui doivent rester disponibles lors d'une mise à jour progressive. Remarque Nous vous recommandons de définir le paramètre Minimum Available Instances sur 1 ou plus pour assurer la continuité de l'activité. Si ce paramètre est défini sur 0, l'application sera interrompue pendant la mise à niveau. Si vous utilisez un pourcentage, la valeur est arrondie à l'entier supérieur. Par exemple, si vous disposez de 5 instances et que vous définissez cette valeur sur 25 %, le nombre d'Minimum Available Instances est de 2.
Activer la règle de déploiement canari pour le trafic de couche 7 (Kubernetes Ingress)	Prend effet uniquement après avoir créé une règle de déploiement canari pour le trafic de couche 7 (Kubernetes Ingress).
Enable Canary Release Rule of Microservices (Spring Cloud and Dubbo Applications)	Prend effet uniquement après avoir créé une règle de déploiement canari pour le trafic des microservices.

Une fois la configuration terminée, cliquez sur OK.
Vérifiez le déploiement de l'une des manières suivantes :
- Méthode 1 : sur la page Change Records de l'application, consultez les détails de la modification et l'état de la publication. Si tous les lots sont terminés avec succès, la mise à jour de l'application est achevée.
- Méthode 2 : dans l'onglet Instances de la page Basic Information de l'application, vérifiez l'état des instances. Si l'Status est Running, l'application est déployée avec succès.

Retour arrière d'une application

Lorsque vous mettez à niveau une application à l'aide d'un déploiement canari ou par phases, l'état de l'application reste Executing jusqu'à ce que toutes les instances soient mises à niveau.

Si le premier lot d'instances cesse de répondre en raison d'un problème inattendu lors de la mise à niveau, accédez à la page Change Details et cliquez sur Roll Back Now. Cette opération restaure les instances mises à niveau vers la version précédente et rétablit leurs configurations d'origine.

Si une exception se produit pendant le processus de modification, telle qu'un package de déploiement indisponible ou un échec du contrôle de santé, la mise à niveau échoue. SAE arrête automatiquement le processus et lance un retour arrière de l'application.

Une mise à niveau d'application dans SAE expire après environ 30 minutes. Si cela se produit, SAE signale une exception de délai d'attente et suspend le processus de modification. Vous devez alors accéder à la page Change Details pour annuler manuellement la publication et effectuer un retour arrière de l'application.

Annuler une publication

Pour arrêter une publication en cours, cliquez sur Stop Deployment sur la page Change Details.

Important

L'annulation d'une publication peut entraîner l'exécution simultanée de plusieurs versions de votre application :

Instances déjà déployées : continueront à s'exécuter dans leur état actuel et ne feront pas l'objet d'un retour arrière.
Instances en cours de déploiement : ces instances termineront leur déploiement, puis s'exécuteront sur la nouvelle version de cette publication.
Instances non encore déployées (y compris toutes les instances des lots suivants) : resteront dans leur état actuel et le processus de publication sera interrompu pour elles.
Nouvelles instances issues de la mise à l'échelle automatique : utiliseront la nouvelle version pour les événements de montée en charge.

Après l'annulation, nous vous recommandons de redéployer l'application ou de revenir à une version précédente dès que possible afin de garantir que toutes les instances exécutent la même version.

Plus d'informations

Après avoir déployé une application dans SAE, vous pouvez effectuer les opérations suivantes.

Actions	Documentation associée
Gérez le cycle de vie de l'application, par exemple la mise à jour, la mise à l'échelle, le démarrage, l'arrêt ou la suppression de l'application.	Gérer le cycle de vie d'une application
Optimisez les performances de l'application en configurant la mise à l'échelle automatique, en liant une instance Server Load Balancer (SLB) ou en créant des règles de démarrage et d'arrêt planifiées.	Configurer une politique de mise à l'échelle automatique Lier une instance SLB pour obtenir une adresse IP publique ou privée Créer une règle de démarrage et d'arrêt planifiés Gérer les configurations distribuées (ACM) Modifier les spécifications des instances
Surveillez l'état de l'application en gérant les journaux, en consultant les données de surveillance, en vérifiant les événements et en examinant les enregistrements de modification.	Gestion des journaux Gestion de la surveillance Afficher les événements de l'application Afficher les enregistrements de modification Diagnostiquer une application à l'aide de webshell