Share via


Préférence de mise à niveau pour la maintenance planifiée de l’environnement App Service

Azure App Service est régulièrement mis à jour pour fournir de nouvelles fonctionnalités, de nouvelles versions d’exécution, des améliorations des performances et des correctifs de bogues. On parle aussi de maintenance planifiée. La mise à niveau se produit automatiquement. Les mises à niveau sont appliquées progressivement par le biais des régions qui suivent les pratiques de déploiement sécurisé Azure. Azure App Service Environment est une fonctionnalité d’Azure App Service qui fournit un environnement totalement isolé et dédié dans le cadre de l’exécution sécurisée à grande échelle de vos applications App Service. En raison de la nature isolée d’App Service Environment, vous avez la possibilité d’influer sur le processus de mise à niveau.

Si vous n’avez pas d’App Service Environment, consultez Comment créer un App Service Environment v3.

Notes

Cet article aborde les fonctionnalités, les avantages et les cas d’utilisation d’App Service Environment v3, qui est utilisé avec les plans App Service Isolé v2.

Avec App Service Environment v3, vous pouvez spécifier quand et comment vous préférez que la maintenance planifiée soit appliquée. La mise à niveau peut être appliquée automatiquement ou manuellement. Même si vous optez pour l’application automatique, vous disposez de certaines options pour influer sur la planification.

Préférence de mise à niveau automatique

Quand vous utilisez une préférence de mise à niveau automatique, la plateforme met à niveau votre instance App Service Environment quand la mise à niveau est disponible dans la région dans laquelle l’instance est déployée. Vous pouvez choisir une de ces options :

  • Aucune est l’option par défaut. Cette option applique automatiquement la mise à niveau pendant le processus de mise à niveau pour cette région.
  • Tôt : la mise à niveau est appliquée automatiquement, mais elle fait partie des instances de la région à mettre à niveau en priorité.
  • Tard : la mise à niveau est appliquée automatiquement, mais elle fait partie des dernières instances de la région à être mises à niveau.

Dans les petites régions, les préférences de mise à niveau anticipée et tardive peuvent être très proches les unes des autres.

Préférence de mise à niveau manuelle

La préférence de mise à niveau manuelle vous donne la possibilité de recevoir une notification quand une mise à niveau est disponible. La disponibilité est également visible dans le portail Azure. Une fois la mise à niveau disponible, vous disposez de 15 jours pour démarrer le processus de mise à niveau. Si vous ne démarrez pas la mise à niveau dans les 15 jours, elle est traitée avec les mises à niveau automatiques restantes dans la région.

Notes

Dans de rares cas, la disponibilité de la mise à niveau peut être impactée par un correctif logiciel de sécurité prioritaire sur la mise à niveau planifiée ou par une régression trouvée dans la mise à niveau planifiée avant qu’elle n’ait été appliquée à votre instance. Dans ces rares cas, la mise à niveau disponible est supprimée au profit de la mise à niveau automatique.

Configurer les notifications

Quand une mise à niveau est disponible, Azure ajoute un événement de maintenance planifiée dans le tableau de bord Service Health d’Azure Monitor. Pour afficher les notifications passées dans le portail Azure, accédez à Accueil > Superviser > Service Health > Maintenance planifiée. Pour faciliter la recherche des événements pertinents, cochez la case Service et uniquement le type App Service. Vous pouvez également filtrer par abonnement et région.

Screenshot of the Service Health dashboard in the Azure portal.

Vous pouvez configurer des alertes pour envoyer un message à votre adresse e-mail et/ou numéro de téléphone pour l’envoi de SMS quand un événement est généré dans Azure Monitor. Vous pouvez également configurer un déclencheur pour votre fonction Azure personnalisée ou votre application logique, ce qui vous permet d’effectuer automatiquement des actions sur vos ressources. Cette action peut consister à détourner automatiquement le trafic de votre environnement App Service dans une région qui sera mise à niveau vers un environnement App Service dans une autre région. Ensuite, vous pouvez automatiquement rétablir le trafic en mode normal quand une mise à niveau est terminée.

Pour configurer des alertes pour les notifications de mise à niveau, sélectionnez Ajouter une alerte d’intégrité de service en haut du tableau de bord. Apprenez-en davantage sur les alertes Azure Monitor. Cet article de procédure vous guide tout au long de la configuration des alertes pour les événements d’intégrité de service. Enfin, vous pouvez suivre ce guide pratique pour apprendre à créer des groupes d’actions qui se déclenchent en fonction de l’alerte.

Envoyer des notifications de test

Quand vous générez votre logique d’automatisation et de notification, vous pouvez la tester avant que la mise à niveau réelle soit disponible, car celle-ci peut n’intervenir que dans plus d’un mois. Le portail Azure a la possibilité d’envoyer une notification de disponibilité de mise à niveau de test spéciale, que vous pouvez utiliser pour vérifier votre logique d’automatisation. Le message est similaire à la notification réelle, mais le titre est précédé de « [Test] » et la description est différente. Vous pouvez envoyer des notifications de test une fois que vous avez configuré votre préférence de mise à niveau sur Manuel.

Pour envoyer une notification de test, accédez à la page Configuration de votre environnement App Service et sélectionnez le lien Envoyer une notification de test. Les notifications de test sont envoyées par lots toutes les 15 minutes.

Screenshot of a configuration pane to send test notifications for the App Service Environment.

Utiliser le portail Azure pour configurer la préférence de mise à niveau

  1. À partir du portail Azure, accédez à la page Configuration de votre environnement App Service.
  2. Sélectionnez une préférence de mise à niveau. Screenshot of a configuration pane to select and update the upgrade preference for the App Service Environment.
  3. En haut de la page, sélectionnez « Enregistrer ».

Utiliser Azure CLI pour configurer la préférence de mise à niveau

L’expérience recommandée pour la mise à niveau consiste à utiliser le portail Azure. Si vous décidez d’utiliser Azure CLI pour effectuer et configurer la mise à niveau, vous devez suivre les étapes décrites ici dans l’ordre. Vous pouvez exécuter les commandes localement après avoir installé Azure CLI ou utiliser Azure Cloud Shell.

Remplacez les espaces réservés pour le nom et le groupe de ressources par vos valeurs pour l’environnement App Service que vous souhaitez configure. Pour voir la préférence de mise à niveau actuelle :

ASE_NAME=<Your-App-Service-Environment-name>
ASE_RG=<Your-Resource-Group>
az resource show --name $ASE_NAME -g $ASE_RG --resource-type "Microsoft.Web/hostingEnvironments" --query properties.upgradePreference

Pour mettre à jour la préférence de mise à niveau vers Manuel :

ASE_NAME=<Your-App-Service-Environment-name>
ASE_RG=<Your-Resource-Group>
az resource update --name $ASE_NAME -g $ASE_RG --resource-type "Microsoft.Web/hostingEnvironments" --set properties.upgradePreference=Manual

Utiliser le portail Azure pour mettre à niveau l’environnement App Service

Quand une mise à niveau est disponible, une bannière s’affiche dans le portail Azure. Pour démarrer la mise à niveau, procédez comme suit :

  1. À partir du portail Azure, accédez à la page Configuration de votre environnement App Service.
  2. Sélectionnez le bouton Mettre à niveau maintenant. Screenshot of a configuration pane to start the upgrade for the App Service Environment.
  3. Une bannière de confirmation s’affiche. Sélectionnez Démarrer la mise à niveau pour commencer le processus de mise à niveau. Vous recevrez des notifications pendant la mise à niveau si vous les avez configurées. Pour plus d’informations, consultez Configurer les notifications.

Utiliser Azure CLI pour mettre à niveau l’environnement App Service

Exécutez les commandes suivantes pour obtenir votre ID App Service Environment et le stocker en tant que variable d’environnement. Remplacez les espaces réservés pour le nom et le groupe de ressources par vos valeurs pour l’environnement App Service Environment que vous souhaitez migrer.

ASE_NAME=<Your-App-Service-Environment-name>
ASE_RG=<Your-Resource-Group>
ASE_ID=$(az appservice ase show --name $ASE_NAME --resource-group $ASE_RG --query id --output tsv)

Exécutez cette commande pour envoyer une notification de mise à niveau de test :

az rest --method POST --uri "${ASE_ID}/testUpgradeAvailableNotification?api-version=2022-03-01"

Exécutez cette commande pour démarrer le processus de mise à niveau :

az rest --method POST --uri "${ASE_ID}/upgrade?api-version=2022-03-01"

Étapes suivantes