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

Neste tutorial, irá aprender a:

• Importar um runbook de exemplo do Event Grid.
• Criar um webhook opcional do Microsoft Teams.
• Criar um webhook para o runbook.
• Crie uma subscrição do Event Grid.
• Criar uma VM que acione o runbook.

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

Pré-requisitos

Importante

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

1. Desinstale o módulo Az de uma sessão do PowerShell 5.1.
2. Instale o módulo AzureRM a partir 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, é necessária uma conta de Automatização do Azure para manter o runbook acionado a partir da subscrição do Azure Event Grid.

• O módulo AzureRM.Tags tem de ser carregado na sua Conta de Automatização. Veja Como importar módulos na Automatização do Azure para saber como importar módulos para a Automatização do Azure.

Importar um runbook de exemplo do Event Grid

1. Selecione a sua Conta de Automatização e selecione a página Runbooks.

   

2. Selecione o botão Procurar galeria.

3. Procure Event Grid e selecione Integrar a Automatização do Azure no Event Grid.

   

4. Selecione Importar e atribua o nome Watch-VMWrite.

5. Após a importação, selecione Editar para ver a origem 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. Selecione o botão Publicar.

Criar um webhook opcional do Microsoft Teams

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

   

2. Desloque-se na lista de conectores até Webhook de Entrada e selecione Adicionar.

3. Introduza AzureAutomationIntegration para o nome e selecione Criar.

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

5. Selecione Concluído para guardar o webhook.

Criar um webhook para o runbook

1. Abra o runbook Watch-VMWrite.

2. Selecione Webhooks e selecione o botão Adicionar Webhook.

3. Introduza WatchVMEventGrid para o nome. Copie o URL para a área de transferência e guarde-o.

   

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

   

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

Criar uma subscrição do Event Grid

1. Na página de descrição geral Conta de Automatização, selecione Event Grid.

   

2. Clique em + Subscrição de Evento.

3. Configure a subscrição com as seguintes informações:

   1. No Tipo de Tópico, selecione Subscrições do Azure.

   2. Desmarque a caixa de verificação Subscrever todos os tipos de eventos.

   3. Introduza AzureAutomation para o nome.

   4. Na lista pendente Tipos de Eventos Definidos, desmarque todas as opções, exceto Êxito da Escrita de Recurso.

      Nota

      Atualmente, o Azure Resource Manager não diferencia entre Criar e Atualizar, portanto, implementar este tutorial para todos os eventos Microsoft.Resources.ResourceWriteSuccess em sua Assinatura do Azure pode resultar em um alto volume de chamadas.

   5. No Tipo de Ponto Final, selecione Webhook.

   6. Clique em Selecionar um ponto final. Na página Selecionar Webhook que se abre, cole o url do webhook criado para o runbook Watch-VMWrite.

   7. Em FILTROS, introduza a subscrição e o grupo de recursos em que quer procurar as novas VMs criadas. Deve ter o seguinte aspeto: /subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/Microsoft.Compute/virtualMachines

4. Selecione Criar para guardar a subscrição do Event Grid.

Criar uma VM que acione o runbook

1. Crie uma nova VM no grupo de recursos que especificou no filtro de prefixo da subscrição do Event Grid.

2. O runbook Watch-VMWrite deve ser chamado e uma nova etiqueta adicionada à VM.

   

3. É enviada uma nova mensagem para o canal do Microsoft Teams.

   

Próximos passos

Neste tutorial, configurou a integração entre o Event Grid e a Automatização. Aprendeu a:

• Importar um runbook de exemplo do Event Grid.
• Criar um webhook opcional do Microsoft Teams.
• Criar um webhook para o runbook.
• Crie uma subscrição do Event Grid.
• Criar uma VM que acione o runbook.

Criar e encaminhar eventos personalizados com o Event Grid