Tutorial: Integración de Azure Automation con Event Grid y Microsoft Teams

  • Artículo

En este tutorial, aprenderá a:

  • Importe un runbook de ejemplo de Event Grid.
  • Cree un webhook de Microsoft Teams opcional.
  • Cree un webhook para el runbook.
  • Cree una suscripción de Event Grid.
  • Cree una máquina virtual que desencadene el runbook.

Si no tiene una suscripción a Azure, cree una cuenta gratuita antes de empezar.

Requisitos previos

Importante

El uso de esta característica de Azure desde PowerShell requiere que tenga el módulo AzureRM instalado. Se trata de un módulo anterior que solo está disponible para Windows PowerShell 5.1 que ya no obtiene nuevas características. Los módulos Az y AzureRMno son compatibles cuando se instalan para las mismas versiones de PowerShell. Si necesita ambas versiones:

  1. Desinstale el módulo Az desde una sesión de PowerShell 5.1.
  2. Instale el módulo AzureRM desde una sesión de PowerShell 5.1.
  3. Descargue e instale PowerShell Core 6.x o posterior.
  4. Instale el módulo Az en una sesión de PowerShell Core.

Para completar este tutorial, se requiere una cuenta de Azure Automation para contener el runbook que se desencadena desde la suscripción de Azure Event Grid.

Importación de un runbook de ejemplo de Event Grid

  1. Seleccione la cuenta de Automation y la página Runbooks.

    Selección de runbooks

  2. Seleccione el botón Examinar galería.

  3. Busque Event Grid y seleccione Integración de Azure Automation con Event Grid.

    Importación de runbook de Galería

  4. Seleccione Importar y asígnele el nombre Watch-VMWrite.

  5. Después de la importación, seleccione Editar para ver el origen de runbook.

  6. Actualice la línea 74 en el script para que utilice Tag en lugar de Tags.

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

  7. Seleccione el botón Publicar.

Creación de un webhook de Microsoft Teams opcional

  1. En Microsoft Teams, seleccione Más opciones junto al nombre del canal y, luego, seleccione Conectores.

    Conexiones de Microsoft Teams

  2. Desplácese por la lista de conectores hasta Webhook de entrada y seleccione Agregar.

  3. Escriba AzureAutomationIntegration como el nombre y seleccione Crear.

  4. Copie la dirección URL del webhook en el Portapapeles y guárdela. La dirección URL del webhook se usa para enviar información a Microsoft Teams.

  5. Seleccione Hecho para guardar el webhook.

Creación de un webhook para el runbook

  1. Abra el runbook Watch-VMWrite.

  2. Seleccione Webhooks y el botón Agregar webhook.

  3. Escriba WatchVMEventGrid como el nombre. Copie la dirección URL en el Portapapeles y guárdelo.

    Configuración del nombre del webhook

  4. Seleccione Configurar parámetros y ejecutar configuraciones y escriba la dirección URL del webhook de Microsoft Teams para CHANNELURL. Deje en blanco WEBHOOKDATA.

    Configuración de los parámetros del webhook

  5. Seleccione Crear para crear el webhook del runbook de Automation.

Creación de una suscripción de Event Grid

  1. En la página de información general de la cuenta de Automation, seleccione Event Grid.

    Seleccionar Event Grid

  2. Haga clic en +Suscripción de eventos.

  3. Configure la suscripción con la información siguiente:

    1. En Tipo de tema, seleccione Suscripciones de Azure.

    2. Desactive la casilla Suscribirse a todos los tipos de evento.

    3. Escriba AzureAutomation como el nombre.

    4. En la lista desplegable Tipos de evento definidos, desactive todas las opciones excepto Resource Write Success (Escritura de recursos correcta).

      Nota:

      Azure Resource Manager no distingue actualmente entre Crear y Actualizar, por lo que la implementación de este tutorial para todos los eventos Microsoft.Resources.ResourceWriteSuccess en su suscripción de Azure podría dar lugar a un gran volumen de llamadas.

    5. En Tipo de punto de conexión, seleccione Webhook.

    6. Haga clic en Seleccionar un punto de conexión. En la página Seleccionar webhook que se abre, pegue la dirección URL del webhook que creó para el runbook Watch-VMWrite.

    7. En FILTROS, escriba la suscripción y el grupo de recursos en los que desea buscar las nuevas máquinas virtuales creadas. Debe verse de una manera similar a: /subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/Microsoft.Compute/virtualMachines

  4. Seleccione Crear para guardar la suscripción de Event Grid.

Creación de una máquina virtual que desencadena el runbook

  1. Cree una máquina virtual nueva en el grupo de recursos que especificó en el filtro de prefijo de la suscripción de Event Grid.

  2. Se debe llamar al runbook Watch-VMWrite y se debe agregar una etiqueta nueva a la máquina virtual.

    Etiqueta de máquina virtual

  3. Se envía un mensaje nuevo al canal de Microsoft Teams.

    Notificación de Microsoft Teams

Pasos siguientes

En este tutorial, se configura la integración entre Event Grid y Automation. Ha aprendido a:

  • Importe un runbook de ejemplo de Event Grid.
  • Cree un webhook de Microsoft Teams opcional.
  • Cree un webhook para el runbook.
  • Cree una suscripción de Event Grid.
  • Cree una máquina virtual que desencadene el runbook.

Creación y enrutamiento de eventos personalizados con Event Grid