Gérer les pré-événements et les post-événements (prévisualisation) de la configuration de maintenance

S’applique à : ✔️ Machines virtuelles Windows ✔️ Machines virtuelles Linux ✔️ Environnement local ✔️ Serveurs compatibles avec Azure Arc ✔️ Machines virtuelles Azure.

Cet article explique comment vous inscrire pour votre abonnement et gérer les pré-événements et post-événements dans le Gestionnaire de mise à jour Azure.

Inscrire votre abonnement à la préversion publique

Pour auto-inscrire votre abonnement pour la préversion publique, effectuez ces étapes :

Azure portal

1. Connectez-vous au portail Azure et sélectionnez Autres services.

2. Dans la page Tous les services, recherchez Fonctionnalités en préversion.

3. Dans la page Fonctionnalités de la version préliminaire, recherchez et sélectionnez Pré-événements et post-événements.

4. Sélectionnez la fonctionnalité, puis sélectionnez S’inscrire pour inscrire l’abonnement.

   

Azure CLI

az feature register --name InGuestPatchPrePostMaintenanceActivity --namespace Microsoft.Maintenance

PowerShell

Register-AzProviderFeature -FeatureName "InGuestPatchPrePostMaintenanceActivity" -ProviderNamespace "Microsoft.Maintenance"

Gérer les pré-/post-événements

Afficher les pré-événements et post-événements

Pour afficher les pré-événements et post-événements, effectuez ces étapes :

1. Connectez-vous au Portail Microsoft Azure et accédez à Azure Update Manager.

2. Sous Gérer, sélectionnez Machines, Configurations de maintenance.

3. Dans la page Configuration de maintenance, sélectionnez la configuration de maintenance à laquelle vous souhaitez ajouter un pré-événement et un post-événement.

4. Sélectionnez Vue d’ensemble et vérifiez les Événements de maintenance. Vous pouvez voir le nombre de pré-événements et post-événements associés à la configuration.

   

5. Sélectionnez le nombre de pré-événements et post-événements pour afficher la liste des événements et les types d’événements.

   

Modifier les pré-événements et post-événements

Pour modifier les pré-événements et post-événements, effectuez ces étapes :

1. Suivez les étapes répertoriées dans Afficher les pré-événements et post-événements.
2. Dans la page des événements sélectionnés, sélectionnez le pré-événement ou post-événement que vous souhaitez modifier.
3. Dans la page du pré-événement ou post-événement sélectionné, vous pouvez modifier le gestionnaire d’événements/point de terminaison utilisé ou l’emplacement du point de terminaison.

Gérer l’exécution des pré-événements ou post-événements et les exécutions planifiées

Pour vérifier la réussite de la remise d’un pré-événement ou post-événement à un point de terminaison à partir d’Event Grid, effectuez ces étapes :

1. Connectez-vous au Portail Microsoft Azure et accédez à Azure Update Manager.
2. Sous Gérer, sélectionnez Machines.
3. Sélectionnez Configurations de maintenance dans le ruban en haut.
4. Dans la page Configuration de maintenance, sélectionnez la configuration de maintenance pour laquelle vous souhaitez afficher un pré-événement et un post-événement.
5. Dans la page Configuration de maintenance sélectionnée, sous Paramètres, dans la table des matières, sélectionnez Événements.
6. Dans la section Essentiels, vous pouvez afficher les métriques de tous les événements sous l’abonnement aux événements sélectionné. Dans le graphique, le nombre indiqué pour la métrique Événements publiés doit correspondre au nombre indiqué pour la métrique Événements correspondants. Les deux valeurs doivent également correspondre au nombre Événements remis.
7. Pour afficher les métriques propres à un pré-événement ou post-événement, sélectionnez le nom de l’événement dans la grille. Ici, le nombre indiqué pour la métrique Événements correspondants doit correspondre au nombre Événements remis.
8. Pour afficher l’heure à laquelle l’événement a été déclenché, pointez sur le graphique en courbes. Plus d’informations

Remarque

Azure Event Grid respecte un paradigme de remise « au moins une fois ». Cela implique que, dans des circonstances exceptionnelles, il est possible que le gestionnaire d’événements soit appelé plusieurs fois pour un événement donné. Nous vous recommandons de veiller à ce que les actions du gestionnaire d’événements soient idempotentes. En d’autres termes, si le gestionnaire d’événements est exécuté plusieurs fois, cela ne doit pas avoir d’effets indésirables. L’implémentation de l’idempotence garantit la robustesse de votre application face aux potentiels doublons d’appels d’événements.

Pour vérifier si le point de terminaison a été déclenché et terminé dans le pré-événement ou post-événement

Runbooks Automation via des webhooks

1. Connectez-vous au portail Azure et accédez à votre compte Azure Automation

2. Dans votre compte Automation, sous Automatisation des processus, sélectionnez Runbooks.

3. Sélectionnez le pré-script ou post-script lié à votre webhook dans Event Grid.

4. Dans Vue d’ensemble, vous pouvez voir l’état du travail du runbook. L’heure du déclencheur doit être environ 30 minutes avant l’heure de début de la planification. Une fois le travail terminé, vous pouvez revenir à la même section pour confirmer que l’état est Terminé. Par exemple, vérifiez que la machine virtuelle a été activée ou désactivée.

   

   Pour plus d’informations sur la récupération des détails du journal d’activité et des états de travail du compte Automation, consultez Gérer les runbooks dans Azure Automation.

Azure Functions

1. Connectez-vous au portail Azure et accédez à votre application Azure Function.
2. Dans votre application Azure Function, accédez à la page Vue d’ensemble.
3. Sélectionnez la fonction spécifique dans la grille de la page Vue d’ensemble.
4. Sous la colonne Moniteur, sélectionnez Appels et plus.
5. Vous accédez alors à l’onglet Appels, qui affiche les détails d’exécution et l’état de la fonction.

Pour utiliser Application Insights pour surveiller les exécutions dans Azure Functions, consultez cet article.

Annuler une exécution planifiée avant qu’elle débute

Pour annuler l’exécution planifiée, l’API d’annulation dans votre pré-événement doit être déclenchée au moins dix minutes avant l’heure de début de la configuration de maintenance planifiée. Vous devez appeler l’API d’annulation dans votre pré-événement, autrement dit dans le script de Runbook ou le code de fonction Azure.

Pour annuler l’exécution de maintenance planifiée

Azure portal

1. Connectez-vous au Portail Microsoft Azure et accédez à Azure Update Manager.
2. Sous Gérer dans la table des matières, sélectionnez Historique.
3. Sélectionnez l’onglet Par ID d’exécution de maintenance et choisissez l’ID d’exécution pour lequel vous souhaitez afficher l’état.
4. Sélectionnez Annuler la mise à jour de planification. Cette option est activée pendant dix minutes avant le début de la configuration de maintenance.

REST API

Appliquer des mises à jour – Créer ou mettre à jour ou annuler – API REST (Maintenance Azure) | Microsoft Learn

PowerShell

New-AzApplyUpdate (Az.Maintenance) | Microsoft Learn

INTERFACE DE LIGNE DE COMMANDE

az maintenance applyupdate | Microsoft Learn

Vous pouvez obtenir la liste des machines dans l’exécution de maintenance à partir de la requête ARG suivante. Vous pouvez également afficher l’ID de corrélation en sélectionnant Afficher les détails :

maintenanceresources  
| where type =~ "microsoft.maintenance/maintenanceconfigurations/applyupdates"  
| where properties.correlationId has "/subscriptions/your- subscription -id/resourcegroups/your- ResourceGroupName/providers/microsoft.maintenance/maintenanceconfigurations/mc-name/providers/microsoft.maintenance/applyupdates/"  
| order by name desc

Remarque

Le Gestionnaire de mise à jour Azure ou la configuration de maintenance ne procédera pas à la surveillance et annulation automatiques de la planification. Si l’utilisateur ne parvient pas à annuler, l’exécution planifiée procède à l’installation des mises à jour pendant la fenêtre de maintenance définie par l’utilisateur.

Après l’exécution planifiée

Afficher l’historique des pré-événements et post-événements

1. Connectez-vous au Portail Microsoft Azure et accédez à Azure Update Manager.
2. Sous Gérer, sélectionnez Historique.
3. Sélectionnez l’onglet Par ID d’exécution de maintenance, puis sélectionnez l’ID d’exécution de maintenance pour lequel vous souhaitez afficher l’historique.
4. Sélectionnez l’onglet Événements dans cette page d’historique de l’ID d’exécution de maintenance sélectionné.
5. Vous pouvez afficher le nombre d’événements et les noms d’événements, ainsi que les détails du type d’événement et du point de terminaison.

Déboguer les pré-événements et post-événements

Automation–Webhook

Pour afficher l’historique des travaux d’un événement créé via un webhook, effectuez ces étapes :

1. Recherchez le nom de l’événement pour lequel vous souhaitez afficher les journaux des travaux.
2. Sous la colonne Historique des travaux, sélectionnez Afficher l’historique des runbooks correspondant au nom de l’événement. Vous accédez alors au compte Automation où résident les runbooks.
3. Sélectionnez le nom du runbook spécifique associé au pré-événement ou post-événement. Dans la page Vue d’ensemble, vous pouvez afficher les travaux récents du runbook, ainsi que les détails de l’exécution et de l’état.

Fonction Azure

Pour afficher l’historique d’un événement créé via Azure Function, effectuez ces étapes :

1. Recherchez le nom de l’événement pour lequel vous souhaitez afficher les journaux des travaux.
2. Sous la colonne Historique des travaux, sélectionnez Afficher l’historique Azure Functions correspondant au nom de l’événement. Vous accédez alors à la page Appels de fonction Azure.
3. Vous pouvez afficher les appels récents, ainsi que les détails de l’exécution et de l’état.

Afficher l’état d’une exécution planifiée annulée

1. Connectez-vous au Portail Microsoft Azure et accédez à Azure Update Manager.
2. Sous Gérer, sélectionnez Historique.
3. Sélectionnez l’onglet Par ID d’exécution de maintenance, puis sélectionnez l’ID d’exécution de maintenance pour lequel vous souhaitez afficher l’état.
4. Reportez-vous à État pour afficher l’état. Si l’exécution de maintenance a été annulée, l’état indique Annulé. Sélectionnez l’état pour afficher les détails.

Il existe deux types d’annulations :

• Annulation par l’utilisateur : lorsque vous appelez l’API d’annulation à partir de votre script ou de votre code.
• Annulation par le système : lorsque le système appelle l’API d’annulation en raison d’une erreur interne. Cette opération est effectuée uniquement si le système ne parvient pas à envoyer le pré-événement au point de terminaison du client 30 minutes avant la tâche de mise à jour corrective planifiée. Dans ce cas, la configuration de maintenance planifiée à venir sera annulée en raison de l’échec de l’exécution des pré-événements par le système.

Pour vérifier si l’annulation est effectuée par l’utilisateur ou le système, vous pouvez afficher l’état de l’ID d’exécution de maintenance à partir de la requête ARG mentionnée ci-dessus dans Afficher les détails. Le message d’erreur indique si l’exécution planifiée a été annulée par l’utilisateur ou le système, et le champ État confirme l’état de l’exécution de maintenance.

L’image ci-dessus montre un exemple d’annulation par l’utilisateur, où le message d’erreur serait Maintenance annulée à l’aide de l’API d’annulation le AAAA-MM-JJ. Si l’exécution de maintenance est annulée par le système pour une raison quelconque, le message d’erreur dans le JSON est Maintenance annulée en raison d’une défaillance de plateforme interne le AAAA-MM-DD.

Supprimer un pré-événement et un post-événement

Avec le portail Azure

Pour supprimer des pré-événements et post-événements, effectuez ces étapes :

1. Connectez-vous au Portail Microsoft Azure et accédez à Azure Update Manager.

2. Sous Gérer, sélectionnez Machines, Configurations de maintenance.

3. Dans la page Configuration de maintenance, sélectionnez la configuration de maintenance à laquelle vous souhaitez ajouter un pré-événement et un post-événement.

4. Dans la page Configuration de maintenance sélectionnée, sous Paramètres, sélectionnez Événements.

5. Sélectionnez le Nom de l’événement que vous souhaitez supprimer dans la grille.

6. Dans la page de l’événement sélectionné, sélectionnez Supprimer.

   

Utiliser PowerShell

Suppression d’un abonnement à un événement

    Remove-AzEventGridSystemTopicEventSubscription -EventSubscriptionName $EventSubscriptionName -ResourceGroupName $ResourceGroupForSystemTopic -SystemTopicName $SystemTopicName

Supprimer une rubrique système

    Remove-AzEventGridSystemTopic -Name $SystemTopicName -ResourceGroupName $ResourceGroupForSystemTopic

Utiliser l'interface CLI

Suppression d’un abonnement à un événement

    az eventgrid system-topic event-subscription delete --name “<Event subscription name>” --resource-group $ResourceGroupName --system-topic-name     $SystemTopicName

Supprimer une rubrique système

    az eventgrid system-topic delete --name $SystemTopicName --resource-group $ResourceGroupName

Utilisation de l'API REST

Suppression d’un abonnement à un événement

    DELETE /subscriptions/<subscription Id>/resourceGroups/<resource group name>/providers/Microsoft.EventGrid/systemTopics/<system topic name>/eventSubscriptions/<Event Subscription name>?api-version=2022-06-15

Suppression de rubrique système

    DELETE /subscriptions/<subscription Id>/resourceGroups/<resource group name>/providers/Microsoft.EventGrid/systemTopics/<system topic name>;?api-version=2022-06-15

Étapes suivantes

• Pour obtenir une vue d’ensemble des pré- et post-événements dans le Gestionnaire de mise à jour Azure, accédez ici.
• Pour découvrir comment créer des pré-événements et post-événements, consultez Événements de configuration avant et après maintenance.
• Pour découvrir comment utiliser des pré-événements et post-événements pour activer et désactiver vos machines virtuelles à l’aide de webhooks, consultez cet article.
• Pour découvrir comment utiliser des pré-événements et post-événements pour activer et désactiver vos machines virtuelles à l’aide d’Azure Functions, consultez cet article.