Compartilhar via


Tutorial: Integrar a Automação do Azure à Grade de Eventos e ao Microsoft Teams

Neste tutorial, você aprenderá como:

  • Importar um runbook de exemplo da Grade de Eventos.
  • Criar um hebwook opcional no Microsoft Teams.
  • Criar um webhook para o runbook.
  • Criar uma assinatura na Grade de Eventos.
  • Criar uma VM que dispara o runbook.

Se você não tiver uma assinatura do Azure, crie uma conta gratuita antes de começar.

Pré-requisitos

Importante

Usar esse recurso do Azure do PowerShell exige que você tenha o módulo AzureRM instalado. Esse é um módulo mais antigo disponível apenas para o Windows PowerShell 5.1. que não recebe mais novos recursos. Os módulos Az e AzureRMnão são compatíveis quando instalados para as mesmas versões do PowerShell. Se você precisar das duas versões:

  1. Desinstale o módulo Az de uma sessão do PowerShell 5.1.
  2. Instale o módulo AzureRM de uma sessão do PowerShell 5.1.
  3. Baixe e instale o PowerShell Core 6.x ou posterior.
  4. Instale o módulo Az em uma sessão do PowerShell Core.

Para concluir este tutorial, uma conta de Automação do Azure é necessária para armazenar o runbook que é disparado da assinatura da Grade de Eventos do Azure.

Importar um runbook de exemplo da Grade de Eventos

  1. Selecione sua conta de Automação e selecione a página de Runbooks.

    Selecione runbooks

  2. Clique no botão Procurar na galeria.

  3. Pesquise por Grade de Eventos e selecione Integração da Automação do Azure com a Grade de Eventos.

    Importe a galeria de runbook

  4. Selecione Importar e nomeie-a como Watch-VMWrite.

  5. Depois que a galeria foi importada, selecione Editar para exibir a fonte do runbook.

  6. Atualize a linha 74 no script para usar Tag em vez de Tags.

    Update-AzureRmVM -ResourceGroupName $VMResourceGroup -VM $VM -Tag $Tag | Write-Verbose
    
  7. Clique no botão Publicar.

Criar um hebwook opcional no Microsoft Teams

  1. No Microsoft Teams, selecione Mais Opções próximo ao nome do canal e, em seguida, selecione Conectores.

    Conexões do Microsoft Teams

  2. Percorra a lista de conectores até Webhook de Entrada e clique em Adicionar.

  3. Digite AzureAutomationIntegration para nomeá-lo e clique em Criar.

  4. Copie a URL do webhook na área de transferência e salve-a. A URL do webhook é usada para enviar informações para o Microsoft Teams.

  5. Selecione Concluído para salvar o webhook.

Criar um webhook para o runbook

  1. Abra o runbook Watch-VMWrite.

  2. Selecione Webhooks e clique no botão Adicionar Webhook.

  3. Nomeie-o como WatchVMEventGrid. Copie a URL para a área de transferência e salve-a.

    Configurar o nome do webhook

  4. Selecione Configurar parâmetros e configurações de execução e insira a URL do webhook do Microsoft Teams para CHANNELURL. Deixe WEBHOOKDATA em branco.

    Configurar parâmetros de webhook

  5. Selecione Criar para criar o webhook de runbook de Automação.

Criar uma assinatura na Grade de Eventos

  1. Na página de visão geral da Conta de Automação, selecione Grade de evento.

    Selecionar a Grade de Eventos

  2. Clique em + Assinatura de Evento.

  3. Configure a assinatura com as seguintes informações:

    1. Para Tipo de Tópico, selecione Assinaturas do Azure.

    2. Desmarque a caixa de seleção Assinar todos os tipos de evento.

    3. Digite AzureAutomation para nomeá-la.

    4. Na lista suspensa Tipos de Evento Definidos, desmarque todas as opções, exceto Gravação de Recurso Bem-Sucedida.

      Observação

      Atualmente o Azure Resource Manager não diferencia Criar e Atualizar, portanto a implementação deste tutorial para todos os eventos Microsoft.Resources.ResourceWriteSuccess em sua assinatura do Azure poderá resultar em um alto volume de chamadas.

    5. Para Tipo de Ponto de Extremidade, selecione Webhook.

    6. Clique em Selecionar um ponto de extremidade. Na página Selecionar Web hook aberta, cole a URL do web hook que você criou para o runbook Watch-VMWrite.

    7. Em FILTROS, insira a assinatura e o grupo de recursos onde você deseja procurar as novas VMs criadas. O resultado deve ser assim: /subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/Microsoft.Compute/virtualMachines

  4. Selecione Criar para salvar a assinatura na Grade de Eventos.

Crie uma VM que dispara o runbook

  1. Crie uma nova VM no grupo de recursos que você especificou no filtro de prefixos na assinatura da Grade de Eventos.

  2. O runbook Watch-VMWrite deve ser chamado e uma nova marcação deve ser adicionada à VM.

    Marcação VM

  3. Uma nova mensagem é enviada para o canal do Microsoft Teams.

    Notificação do Microsoft Teams

Próximas etapas

Neste tutorial, você configurou a integração entre a Grade de Eventos e a Automação. Você aprendeu a:

  • Importar um runbook de exemplo da Grade de Eventos.
  • Criar um hebwook opcional no Microsoft Teams.
  • Criar um webhook para o runbook.
  • Criar uma assinatura na Grade de Eventos.
  • Criar uma VM que dispara o runbook.