Rastrear os arquivos atualizados com uma tarefa do observador

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.

Este artigo explica como criar 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 de 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, o seguinte é necessário:

• Assinatura do Azure. Se você ainda não tiver um, poderá ativar os benefícios do assinante do MSDN ou inscrever-se em uma conta gratuita.
• Conta de automação para manter os runbooks de observador e de ação e a tarefa do observador.
• Um Hybrid Runbook Worker no qual a tarefa do observador é executada.
• Runbooks do PowerShell. Os runbooks de fluxo de trabalho e runbooks gráficos do PowerShell não são suportados por tarefas do observador.

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 selecione Contas de Automação.
3. Na página Contas de Automação , selecione o nome da sua conta de Automação na lista.
4. No painel esquerdo, selecione a galeria Runbooks em Automação de Processos.
5. Verifique se GitHub está selecionado na lista suspensa Origem.
6. Pesquise Runbook de observador.
7. Selecione o Watcher runbook que procura novos arquivos em um diretório e selecione Importar na página de detalhes.
8. Dê um nome ao runbook e, opcionalmente, uma descrição e clique em OK para importar o runbook para sua conta de Automação. Você deverá ver uma mensagem importar com êxito 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, selecione Editar e clique 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 selecione 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 de Automação

Uma variável de 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. Insira Watch-NewFileTimestamp para o nome.

3. Selecione DateTime para o tipo. Ele usará como padrão a data e a hora atuais.

   

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 selecione Contas de Automação.
3. Na página Contas de Automação , selecione o nome da sua conta de Automação na lista.
4. No painel esquerdo, selecione a galeria Runbooks em Automação de Processos.
5. Verifique se GitHub está selecionado na lista suspensa Origem.
6. Pesquise a ação Watcher, selecione a ação Watcher que processa eventos disparados por um runbook do Watcher e clique em Importar.
7. Opcionalmente, altere o nome do runbook na página de importação e clique em OK para importar o runbook. Você deverá ver uma mensagem importar bem-sucedida no painel de notificação no lado superior direito do navegador.
8. Vá para a página 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, selecione Editar e clique 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 selecione 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é sua conta de Automação e selecione tarefas do Observador em Automação de Processos.

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

3. Insira WatchMyFolder como o nome.

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

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

   • FOLDERPATH - Uma pasta no Hybrid Runbook Worker em que novos arquivos são criados, por exemplo, d:\examplefiles.
   • EXTENSION – Extensão para a configuração. Deixe em branco para processar todas as extensões de arquivo.
   • RECURSE – Operação recursiva. Deixe esse valor como o padrão.
   • CONFIGURAÇÕES DE EXECUÇÃO – Configuração para executar o runbook. Escolha o trabalhador híbrido.

6. Clique em OK e, em seguida, em Selecionar para retornar à 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.
   • Configurações de Execução – Configuração para execução do runbook. Mantenha Azure, pois esse runbook é executado na Automação do Azure.

9. Clique em OK e, em seguida, em Selecionar para retornar à página do Observador.

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

    

Disparar um observador

Você deve executar um teste conforme descrito abaixo para garantir que a tarefa do observador funcione conforme 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é sua conta de Automação e selecione tarefas do Observador em Automação de Processos.

2. Selecione a tarefa do 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 detalhes do trabalho.

   

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 como criar seu próprio runbook, consulte Criar um runbook do PowerShell.