Gérer les pré-événements et les post-événements (préversion)

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

Les pré-événements et post-événements vous permettent d’exécuter des actions définies par l’utilisateur avant et après l’installation planifiée du correctif. Cet article explique comment créer, afficher et annuler les pré-événements et post-événements dans Azure Update Manager.

Inscrire votre abonnement à la préversion publique

Pour auto-inscrire votre abonnement pour la préversion publique dans le portail Azure :

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.

   

Chronologie des planifications pour les pré-événements et post-événements

Nous vous recommandons de lire le tableau suivant pour comprendre la chronologie de la planification des pré-événements et post-événements.

Par exemple, si une planification de maintenance est définie pour démarrer à 15h00, avec une fenêtre de maintenance de trois heures et 55 minutes pour l’étendue de maintenance Invité, les détails sont les suivants :

Heure	Détails
14h19	Vous pouvez modifier les machines et/ou définir de manière dynamique l’étendue des machines jusqu’à 40 minutes avant l’exécution planifiée d’un correctif avec un pré-événement associé. Si des modifications sont apportées aux ressources attachées à la planification après cette horaire, les ressources sont incluses dans l’exécution de planification suivante et non dans l’exécution actuelle. Remarque Si vous créez une planification ou modifiez une planification existante avec un pré-événement, vous avez besoin d’au moins 40 minutes avant la fenêtre de maintenance pour l’exécution du pré-événement. Dans cet exemple, si vous avez défini une planification à 15h00, vous pouvez modifier l’étendue 40 minutes avant l’heure définie, c’est-à-dire jusqu’à 14h19.
Entre 14h20 et 14h30	Le pré-événement est déclenché, en laissant au moins 20 minutes pour son exécution avant le début de l’installation du correctif. Dans cet exemple, le pré-événement est lancé entre 14h20 et 14h30.
14:50	Le pré-événement dispose d’au moins 20 minutes pour son exécution avant le début de l’installation du correctif. Remarque : Si le pré-événement continue à s’exécuter au-delà de 20 minutes, l’installation du correctif se poursuit indépendamment de l’état de l’exécution du pré-événement. - Si vous choisissez d’annuler l’exécution actuelle, vous pouvez annuler à l’aide de l’API d’annulation 10 minutes avant la planification. Dans cet exemple, à 14h50, vous pouvez annuler à partir de votre script ou du code de fonction Azure. Si l’appel de l’API d’annulation échoue, ou si l’API n’a pas été configurée, l’installation du correctif continue à s’exécuter. Dans cet exemple, le pré-événement doit exécuter les tâches au plus tard à 14h50. Si vous choisissez d’annuler l’exécution actuelle, vous pouvez appeler l’API d’annulation au plus tard à 14h50.
15:00	Comme défini dans la configuration de maintenance, la planification est déclenchée à l’heure spécifiée. Dans cet exemple, la planification est déclenchée à 15h00.
18h55	Le post-événement est déclenché une fois la fenêtre de maintenance définie terminée. Si vous avez défini une fenêtre de maintenance plus courte de deux heures, le post-événement se déclenche après deux heures, et si la planification de maintenance est terminée avant le délai prévu de deux heures, par exemple en une heure 50 minutes, le post-événement démarre. Dans cet exemple, si la fenêtre de maintenance est définie sur la valeur maximale, à 18h55 le processus d’installation du correctif est terminé et, si vous avez une fenêtre de maintenance plus courte, le processus d’installation du correctif est terminé de 17h00.
19:15	Après l’installation du correctif, le post-événement s’exécute pendant 20 minutes. Dans cet exemple, le post-événement est lancé à 18h55 et terminé à 19h15 et, si vous avez une fenêtre de maintenance plus courte, le post-événement est déclenché à 17h00 et terminé à 17h20.

Nous vous recommandons de bien prendre en compte les points suivants :

• Si vous créez une planification ou modifiez une planification existante avec un pré-événement, vous avez besoin d’au moins 40 minutes avant le début de la fenêtre de maintenance (15h00 dans l’exemple ci-dessus) pour que le pré-événement puisse s’exécuter ; autrement, l’exécution planifiée actuelle sera annulée automatiquement.
• Le pré-événement est déclenché 30 minutes avant l’exécution planifiés du correctif, ce qui donne au pré-événement au moins 20 minutes pour s’exécuter.
• Le pré-événement s’exécute immédiatement après la fin de l’installation du correctif.
• Pour annuler l’exécution actuelle du correctif, utilisez l’API d’annulation au moins 10 minutes avant l’heure de maintenance planifiée.

Configurer les pré-événements et post-événements sur une planification existante

Vous pouvez configurer des pré-événements et post-événements sur une planification existante, et ajouter plusieurs pré-événements et post-événements à une planification unique. Pour ajouter un pré-événement et un post-événement, 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. En guise d’alternative, sous Vue d’ensemble, sélectionnez la carte Créer un événement de maintenance.

   

5. Sélectionnez +Abonnement aux événements pour créer un événement de pré/post-maintenance.

   

6. Dans la page Créer un abonnement aux événements, entrez les détails suivantes :

   • Dans la section Détails des abonnements aux événements, indiquez un nom approprié.

   • Conservez Schéma Event Grid comme schéma.

   • Dans la section Détails sur la rubrique, spécifiez un nom approprié dans Nom de la rubrique système.

   • Dans la section Types d’événements, Filtrer les types d’événements, sélectionnez les types d’événements que vous souhaitez envoyer (push) au point de terminaison ou à la destination. Vous pouvez sélectionner Pré-événement de maintenance ou Post-événement de maintenance.

   • Dans la section Détails du point de terminaison, sélectionnez le point de terminaison à partir duquel vous souhaitez recevoir la réponse. Cela aiderait les clients à déclencher leur pré-événement ou post-événement.

     

7. Sélectionnez Créer pour configurer les pré-événements et post-événements sur une planification existante.

Remarque

• Le pré-événement et le post-événement ne peuvent être créés qu’au niveau de configuration de maintenance planifiée.
• La rubrique système est créée automatiquement conformément à la configuration de maintenance, et tous les abonnements aux événements sont liés à la rubrique système dans EventGrid.
• L’exécution de pré-événement et de post-événement se situe en dehors de la fenêtre de maintenance planifiée.

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.

   • Sélectionnez Configurer pour en configurer un.

   • Si l’installation est déjà effectuée, vous pouvez voir le nombre de pré-événements associés à la configuration dans la page Événements.

     

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

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. En guise d’alternative, sous Vue d’ensemble, sélectionnez la carte Créer un événement de maintenance.

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.

   

Remarque

• Si tous les pré-événements et post-événements sont supprimés de la configuration de maintenance, la rubrique système est automatiquement supprimée d’EventGrid.
• Nous vous recommandons d’éviter de supprimer manuellement la rubrique système du service EventGrid.

Annuler une planification à partir d’un pré-événement

Pour annuler la planification, vous devez appeler l’API d’annulation dans votre pré-événement pour configurer le processus d’annulation qui se trouve dans votre script Runbook ou votre code de fonction Azure. Ici, vous devez définir les critères de suppression de la planification. Le système ne surveille pas et n’annule pas automatiquement la planification en fonction de l’état du pré-événement.

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.

Remarque

Si l’annulation est effectuée par le système, le travail de mise à jour corrective planifiée à venir est annulé en raison de l’échec de l’exécution des pré-événements par le système.

Important

Si le travail de maintenance planifiée est annulé par l’utilisateur à l’aide de l’API d’annulation ou par le système en raison d’une défaillance interne, le post-événement en cas d’abonnement est envoyé au point de terminaison configuré par l’utilisateur.

Afficher l’état de l’annulation

Pour afficher l’état de l’annulation, effectuez ces étapes :

1. Dans la page d’accueil du Gestionnaire de mise à jour Azure, accédez à Historique.

2. Sélectionnez d’après l’ID d’exécution de maintenance et choisissez l’ID d’exécution pour lequel vous souhaitez afficher l’état.

   

Vous pouvez afficher l’état de l’annulation à partir du message d’erreur dans le JSON. Le JSON peut être obtenu à partir d’Azure Resource Graph (ARG). La configuration de maintenance correspondante serait annulée à l’aide de l’API d’annulation.

La requête suivante vous permet d’afficher la liste des machines virtuelles pour une planification ou une configuration de maintenance donnée :

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

• your-s-id : ID d’abonnement dans lequel la configuration de maintenance avec pré- ou post-événement est créée
• your-rg-id : nom du groupe de ressources dans lequel la configuration de maintenance est créée
• mc-name : nom de la configuration de maintenance dans laquelle le pré-événement est créé

Si le travail de maintenance est annulé par le système pour une raison quelconque, le message d’erreur dans le JSON obtenu à partir d’Azure Resource Graph pour la configuration de maintenance correspondante seraitPlanification de maintenance annulée en raison d’une défaillance de plateforme interne.

Appeler l’API d’annulation

 C:\ProgramData\chocolatey\bin\ARMClient.exe put https://management.azure.com/<your-c-id-obtained-from-above>?api-version=2023-09-01-preview "{\"Properties\":{\"Status\": \"Cancel\"}}" -Verbose 

Remarque

Vous devez remplacer l’ID de corrélation reçu à partir de la requête ARG ci-dessus et le remplacer dans l’API d’annulation.

Exemple

  C:\ProgramData\chocolatey\bin\ARMClient.exe put https://management.azure.com/subscriptions/eee2cef4-bc47-4278-b4f8-cfc65f25dfd8/resourcegroups/fp02centraluseuap/providers/microsoft.maintenance/maintenanceconfigurations/prepostdemo7/providers/microsoft.maintenance/applyupdates/20230810085400?api-version=2023-09-01-preview "{\"Properties\":{\"Status\": \"Cancel\"}}" -Verbose

Étapes suivantes

• Pour plus d’informations sur les problèmes et les solutions de contournement, consultez Résoudre les problèmes.
• Découvrez une vue d’ensemble des scénarios de pré-événements et post-événements.
• Découvrez les scénarios courants de pré-événements et post-événements.