Suivre les fichiers mis à jour avec une tâche d’observateur

Azure Automation utilise une tâche observateur pour rechercher des événements et déclencher des actions avec des runbooks PowerShell. La tâche d’agent de surveillance contient deux parties, l’agent de surveillance et l’action. Un runbook d’observateur s’exécute à un intervalle défini dans la tâche d’observateur et génère des données vers un runbook d’action.

Cet article vous guide tout au long de la création d’une tâche d’observateur à surveiller lorsqu’un nouveau fichier est ajouté à un répertoire. Vous apprenez à :

• Importer un runbook d’observateur
• Créer une variable d'automatisation
• Créer un guide d'actions
• Créer une tâche "watcher"
• Déclencher un observateur
• Inspecter la sortie

Prerequisites

Pour terminer cet article, les éléments suivants sont obligatoires :

• Abonnement Azure. Si vous n’en avez pas encore, vous pouvez activer vos avantages d’abonné MSDN ou vous inscrire à un compte gratuit.
• Un compte Automation qui contiendra les runbooks Watcher et d'actions ainsi que la tâche d'observateur.
• Un Runbook Worker hybride où la tâche d'observateur est exécutée.
• Runbooks PowerShell. Les runbooks PowerShell Workflow et les runbooks Graphical ne sont pas pris en charge par les tâches d’observateur.

Importer un runbook d’observateur

Cet article utilise un runbook d’observateur appelé Runbook d’observateur qui recherche de nouveaux fichiers dans un répertoire pour rechercher de nouveaux fichiers dans un répertoire. Le runbook d’observateur récupère la dernière heure d’écriture connue pour les fichiers d’un dossier et examine tous les fichiers plus récents que ce filigrane.

Vous pouvez importer ce runbook dans votre compte Automation à partir du portail en suivant les étapes ci-dessous.

1. Connectez-vous au portail Azure.
2. Recherchez et sélectionnez Comptes d'automatisation.
3. Dans la page Comptes Automation , sélectionnez le nom de votre compte Automation dans la liste.
4. Dans le volet gauche, sélectionnez La galerie Runbooks sous Process Automation.
5. Vérifiez que GitHub est sélectionné dans la liste déroulante Source .
6. Recherchez runbook Watcher.
7. Sélectionnez Runbook Watcher qui recherche de nouveaux fichiers dans un répertoire, puis sélectionnez Importer dans la page de détails.
8. Donnez un nom au runbook et éventuellement une description, puis cliquez sur OK pour importer le runbook dans votre compte Automation. Vous devez voir un message d’importation réussi dans un volet en haut à droite de votre fenêtre.
9. Le Runbook importé apparaît dans la liste sous le nom que vous lui avez donné lorsque vous sélectionnez Runbooks dans le volet gauche.
10. Cliquez sur le runbook, puis sur la page de détails du Runbook, sélectionnez Modifier , puis cliquez sur Publier. Lorsque vous y êtes invité, cliquez sur Oui pour publier le livre de procédures.

Vous pouvez également télécharger le runbook à partir de l’organisation Azure Automation GitHub.

1. Accédez à la page de l’organisation GitHub Azure Automation pour Watch-NewFile.ps1.
2. Pour télécharger le runbook à partir de GitHub, sélectionnez Code à partir du côté droit de la page, puis sélectionnez Télécharger le fichier ZIP pour télécharger tout le code dans un fichier zip.
3. Extrayez le contenu et importez le runbook.

Créer une variable d'automatisation

Une variable Automation sert à stocker les timestamps que le runbook précédent lit et stocke à partir de chaque fichier.

1. Sélectionnez Variables sous Ressources partagées , puis cliquez sur + Ajouter une variable.

2. Entrez Watch-NewFileTimestamp pour le nom.

3. Sélectionnez DateTime pour le type. Il est défini par défaut sur la date et l’heure actuelles.

   

4. Cliquez sur Créer pour créer la variable Automation.

Créer un guide d'actions

Dans une tâche d’observateur, un runbook d’action sert à agir sur les données transmises à partir d’un runbook d’observateur. Vous devez importer un runbook d’action prédéfini, soit à partir du portail Azure ou de l’organisation GitHub Azure Automation.

Vous pouvez importer ce runbook dans votre compte Automation à partir du portail Azure :

1. Connectez-vous au portail Azure.
2. Recherchez et sélectionnez Comptes d'automatisation.
3. Dans la page Comptes Automation , sélectionnez le nom de votre compte Automation dans la liste.
4. Dans le volet gauche, sélectionnez La galerie Runbooks sous Process Automation.
5. Vérifiez que GitHub est sélectionné dans la liste déroulante Source .
6. Recherchez l’action Watcher, sélectionnez action Watcher qui traite les événements déclenchés par un runbook Watcher, puis cliquez sur Importer.
7. Si vous le souhaitez, modifiez le nom du runbook sur la page d’importation, puis cliquez sur OK pour importer le runbook. Vous devez voir un message d’importation réussi dans le volet de notification dans le coin supérieur droit du navigateur.
8. Accédez à la page de votre compte Automation, puis cliquez sur Runbooks sur la gauche. Votre nouveau carnet de procédures devrait figurer sous le nom que vous lui avez donné à l’étape précédente. Cliquez sur le runbook, puis sur la page de détails du Runbook, sélectionnez Modifier , puis cliquez sur Publier. Lorsque vous y êtes invité, cliquez sur Oui pour publier le livre de procédures.

Pour créer un runbook d’action en le téléchargeant à partir de l'organisation Azure Automation GitHub :

1. Accédez à la page de l’organisation GitHub Azure Automation pour Process-NewFile.ps1.
2. Pour télécharger le runbook à partir de GitHub, sélectionnez Code à partir du côté droit de la page, puis sélectionnez Télécharger le fichier ZIP pour télécharger tout le code dans un fichier zip.
3. Extrayez le contenu et importez le runbook.

Créer une tâche "watcher"

À cette étape, vous configurez la tâche d’observateur référençant les runbooks d’observateur et d’action définis aux sections précédentes.

1. Accédez à votre compte Automation et sélectionnez Tâches Watcher sous Process Automation.

2. Sélectionnez la page Tâches de l'Observateur, puis cliquez sur + Ajouter une tâche Observateur.

3. Entrez WatchMyFolder comme nom.

4. Sélectionnez Configurer Watcher et choisissez le runbook Watch-NewFile.

5. Entrez les valeurs suivantes pour les paramètres :

   • FOLDERPATH - Dossier sur le Runbook Worker hybride où de nouveaux fichiers sont créés, par exemple d :\examplefiles.
   • EXTENSION - Extension pour la configuration. Laissez vide pour traiter toutes les extensions de fichier.
   • RECURSE : opération récursive . Conservez cette valeur comme valeur par défaut.
   • PARAMÈTRES D’EXÉCUTION : paramètre pour l’exécution du runbook. Choisissez le travailleur hybride.

6. Cliquez sur OK, puis Sélectionnez pour revenir à la page Observateur.

7. Sélectionnez Configurer l’action et choisissez le runbook Process-NewFile .

8. Entrez les valeurs suivantes pour les paramètres :

   • EVENTDATA - Données d’événement. Laisser vide. Les données sont transmises à partir du runbook Watcher.
   • Paramètres d’exécution : paramètre pour l’exécution du runbook. Conservez la valeur Azure car ce runbook s'exécute dans Azure Automation.

9. Cliquez sur OK, puis Sélectionnez pour revenir à la page Observateur.

10. Cliquez sur OK pour créer la tâche observateur.

    

Déclencher un observateur

Vous devez exécuter un test comme décrit ci-dessous pour vous assurer que la tâche observateur fonctionne comme prévu.

1. Accédez à distance au runbook Worker hybride.
2. Ouvrez PowerShell et créez un fichier de test dans le dossier.

New-Item -Name ExampleFile1.txt

L’exemple suivant montre la sortie attendue.

    Directory: D:\examplefiles


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

Inspecter la sortie

1. Accédez à votre compte Automation et sélectionnez Tâches Watcher sous Process Automation.

2. Cliquez sur la tâche d'observateur WatchMyFolder.

3. Cliquez sur Afficher les flux d’observateur sous Flux pour voir que l’observateur a trouvé le nouveau fichier et démarré le runbook d’action.

4. Pour voir les tâches du runbook d'action, cliquez sur Afficher les tâches d'action d'observateur. Chaque travail peut être sélectionné pour afficher les détails du travail.

   

La sortie attendue lorsque le nouveau fichier est trouvé est visible dans l’exemple suivant :

Message is Process new file...

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

Étapes suivantes

Pour en savoir plus sur la création de votre propre runbook, consultez Créer un runbook PowerShell.