Gérer l’environnement Runtime et les runbooks associés

Cet article fournit des informations sur la création de l’environnement d’exécution et l’exécution de différentes opérations via Portail Azure et l’API REST.

Prérequis

Un compte Azure Automation dans une région publique prise en charge (à l’exception de l’Inde centrale, de l’Allemagne Nord, de l’Italie Nord, d’Israël Centre, de Pologne Centre, des Émirats arabes unis Centre et des clouds gouvernementaux).

Basculer entre l’environnement runtime et l’ancienne expérience

Expérience de l’environnement d’exécution

1. Sélectionnez Vue d’ensemble , puis essayez l’expérience d’environnement d’exécution.

   

2. Sous Process Automation, vous disposez des environnements d’exécution (préversion) et des modules et des packages Python sous ressources partagées sont supprimés, car l’environnement runtime permet la gestion des packages requis pendant l’exécution du Runbook.

   

3. Pour revenir à l’ancienne expérience de gestion des modules et des packages, sélectionnez Vue d’ensemble dans le volet gauche, puis basculez vers l’ancienne expérience.

   

Ancienne expérience

1. Accédez à votre compte Automation, sous Process Automation, les environnements runtime (préversion) sont supprimés et sous Ressources partagées, modules et packages Python sont visibles .

   

Remarque

Les mises à jour du Runbook persistent entre la nouvelle expérience d’environnement Runtime et l’ancienne expérience. Toutes les modifications effectuées dans l’environnement runtime liés à un runbook persistent pendant l’exécution du runbook dans l’ancienne expérience.

Gérer l’environnement runtime

Créer un environnement runtime

Azure portal

1. Connectez-vous au portail Azure et sélectionnez votre compte Automation.

2. Sous Process Automation, sélectionnez Environnements d’exécution (préversion), puis sélectionnez Créer.

3. Sur les principes de base, fournissez les détails suivants :

   1. Nom de l’environnement runtime. Il doit commencer par l’alphabet et ne peut contenir que des alphabets, des nombres, des traits de soulignement et des tirets.

   2. Dans la liste déroulante Langue , sélectionnez le langage de script pour l’environnement Runtime.

      • Choisissez PowerShell pour le langage de script PowerShell ou Python pour le langage de script Python.

   3. Sélectionnez la version du runtime pour le langage de script.

      • Pour PowerShell : choisissez 5.1, 7.2
      • Pour Python : choisissez 3.8, 3.10 (préversion)

   4. Fournissez la description appropriée.

      

4. Sélectionnez Suivant et, dans l’onglet Packages , chargez les packages requis pendant l’exécution du runbook. Le package Az PowerShell est chargé par défaut pour tous les environnements PowerShell Runtime, qui inclut toutes les applets de commande pour la gestion des ressources Azure. Vous pouvez choisir la version du package Az dans la liste déroulante. Sélectionnez Aucun si vous ne souhaitez pas que le package soit chargé pendant l’exécution du runbook.

   

   Remarque

   Les commandes Azure CLI sont prises en charge (préversion) dans les runbooks associés à l’environnement runtime PowerShell 7.2. Les commandes Azure CLI version 2.56.0 sont disponibles en tant que package par défaut dans l’environnement runtime PowerShell 7.2.

5. Pour charger davantage de packages requis pendant l’exécution du runbook. Sélectionnez Ajouter un fichier pour ajouter le ou les fichiers stockés localement sur votre ordinateur ou sélectionnez Ajouter à partir de la galerie pour charger des packages à partir de PowerShell Gallery.

   

   Remarque

   • Lorsque vous importez un package, cela peut prendre plusieurs minutes. 100 Mo correspond à la taille totale maximale des fichiers que vous pouvez importer.
   • Utilisez .zip fichiers pour les types de runbooks PowerShell.
   • Pour les packages Python 3.8, utilisez des fichiers .tar.gz ou .whl ciblant cp38-amd64.
   • Pour les packages Python 3.10 (préversion), utilisez des fichiers .whl ciblant le système d’exploitation Linux cp310.

6. Sélectionnez Suivant et dans l’onglet Vérifier + Créer , vérifiez que les paramètres sont corrects. Lorsque vous sélectionnez Créer, Azure exécute la validation sur les paramètres d’environnement runtime que vous avez choisis. Si la validation réussit, vous pouvez continuer à créer un environnement runtime sinon, le portail indique les paramètres que vous devez modifier.

Dans la page Environnements d’exécution (préversion), vous pouvez afficher l’environnement runtime nouvellement créé pour votre compte Automation. Si vous ne trouvez pas les environnements Runtime nouvellement créés dans la liste, sélectionnez Actualiser.

REST API

Vous pouvez créer un environnement runtime pour PowerShell 7.2 avec le module Az PowerShell dans Automation

PUT 
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runtimeEnvironments/<runtimeEnvironmentName>?api-version=2023-05-15-preview 

{ 
  "properties": { 
    "runtime": { 
        "language": "PowerShell",  
        "version": "7.2" 
        }, 
        "defaultPackages": { 
            "Az": "7.3.0" 
        } 
     }, 
    "name": "<runtimeEnvironmentName>" 
} 

Chargez un package Az.Accounts dans l’environnement runtime.

PUT 
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runtimeEnvironments/<runtimeEnvironmentName>/packages/Az.Accounts?api-version=2023-05-15-preview 
{ 
  "properties": { 
    "contentLink": { 
        "uri": "https://psg-prod-eastus.azureedge.net/packages/az.accounts.2.12.4.nupkg" 
    } 
  } 
} 

Afficher l’environnement runtime

Obtenez les propriétés de l’environnement runtime à partir du compte Automation.

GET 
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runtimeEnvironments/<runtimeEnvironmentName>?api-version=2023-05-15-preview 

Répertorier les environnements runtime

Pour répertorier tous les environnements Runtime à partir du compte Automation :

Azure portal

1. Dans votre compte Automation, sous Process Automation, sélectionnez Environnements d’exécution (préversion).

   

REST API

GET 
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runtimeEnvironments?api-version=2023-05-15-preview 

Afficher les composants du package Az PowerShell

Pour afficher tous les packages de composants du package Az PowerShell, exécutez l’applet Get-Module -ListAvailable de commande dans un runbook PowerShell.

La sortie du travail affiche tous les packages de composants et leurs versions.

Supprimer l’environnement runtime

Pour supprimer l’environnement runtime du compte Automation, procédez comme suit :

Azure portal

1. Dans votre compte Automation, sous Process Automation, sélectionnez Environnements d’exécution (préversion).

2. Sélectionnez l’environnement d’exécution que vous souhaitez supprimer.

3. Sélectionnez Supprimer pour supprimer l’environnement runtime.

   

REST API

DELETE  
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runtimeEnvironments/<runtimeEnvironmentName>?api-version=2023-05-15-preview 

Mettre à jour l’environnement runtime

Le langage runtime et la version runtime sont des propriétés immuables. Toutefois, vous pouvez mettre à jour la version des modules et ajouter ou supprimer des packages dans l’environnement Runtime. Les Runbooks liés à l’environnement runtime sont automatiquement mis à jour avec les nouveaux paramètres.

Azure portal

1. Dans votre compte Automation, sous Process Automation, sélectionnez Environnements d’exécution (préversion).

2. Sélectionnez l’environnement runtime que vous souhaitez mettre à jour.

3. Sélectionnez la version dans la liste déroulante pour mettre à jour la version des packages existants.

4. Sélectionnez Enregistrer.

   

5. Sélectionnez Ajouter un fichier pour charger des packages à partir de votre ordinateur local ou Ajouter à partir de la galerie pour charger des packages à partir de PowerShell Gallery.

   

   Remarque

   Vous pouvez ajouter jusqu’à 10 packages à la fois à l’environnement runtime. Vérifiez que vous enregistrez après l’ajout de 10 packages.

REST API

Mettez à jour la version du module Az d’un environnement runtime existant :

PATCH 
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runtimeEnvironments/<runtimeEnvironmentName>?api-version=2023-05-15-preview 
{ 

  "properties": { 

        "defaultPackages": { 

            "Az": "9.0.0" 

        } 

     } 

} 

Gérer les Runbooks liés à l’environnement runtime

Créer un runbook

Vous pouvez créer un runbook PowerShell configuré avec l’environnement runtime.

Azure portal

Configuration requise

• Vérifiez que vous avez créé un environnement runtime avant de créer un runbook.

Pour créer un runbook lié à l’environnement runtime, procédez comme suit :

1. Dans votre compte Automation, sous Process Automation, sélectionnez Runbooks.

2. Sélectionnez Créer.

3. Sous l’onglet Informations de base , vous pouvez créer un runbook ou charger un fichier à partir de votre ordinateur local ou à partir de PowerShell Gallery.

   1. Indiquez un nom pour le runbook. Elle doit commencer par une lettre et ne peut contenir que des lettres, des chiffres, des traits de soulignement et des tirets.

   2. Dans la liste déroulante type de Runbook , sélectionnez le type de runbook que vous souhaitez créer.

   3. Sélectionnez l’environnement runtime à configurer pour le runbook. Vous pouvez sélectionner à partir d’environnements runtime existants ou créer un environnement runtime et le lier au Runbook. La liste des environnements d’exécution est remplie en fonction du type de Runbook sélectionné à l’étape b.

   4. Fournissez la description appropriée.

      

   Remarque

   Pour le type de Runbook PowerShell, seul l’environnement d’exécution PowerShell est répertorié pour la sélection. Pour le type de Runbook Python, seuls les environnements Runtime Python sont répertoriés pour la sélection.

4. Ajoutez des balises au runbook, passez en revue les paramètres et sélectionnez Créer pour créer un runbook.

Ce runbook est lié à l’environnement runtime sélectionné. Tous les packages de l’environnement runtime choisi sont disponibles pendant l’exécution du runbook.

REST API

Configuration requise

• Configurez un environnement PowerShell Runtime et fournissez-le en tant qu’entrée pour la création de runbooks.

PUT 
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runbooks/<runbookName>?api-version=2023-05-15-preview 

{ 
  "properties": { 
        "runbookType": "PowerShell", 
        "runtimeEnvironment": <runtimeEnvironmentName>, 
        "publishContentLink": { 
            "uri": "https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/101-automation-runbook-getvms/Runbooks/Get-AzureVMTutorial.ps1" 
        } 
    }, 
   "location": "East US"
} 

Remarque

Les API similaires fonctionnent également pour le type de runbook Python.

Mettre à jour le Runbook

Vous pouvez mettre à jour le runbook en modifiant l’environnement runtime lié au runbook. Vous pouvez choisir un ou plusieurs runbooks pour la mise à jour. Le Runbook dans l’état d’exécution n’est pas affecté par la modification de l’environnement runtime lié à ce runbook.

Azure portal

1. Dans votre compte Automation, sous Process Automation, sélectionnez Runbooks.

2. Sélectionnez la case activée box pour le ou les runbooks que vous souhaitez mettre à jour.

3. Sélectionnez Mettre à jour.

4. Sélectionnez l’environnement runtime dans la liste déroulante vers laquelle vous souhaitez lier le ou les runbooks.

5. Sélectionnez Mettre à jour pour mettre à jour les runbooks sélectionnés avec un nouvel environnement runtime.

Vérifiez si le runbook s’exécute comme prévu après la mise à jour. Si le runbook ne parvient pas à fournir le résultat attendu, vous pouvez à nouveau mettre à jour l’environnement runtime vers l’ancienne expérience en suivant les étapes 1 à 4.

Remarque

Les mises à jour du Runbook persistent entre la nouvelle expérience d’environnement Runtime et l’ancienne expérience. Toutes les modifications effectuées dans l'environnement Runtime lié à un runbook persisteraient pendant l'exécution du runbook dans l'ancienne expérience.

REST API

Mettre à jour l’environnement runtime lié à un runbook.

PATCH 
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runbooks/<runbookName>?api-version=2023-05-15-preview 
{ 
  "properties": { 
    "type": "PowerShell" 
    "runtimeEnvironment": "<runtimeEnvironmentName>" 
  } 
} 

Remarque

Les appels View/Delete pour runbook restent identiques et peuvent être référencés Runbook - API REST Azure Automation | Microsoft Learn.

Tester la mise à jour du Runbook

Exécutez un travail de test pour un runbook avec un autre environnement runtime. Ce scénario est utile lorsqu’un runbook doit être testé avec un environnement runtime avant la mise à jour.

Azure portal

Vous pouvez mettre à jour des runbooks en modifiant l’environnement runtime lié à ce runbook. Nous vous recommandons de tester l’exécution du runbook avant de publier les modifications. Il s’agit de s’assurer que le runbook fonctionne comme prévu.

Pour tester l’exécution du runbook avant de publier les modifications apportées à l’environnement runtime, procédez comme suit :

1. Accédez à la page Runbooks , puis sélectionnez runbook pour lequel vous souhaitez mettre à jour l’environnement runtime.

   

2. Dans la page Modifier le runbook , sélectionnez Modifier dans le portail pour ouvrir l’éditeur de texte.

3. Le champ d’environnement Runtime affiche la configuration existante. Sélectionnez le nouvel environnement runtime dans la liste déroulante.

   

4. Sélectionnez le volet Test pour tester l’exécution du runbook avec l’environnement runtime mis à jour. Sélectionnez Démarrer pour commencer l’exécution du test.

5. Fermez le volet de test et apportez les modifications requises dans le code runbook ou l’environnement runtime si nécessaire.

6. Sélectionnez Publier pour mettre à jour l’environnement runtime lié au runbook.

7. Sélectionnez Oui pour remplacer la version publiée précédemment et confirmer les modifications.

REST API

Exécutez un travail de test pour un runbook avec un autre environnement runtime. Ce scénario est utile lorsqu’un runbook doit être testé avec un environnement runtime avant la mise à jour.

PUT 
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runbooks/<runbookName>/draft/testJob?api-version=2023-05-15-preview 
{ 
  "properties": { 
    "runtimeEnvironment": "<runtimeEnvironmentName>" 
    "runOn": "" 
  } 
} 

Créer un travail cloud

Azure portal

Actuellement, les runbooks liés à l’environnement runtime s’exécuteraient sur Azure.

REST API

Les travaux héritent de l’environnement runtime du runbook. Exécutez un travail cloud pour un runbook publié :

PUT 
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/jobs/<jobName>?api-version=2023-05-15-preview 
{ 
  "properties": { 
    "runbook": { 
      "name": "<runbookName>" 
    }, 
    "runOn": "" 
  } 
} 

Remarque

Les appels de création/affichage pour le travail restent identiques et peuvent être référencés à partir de l’API Job-REST (Azure Automation) | Microsoft Learn.

Lier des runbooks existants à des environnements runtime générés par le système

Tous les runbooks existants dans votre compte Azure Automation sont automatiquement liés aux environnements runtime générés par le système. Ces environnements runtime générés par le système sont créés en fonction du langage runtime, de la version et des modules/packages présents dans votre compte Azure Automation respectif. Plus d’informations Pour mettre à jour des runbooks existants, modifiez l’environnement runtime en suivant les étapes mentionnées ici.

Étapes suivantes

• Pour obtenir une vue d’ensemble de l’environnement d’exécution.
• Pour résoudre les problèmes liés à l’exécution de runbooks, voir Résoudre les erreurs avec les runbooks.