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

Pour créer un environnement runtime, procédez comme suit :

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

2. Dans la page Vue d’ensemble , sélectionnez Essayer l’expérience d’environnement d’exécution, si ce n’est pas déjà le cas dans la nouvelle expérience.

3. Sous Process Automation, sélectionnez Environnements d’exécution , puis créez.

4. Sous l’onglet De base, entrez les informations suivantes :

   1. Nom pour l’environnement Runtime. Il doit commencer par une lettre alphabétique et ne peut contenir que des lettres alphabétiques, des chiffres, des traits de soulignement et des tirets.

   2. Dans la liste déroulante Langage, 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 de Runtime pour le langage de script.

      • Pour PowerShell : choisissez 5.1, 7.4
      • Pour Python : choisissez 3.10

   4. Entrez la description appropriée.

      

5. Sélectionnez Suivant et dans l’onglet Packages, chargez les packages demandés lors de l’exécution du runbook. Le package Az PowerShell est chargé par défaut pour tous les environnements Runtime PowerShell, qui inclut toutes les cmdlets pour la gestion des ressources Azure.

   Remarque

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

6. Charger davantage de packages demandés lors de 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 des fichiers .zip pour les types de runbooks PowerShell, comme indiqué ici.
   • Pour les packages Python 3.10, utilisez des fichiers .whl ciblant le système d’exploitation Linux cp310.

7. 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 procéder à la création d’un environnement Runtime, sinon le portail indique les paramètres que vous devez modifier.

Dans la page Environnements d’exécution , 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.

Vous pouvez créer un environnement runtime pour PowerShell 7.4 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=2024-10-23 

{ 
  "properties": { 
    "runtime": { 
        "language": "PowerShell",  
        "version": "7.4" 
        }, 
        "defaultPackages": { 
            "Az": "12.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=2024-10-23

{ 
  "properties": { 
    "contentLink": { 
        "uri": "https://psg-prod-eastus.azureedge.net/packages/az.accounts.2.12.4.nupkg" 
    } 
  } 
} 

Pour répertorier tous les environnements Runtime à partir du compte Automation, procédez comme suit :

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

   

GET 
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runtimeEnvironments?api-version=2024-10-23

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

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

2. Sélectionnez l’environnement Runtime que vous souhaitez supprimer.

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

   

DELETE  
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runtimeEnvironments/<runtimeEnvironmentName>?api-version=2024-10-23

Pour mettre à jour un environnement runtime, procédez comme suit :

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

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 Enregistrer après avoir ajouté 10 packages.

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=2024-10-23
{ 

  "properties": { 

        "defaultPackages": { 

            "Az": "12.3.0" 

        } 

     } 

} 

Configuration requise

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

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

1. Dans votre compte Automation, sous Automatisation des processus, sélectionnez Runbooks.

2. Sélectionnez Create (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. Entrez le Nom du runbook. Il 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 Runtime est remplie en fonction du Type de Runbook sélectionné à l’étape b.

   4. Entrez la description appropriée.

      

   Remarque

   Pour Type de Runbook PowerShell, seul l’environnement Runtime PowerShell est répertorié pour la sélection. Pour Type de Runbook Python, seul l’environnement Runtime Python est répertorié pour la sélection.

4. Ajoutez des Balises au runbook, vérifiez 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.

Configuration requise

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

PUT 
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runbooks/<runbookName>?api-version=2024-10-23

{ 
  "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"
} 

Pour mettre à jour un runbook, procédez comme suit :

1. Dans votre compte Automation, sous Automatisation des processus, sélectionnez Runbooks.

2. Cochez la case pour le ou les runbooks que vous souhaitez mettre à jour.

3. Sélectionnez Mettre à jour l’environnement d’exécution.

   

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 le ou 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.

Mettez à 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=2024-10-23
{ 
  "properties": { 
    "type": "PowerShell" 
    "runtimeEnvironment": "<runtimeEnvironmentName>" 
  } 
} 

Vous pouvez mettre à jour les runbooks en modifiant l’environnement Runtime lié à ce runbook. Nous vous recommandons de tester l’exécution du runbook avant de publier les modifications. Cela permet de garantir 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 et 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 Volet de 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 nécessaires dans le code du Runbook ou dans 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 précédemment publiée et confirmer les modifications.

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=2024-10-23
{ 
  "properties": { 
    "runtimeEnvironment": "<runtimeEnvironmentName>" 
    "runOn": "" 
  } 
} 

Vous pouvez exécuter des runbooks liés à l’environnement d’exécution à la fois sur Azure et hybrid Worker.

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=2024-10-23
{
  "properties": {
    "runbook": {
      "name": "<runbookName>" 
    }, 
    "runOn": "" 
  } 
}