Partager via

Tutoriel : Intégrer Azure Automation à Event Grid et Microsoft Teams

  • Article

Dans ce tutoriel, vous allez apprendre à :

  • Importer un exemple de runbook Event Grid.
  • Créer un Webhook Microsoft Teams en option.
  • Créer un Webhook pour le runbook.
  • Créer un abonnement Event Grid.
  • Créer une machine virtuelle qui déclenche le runbook.

Si vous n’avez pas d’abonnement Azure, créez un compte gratuit avant de commencer.

Prérequis

Important

Pour utiliser cette fonctionnalité Azure à partir de PowerShell, vous devez installer le module AzureRM. Il s’agit d’un module antérieur disponible uniquement pour Windows PowerShell 5.1 qui ne reçoit plus de nouvelles fonctionnalités. Les modules Az et AzureRM ne sont pas compatibles en cas d’installation pour les mêmes versions de PowerShell. Si vous avez besoin des deux versions :

  1. Désinstallez le module Az à partir d’une session PowerShell 5.1.
  2. Installez le module AzureRM à partir d’une session PowerShell 5.1.
  3. Téléchargez et installez PowerShell Core 6.x ou version ultérieure.
  4. Installez le module Az dans une session PowerShell Core.

Un compte Azure Automation est requis pour terminer ce didacticiel et mettre le runbook déclenché par l’abonnement Azure Event Grid en attente.

  • Le module AzureRM.Tags doit être chargé dans votre compte Automation, consultez How to import modules in Azure Automation (Importation de modules dans Azure Automation) pour apprendre à importer des modules dans Azure Automation.

Importer un exemple de runbook Event Grid

  1. Sélectionnez votre compte Automation puis cliquez sur la page Runbooks.

    Sélectionner des runbooks

  2. Cliquez sur le bouton Parcourir la galerie.

  3. Recherchez Event Grid et sélectionnez Intégration d’Azure Automation à Event grid.

    Importer le runbook de la galerie

  4. Sélectionnez Importer et nommez-le Watch-VMWrite.

  5. Une fois importé, sélectionnez Modifier pour afficher la source du runbook.

  6. Mettez à jour la ligne 74 du script pour utiliser Tag plutôt que Tags.

    Update-AzureRmVM -ResourceGroupName $VMResourceGroup -VM $VM -Tag $Tag | Write-Verbose

  7. Cliquez sur le bouton Publier.

Créer un Webhook Microsoft Teams en option

  1. Dans Microsoft Teams, sélectionnez Plus d’options à côté du nom du canal, puis sélectionnez Connecteurs.

    Connexions Microsoft Teams

  2. Faites défiler la liste des connecteurs jusqu’à Webhook entrants et cliquez sur Ajouter.

  3. Saisissez AzureAutomationIntegration pour le nom et sélectionnez Créer.

  4. Copiez l'URL du webhook dans le presse-papiers et enregistrez-la. L’URL du Webhook permet d’envoyer des informations à Microsoft Teams.

  5. Sélectionnez Terminé pour enregistrer le Webhook.

Créer un Webhook pour le runbook

  1. Ouvrez le runbook Watch-VMWrite.

  2. Sélectionnez Webhookspuis cliquez sur le bouton Ajouter Webhook.

  3. Saisissez WatchVMEventGrid pour le nom. Copiez l’URL dans le presse-papiers et enregistrez-le.

    Configurer le nom du Webhook

  4. Sélectionnez Configurer les paramètres et les paramètres d’exécution puis saisissez l’URL du Webhook Microsoft Teams pour CHANNELURL. Laissez WEBHOOKDATA vide.

    Configurer les paramètres du Webhook

  5. Sélectionnez Créer pour créer le Webhook du runbook Automation.

Créer un abonnement Event Grid

  1. Dans la page d’aperçu Compte Automation, sélectionnez Event grid.

    Sélectionner Event Grid

  2. Cliquez sur + Abonnement à un événement.

  3. Configurez l’abonnement avec les informations suivantes :

    1. Pour Type de rubrique, sélectionnez Abonnements Azure.

    2. Décochez la case S’abonner à tous les types d’événements.

    3. Saisissez AzureAutomation pour le nom.

    4. Dans la liste déroulante Defined Event Types (Types d’événements définis), décochez toutes les options sauf Resource Write Success (Écriture de ressource réussie).

      Notes

      Actuellement, Azure Resource Manager ne différencie pas Créer et Mettre à jour et dès lors, l’implémentation de ce tutoriel pour tous les événements Microsoft.Resources.ResourceWriteSuccess dans votre abonnement Azure peut se traduire par un volume d’appels élevé.

    5. Pour Type de point de terminaison, sélectionnez Webhook.

    6. Cliquez sur Sélectionner un point de terminaison. Sur la page Select Web Hook (Sélectionner un webhook) qui s’ouvre, collez l’URL de webhook que vous avez créée pour le runbook Watch-VMWrite.

    7. Sous FILTRES, saisissez le groupe d’abonnements et de ressources à l’endroit où vous voulez rechercher les nouvelles machines virtuelles créées. Cela peut ressembler à : /subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/Microsoft.Compute/virtualMachines

  4. Sélectionnez Créer pour enregistrer l’abonnement Event Grid.

Créer une machine virtuelle qui déclenche le runbook

  1. Créez la nouvelle machine virtuelle dans le groupe de ressources spécifié dans le filtre du préfixe de l’abonnement Event Grid.

  2. Le runbook Watch-VMWrite doit être appelé et une nouvelle balise ajoutée à la machine virtuelle.

    Balise machine virtuelle

  3. Un nouveau message est envoyé au canal Microsoft Teams.

    Notification Microsoft Teams

Étapes suivantes

Ce didacticiel vous permet de configurer l’intégration entre Event Grid et Automation. Vous avez appris à :

  • Importer un exemple de runbook Event Grid.
  • Créer un Webhook Microsoft Teams en option.
  • Créer un Webhook pour le runbook.
  • Créer un abonnement Event Grid.
  • Créer une machine virtuelle qui déclenche le runbook.

Créer et acheminer des événements personnalisés avec Event Grid