Partager via

Création de runbooks via VS Code dans Azure Automation

  • Article

Cet article explique l’extension Visual Studio que vous pouvez utiliser pour créer et gérer des runbooks.

Azure Automation fournit une nouvelle extension de VS Code pour créer et gérer des runbooks. À l’aide de cette extension, vous pouvez effectuer toutes les opérations de gestion des runbooks telles que, la création et la modification de runbooks, le déclenchement d’un travail, le suivi de la sortie des travaux récents, la liaison d’une planification, la gestion des ressources et le débogage local.

Prérequis

  • Compte Azure avec un abonnement actif. Créez un compte gratuitement.
  • Visual Studio Code.
  • Les modules PowerShell et les packages Python utilisés par runbook doivent être installés localement sur l’ordinateur pour exécuter le runbook localement.

Systèmes d’exploitation pris en charge

La matrice de test inclut les systèmes d’exploitation suivants :

  1. Windows Server 2022 avec Windows PowerShell 5.1 et PowerShell Core 7.2.7
  2. Windows Server 2019 avec Windows PowerShell 5.1 et PowerShell Core 7.2.7
  3. macOS 11 avec PowerShell Core 7.2.7
  4. Ubuntu 20.04 avec PowerShell Core 7.2.7

Remarque

  • L’extension doit fonctionner n’importe où dans VS Code et prend en charge PowerShell 7.2 ou version ultérieure. Pour Windows PowerShell, seule la version 5.1 est prise en charge.
  • PowerShell Core 6 est de fin de vie et n’est pas pris en charge.

Principales fonctionnalités

  • Intégration simplifiée : vous pouvez vous connecter à l’aide d’un compte Azure de manière simple et sécurisée.
  • Plusieurs langages : prend en charge toutes les piles d’exécution Automation telles que PowerShell 5, PowerShell 7, Python 2 et Python 3 Runbooks.
  • Supportabilité: prend en charge l’exécution de test du travail, la publication du travail Automation et le déclenchement du travail dans azure et les workers hybrides. Vous pouvez exécuter des runbooks localement.
  • Prend en charge les paramètres positionnels Python et les paramètres PowerShell pour déclencher un travail.
  • Webhooks simplifiés : Vous pouvez créer un webhook, démarrer un travail via un webhook de manière plus simple. En outre, la prise en charge de lier une planification à un Runbook.
  • Gérer les ressources Automation : vous pouvez effectuer des opérations de création, de mise à jour et de suppression sur des ressources, notamment des certificats, des variables, des informations d’identification et des connexions.
  • Afficher les propriétés : vous pouvez afficher les propriétés et sélectionner groupe Worker hybride pour exécuter des travaux hybrides et afficher les 10 derniers travaux exécutés.
  • Déboguer localement : vous pouvez déboguer les scripts PowerShell localement.
  • Comparaison de Runbooks : vous pouvez comparer le runbook local à la copie publiée ou brouillon du runbook.

Fonctionnalités clés de la version 1.0.8

  • Paramètres de configuration de répertoire local : vous pouvez définir le répertoire de travail que vous souhaitez enregistrer localement des runbooks.

    • Change Directory :Base Path : vous utilisez le chemin d’accès du répertoire modifié lorsque vous rouvrez l’IDE Visual Studio Code. Pour modifier le répertoire à l’aide de la palette de commandes, utilisez Ctrl+Maj+P -> sélectionnez Modifier le répertoire. Pour modifier le chemin d’accès de base à partir des paramètres de configuration d’extension, sélectionnez l’icône Gérer dans la barre d’activité à gauche et accédez à Paramètres > Extensions > Azure Automation > Directory :Base Path.
    • Change Directory :Folder Structure : vous pouvez modifier la structure de dossiers de répertoire local de vscodeAutomation/accHash en abonnement/resourceGroup/automationAccount. Sélectionnez l’icône Gérer dans la barre d’activité sur la gauche et accédez à Paramètres > Extensions > Azure Automation > Directory :Folder Structure. Vous pouvez modifier le paramètre de configuration par défaut de vscodeAutomation/accHash au format abonnement/resourceGroupe/automationAccount.

      Remarque

      Si votre compte Automation est intégré au contrôle de code source, vous pouvez fournir le chemin du dossier runbook de votre dépôt GitHub comme chemin d’accès au répertoire. Par exemple : la modification du répertoire en C :\abc stocke les runbooks dans C :\abc\vscodeAutomation.. ou C :\abc//subscriptionName//resourceGroupName//automationAccountName//runbookname.ps1.

  • Opérations de gestion des runbooks : vous pouvez créer un runbook, extraire un runbook brouillon, extraire un runbook publié, ouvrir un runbook local dans l’éditeur, comparer un runbook local avec une copie de runbook publiée ou brouillon, charger en tant que brouillon, publier un runbook et supprimer un runbook à partir de votre compte Automation.

  • Opérations d’exécution de Runbooks : vous pouvez exécuter une version locale des travaux Automation tels que Démarrer des travaux Automation, Démarrer le travail de test Start Automation, afficher les sorties des travaux et exécuter la version locale du Runbook PowerShell en mode débogage en vous permettant d’ajouter des points d’arrêt dans le script.

    Remarque

    Actuellement, nous prenons en charge l’utilisation d’applets de commande internes comme Get-AutomationVariable uniquement avec des ressources non chiffrées.

  • Utiliser des planifications, des ressources et des webhooks : vous pouvez afficher les propriétés d’une planification, supprimer une planification, lier une planification pour lier une planification à un runbook.

  • Ajouter un webhook : vous pouvez ajouter un webhook au runbook.

  • Mettre à jour les propriétés des ressources : vous pouvez créer, mettre à jour, afficher les propriétés des ressources telles que certificats, connexions, informations d’identification, variables et suppression des ressources de l’extension.

Limites

Actuellement, les fonctionnalités suivantes ne sont pas prises en charge :

  • Création de nouvelles planifications.
  • Ajout de nouveaux certificats dans les ressources.
  • Chargez des packages Modules (PowerShell et Python) à partir de l’extension.
  • Synchronisation automatique des runbooks locaux avec un compte Azure Automation. Vous devrez effectuer l’opération pour récupérer ou publier runbook.
  • Gestion des groupes de workers hybrides.
  • Runbook graphique et workflows.
  • Pour Python, nous ne fournissons aucune option de débogage. Nous vous recommandons d’installer n’importe quelle extension de débogueur dans votre script Python.
  • Actuellement, nous prenons uniquement en charge les ressources non chiffrées dans l’exécution locale.

Étapes suivantes