Rastrear os arquivos atualizados com uma tarefa do observador

  • Artigo

A Automação do Azure usa a tarefa de observador para cuidar de eventos e disparar ações com runbooks do PowerShell. A tarefa do observador contém duas partes, o observador e a ação. Um runbook do observador é executado em um intervalo definido na tarefa do observador e envia dados para um runbook de ação.

Observação

As tarefas do Observador não têm suporte no Microsoft Azure operado pela 21Vianet.

Importante

A partir de maio de 2020, usar os Aplicativos Lógicos do Azure será a maneira recomendada e compatível de monitorar eventos, agendar tarefas recorrentes e disparar ações. Consulte Agendar e executar tarefas automatizadas, processos e fluxos de trabalho recorrentes com Aplicativos Lógicos do Azure.

Este artigo orienta a criação de uma tarefa de observador para monitorar quando um novo arquivo é adicionado a um diretório. Você aprenderá como:

  • Importar um runbook observador
  • Criar uma variável da Automação
  • Criar um runbook de ação
  • Criar uma tarefa de observador
  • Disparar um observador
  • Inspecionar a saída

Pré-requisitos

Para concluir este artigo, os seguintes itens são necessários:

Importar um runbook observador

Este artigo usa um runbook de observador chamado Runbook de observador que procura novos arquivos em um diretório para procurar novos arquivos em um diretório. O runbook observador recupera a última hora de gravação conhecido dos arquivos de uma pasta e examina todos os arquivos que sejam mais recentes do que essa marca-d'água.

Siga as etapas abaixo para importar esse runbook na sua conta da Automação do portal.

  1. Entre no portal do Azure.
  2. Pesquise e escolha Contas de Automação.
  3. Na página de Contas de Automação, selecione o nome da conta de Automação na lista.
  4. No painel esquerdo, selecione Galeria de runbooks em Automação de Processos.
  5. Verifique se o GitHub está selecionado na lista suspensa Origem.
  6. Pesquise Runbook de observador.
  7. Selecione Runbook de observador que procura novos arquivos em um diretório e clique em Importar na página de detalhes.
  8. Dê um nome e, caso queira, uma descrição ao runbook, e clique em OK para importar o runbook na sua conta da Automação. Uma mensagem Êxito na importação será mostrada em um painel no canto superior direito da janela.
  9. O runbook importado aparece na lista sob o nome que você definiu quando selecionou "Runbooks" no painel esquerdo.
  10. Clique no runbook, e na página de detalhes do runbook, clique em Editar e em Publicar. Quando solicitado, clique em Sim para publicar o runbook.

Também é possível baixar o runbook da organização GitHub da Automação do Azure.

  1. Navegue até a página da organização GitHub da Automação do Azure para Watch-NewFile.ps1.
  2. Para baixar o runbook do GitHub, selecione Código no lado direito da página e Baixar ZIP para baixar todo o código em um arquivo zip.
  3. Extraia o conteúdo e importe o runbook.

Criar uma variável da Automação

Uma variável da Automação é usada para armazenar os carimbos de data/hora que o runbook anterior lê e armazena de cada arquivo.

  1. Selecione Variáveis em Recursos compartilhados e clique em + Adicionar uma variável.

  2. Digite Watch-NewFileTimestamp para o nome.

  3. Selecione DateTime para o tipo. O padrão será a data e a hora atuais.

    Screenshot of creating a new variable blade.

  4. Clique em Criar para criar a variável de Automação.

Criar um runbook de ação

Um runbook de ação é usado em uma tarefa de observador para realizar ação nos dados passados para ela, provenientes de um runbook observador. É preciso importar um runbook de ação predefinida do portal do Azure ou da organização GitHub da Automação do Azure.

Você também pode importar esse runbook para a conta de Automação no portal do Azure:

  1. Entre no portal do Azure.
  2. Pesquise e escolha Contas de Automação.
  3. Na página de Contas de Automação, selecione o nome da conta de Automação na lista.
  4. No painel esquerdo, selecione Galeria de runbooks em Automação de Processos.
  5. Verifique se o GitHub está selecionado na lista suspensa Origem.
  6. Pesquise a Ação do observador, selecione Ação de observador que processa eventos disparados por um runbook observador e clique em Importar.
  7. Você tem a opção de alterar o nome do runbook na página de importação e clique em OK para importar o runbook. Uma mensagem Êxito na importação será mostrada no painel de notificação no canto superior direito do navegador.
  8. Acesse a página da conta de Automação e clique em Runbooks à esquerda. Seu novo runbook deve aparecer na lista com o nome que você definido na etapa anterior. Clique no runbook, e na página de detalhes do runbook, clique em Editar e em Publicar. Quando solicitado, clique em Sim para publicar o runbook.

Para criar um runbook de ação baixando-o da organização GitHub da Automação do Azure:

  1. Navegue até a página da organização GitHub da Automação do Azure para Process-NewFile.ps1.
  2. Para baixar o runbook do GitHub, selecione Código no lado direito da página e Baixar ZIP para baixar todo o código em um arquivo zip.
  3. Extraia o conteúdo e importe o runbook.

Criar uma tarefa de observador

Nesta etapa, você configura a tarefa de observador, referenciando os runbooks de ação e observador definidos nas seções anteriores.

  1. Navegue até a sua conta da Automação e selecione Tarefas de observador em Automação do processo.

  2. Selecione a página Tarefas do observador e clique em + Adicionar uma tarefa de observador.

  3. Digite WatchMyFolder como nome.

  4. Selecione Configurar observador e escolha o runbook Watch-NewFile.

  5. Insira os seguintes valores para os parâmetros:

    • FOLDERPATH - Uma pasta do Hybrid Runbook Worker em que novos arquivos são criados, por exemplo, d:\examplefiles.
    • EXTENSION - Extensão da configuração. Deixe em branco para processar todas as extensões de arquivo.
    • RECURSE - Operação recursiva. Deixe este valor como o padrão.
    • RUN SETTINGS - Configuração para executar o runbook. Escolha o Hybrid Worker.

  6. Clique em OK e, sem seguida, em Selecionar para voltar à página do observador.

  7. Selecione Configurar ação e escolha o runbook Process-NewFile.

  8. Insira os seguintes valores para os parâmetros:

    • EVENTDATA - Dados do evento. Deixe em branco. Os dados são passados do runbook de observador.
    • Run Settings - Configuração para executar o runbook. Mantenha Azure, pois esse runbook é executado na Automação do Azure.

  9. Clique em OK e, sem seguida, em Selecionar para voltar à página do observador.

  10. Clique em OK para criar a tarefa de observador.

    Screenshot of configuring watcher action in the Azure portal.

Disparar um observador

Você precisa executar um teste, como descrito abaixo, para garantir que a tarefa do observador funcione como o esperado.

  1. Remoto no Hybrid Runbook Worker.
  2. Abra o PowerShell e crie um arquivo de teste na pasta.
New-Item -Name ExampleFile1.txt

O exemplo a seguir mostra a saída esperada.

    Directory: D:\examplefiles


Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----       12/11/2017   9:05 PM              0 ExampleFile1.txt

Inspecionar a saída

  1. Navegue até a sua conta da Automação e selecione Tarefas de observador em Automação do processo.

  2. Selecione a tarefa de observador WatchMyFolder.

  3. Clique em Exibir fluxos do observador em Fluxos para ver se o observador encontrou o novo arquivo e iniciou o runbook de ação.

  4. Para ver os trabalhos do runbook de ação, clique em Exibir trabalhos de ação do observador. Cada trabalho pode ser selecionado para exibir os respectivos detalhes.

    Screenshot of a watcher action jobs from the Azure portal.

A saída esperada, quando o novo arquivo é encontrado, pode ser vista no exemplo a seguir:

Message is Process new file...

Passed in data is @{FileName=D:\examplefiles\ExampleFile1.txt; Length=0}

Próximas etapas

Para saber mais sobre a criação do próprio runbook, confira Criar um runbook do PowerShell.