Hantera runtime-miljö och associerade runbooks

Den här artikeln innehåller information om hur du skapar Runtime Environment och utför olika åtgärder via Azure Portal och REST API.

Förutsättningar

Ett Azure Automation-konto i en offentlig region som stöds (förutom centrala Indien, Norra Tyskland, Italien, norra, Israel, centrala, Polen, centrala, Förenade Arabemiratens centrala moln och myndighetsmoln).

Växla mellan Körningsmiljö och gammal upplevelse

Körningsmiljöupplevelse

1. Välj Översikt och välj sedan Prova Körningsmiljö.

   

2. Under ProcessAutomatisering har du Runtime-miljöer (förhandsversion) och modulerna och Python-paketen under Delade resurser tas bort eftersom Runtime-miljön tillåter hantering av paket som krävs under Runbook-körning.

   

3. Om du vill återgå till den gamla upplevelsen för att hantera moduler och paket väljer du Översikt i det vänstra fönstret och väljer sedan Växla till Gammal upplevelse.

   

Gammal upplevelse

1. Gå till ditt Automation-konto, under ProcessAutomatisering tas Körningsmiljöerna (förhandsversionen) bort och under Delade resurser kan du se moduler och Python-paket.

   

Kommentar

Runbook-uppdateringar bevaras mellan den nya körningsmiljön och den gamla upplevelsen. Alla ändringar som görs i Runtime-miljön som är länkade till en runbook sparas under runbook-körningen i gammal miljö.

Hantera Körningsmiljö

Skapa Körningsmiljö

Azure-portalen

1. Logga in på Azure-portalen och välj ditt Automation-konto.

2. Under Processautomatisering väljer du Körningsmiljöer (förhandsversion) och sedan Skapa.

3. Ange följande information i Grunderna:

   1. Namn på Runtime-miljön. Den måste börja med alfabetet och får endast innehålla alfabet, siffror, understreck och bindestreck.

   2. I listrutan Språk väljer du skriptspråket för Runtime-miljön.

      • Välj PowerShell för PowerShell-skriptspråk eller Python för Python-skriptspråk.

   3. Välj Körningsversion för skriptspråk.

      • För PowerShell – välj 5.1, 7.2
      • För Python – välj 3.8, 3.10 (förhandsversion)

   4. Ange lämplig beskrivning.

      

4. Välj Nästa och på fliken Paket laddar du upp de paket som krävs under runbook-körningen. Az PowerShell-paketet laddas upp som standard för alla PowerShell Runtime-miljöer, som innehåller alla cmdletar för hantering av Azure-resurser. Du kan välja versionen av Az-paketet i listrutan. Välj Ingen om du inte vill att paketet ska laddas upp under runbook-körningen.

   

   Kommentar

   Azure CLI-kommandon stöds (förhandsversion) i runbooks som är associerade med PowerShell 7.2 Runtime-miljön. Azure CLI-kommandon version 2.56.0 är tillgängliga som standardpaket i PowerShell 7.2 Runtime-miljön.

5. Ladda upp fler paket som krävs under runbook-körningen. Välj Lägg till en fil för att lägga till de filer som lagras lokalt på datorn eller välj Lägg till från galleriet för att ladda upp paket från PowerShell-galleriet.

   

   Kommentar

   • När du importerar ett paket kan det ta flera minuter. 100 MB är den maximala totala storleken på de filer som du kan importera.
   • Använd .zip filer för PowerShell-runbooktyper som nämns här
   • För Python 3.8-paket använder du .whl-filer som riktar sig till cp38-amd64.
   • För Python 3.10-paket (förhandsversion) använder du .whl-filer som riktar sig till cp310 Linux OS.

6. Välj Nästa och kontrollera att inställningarna är korrekta på fliken Granska + Skapa . När du väljer Skapa kör Azure validering på Inställningar för Körningsmiljö som du har valt. Om valideringen godkänns kan du fortsätta att skapa En runtime-miljö. Portalen anger de inställningar som du behöver ändra.

På sidan Körningsmiljöer (förhandsversion) kan du visa den nyligen skapade Runtime-miljön för ditt Automation-konto. Om du inte hittar de nyligen skapade Runtime-miljöerna i listan väljer du Uppdatera.

REST-API

Du kan skapa en ny Runtime-miljö för PowerShell 7.2 med Az PowerShell-modulen i 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>" 
} 

Ladda upp ett paket med Az.Accounts till Runtime-miljön.

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

Visa körningsmiljö

Hämta miljöegenskaperna för Runtime från Automation-kontot.

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

Visa en lista över körningsmiljöer

Så här listar du alla Runtime-miljöer från Automation-kontot:

Azure-portalen

1. I ditt Automation-konto går du till ProcessAutomatisering och väljer Körmiljö (förhandsversion).

   

REST-API

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

Visa komponenter i Az PowerShell-paketet

Om du vill visa alla komponentpaket i Az PowerShell-paketet kör du Get-Module -ListAvailable cmdleten i en PowerShell-runbook.

Jobbutdata visar alla komponentpaket och deras versioner.

Ta bort körningsmiljö

Följ dessa steg för att ta bort Runtime-miljön från Automation-kontot:

Azure-portalen

1. I ditt Automation-konto går du till ProcessAutomatisering och väljer Körmiljö (förhandsversion).

2. Välj den körningsmiljö som du vill ta bort.

3. Välj Ta bort för att ta bort Körningsmiljön.

   

REST-API

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

Uppdatera Körningsmiljö

Körningsspråk och Körningsversion är oföränderliga egenskaper. Du kan dock uppdatera versionen av moduler och lägga till eller ta bort paket i Runtime-miljön. Runbooks som är länkade till Runtime-miljön uppdateras automatiskt med de nya inställningarna.

Azure-portalen

1. I ditt Automation-konto går du till ProcessAutomatisering och väljer Körmiljö (förhandsversion).

2. Välj den Körningsmiljö som du vill uppdatera.

3. Välj versionen från listrutan för att uppdatera versionen av befintliga paket.

4. Välj Spara.

   

5. Välj Lägg till en fil för att ladda upp paket från den lokala datorn eller Lägg till från galleriet för att ladda upp paket från PowerShell-galleriet.

   

   Kommentar

   Du kan lägga till upp till 10 paket åt gången i Runtime-miljön. Se till att du sparar när du har lagt till 10 paket.

REST-API

Uppdatera Az-modulversionen av en befintlig Runtime-miljö:

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" 

        } 

     } 

} 

Hantera Runbooks som är länkade till Runtime-miljön

Skapa Runbook

Du kan skapa en ny PowerShell-runbook som konfigurerats med Runtime-miljön.

Azure-portalen

Krav

• Se till att du har skapat en Runtime-miljö innan du skapar en runbook.

Följ dessa steg för att skapa en ny runbook som är länkad till Runtime-miljön:

1. I ditt Automation-konto går du till Processautomatisering och väljer Runbooks.

2. Välj Skapa.

3. På fliken Grundläggande kan du antingen skapa en ny runbook eller ladda upp en fil från din lokala dator eller från PowerShell-galleriet.

   1. Ange ett namn för runbooken. Den måste börja med en bokstav och får endast innehålla bokstäver, siffror, understreck och bindestreck.

   2. I listrutan Runbook-typ väljer du den typ av runbook som du vill skapa.

   3. Välj Körningsmiljö som ska konfigureras för runbooken. Du kan antingen välja från befintliga Runtime-miljöer eller Skapa en ny Runtime-miljö och länka den till Runbook. Listan över körningsmiljöer fylls i baserat på den Runbook-typ som valts i steg b.

   4. Ange lämplig beskrivning.

      

   Kommentar

   För PowerShell Runbook Type visas endast PowerShell Runtime-miljön för markering. För Python Runbook Type visas endast Python Runtime-miljöer för val.

4. Lägg till taggar i runbooken, granska inställningarna och välj Skapa för att skapa en ny runbook.

Den här runbooken är länkad till den valda Runtime-miljön. Alla paket i den valda Runtime-miljön skulle vara tillgängliga under körningen av runbooken.

REST-API

Krav

• Konfigurera en PowerShell Runtime-miljö och ange den som indata för att skapa en runbook.

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

Kommentar

Liknande API:er fungerar också för Python-runbook-typ.

Uppdatera Runbook

Du kan uppdatera runbook genom att ändra runtime-miljön som är länkad till runbooken. Du kan välja en eller flera runbooks för uppdatering. Runbook i körningsstatus påverkas inte av att ändra runtime-miljön som är länkad till den runbooken.

Azure-portalen

1. I ditt Automation-konto går du till Processautomatisering och väljer Runbooks.

2. Markera kryssrutan för de runbooks som du vill uppdatera.

3. Välj Uppdatera.

4. Välj Runtime-miljön i listrutan som du vill länka runbooks till.

5. Välj Uppdatera för att uppdatera valda runbooks med ny Runtime-miljö.

Kontrollera om runbooken körs som förväntat efter uppdateringen. Om runbooken inte ger det förväntade resultatet kan du återigen uppdatera Runtime-miljön till den gamla upplevelsen genom att följa stegen 1–4.

Kommentar

Runbook-uppdateringar bevaras mellan den nya körningsmiljön och den gamla upplevelsen. Alla ändringar som görs i runtime-miljön som är länkade till en runbook sparas under runbook-körningen i gammal miljö.

REST-API

Uppdatera Runtime-miljön som är länkad till en 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>" 
  } 
} 

Kommentar

Anropen Visa/ta bort för runbook förblir desamma och kan refereras till Runbook – REST API Azure Automation | Microsoft Learn.

Testa Runbook-uppdatering

Kör ett testjobb för en runbook med en annan Runtime-miljö. Det här scenariot är användbart när en runbook måste testas med en Runtime-miljö före uppdateringen.

Azure-portalen

Du kan uppdatera runbooks genom att ändra runtime-miljön som är länkad till den runbooken. Vi rekommenderar att du testar runbook-körningen innan du publicerar ändringarna. Det är för att säkerställa att runbooken fungerar som förväntat.

Följ dessa steg för att testa runbook-körningen innan du publicerar ändringar i Körningsmiljön:

1. Gå till sidan Runbooks och välj runbook som du vill uppdatera Runtime-miljön för.

   

2. På sidan Redigera runbook väljer du Redigera i portalen för att öppna textredigeraren.

3. Fältet Körningsmiljö visar den befintliga konfigurationen. Välj den nya Körningsmiljön i listrutan.

   

4. Välj testfönstret för att testa runbook-körning med den uppdaterade Runtime-miljön. Välj Starta för att påbörja testkörningen.

5. Stäng testfönstret och gör nödvändiga ändringar i Runbook-kod eller Runtime-miljö om det behövs.

6. Välj Publicera för att uppdatera runtime-miljön som är länkad till runbooken.

7. Välj Ja för att åsidosätta den tidigare publicerade versionen och bekräfta ändringarna.

REST-API

Kör ett testjobb för en runbook med en annan Runtime-miljö. Det här scenariot är användbart när en runbook måste testas med en Runtime-miljö före uppdateringen.

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

Skapa molnjobb

Azure-portalen

För närvarande skulle runbooks som är länkade till Runtime-miljön köras i Azure.

REST-API

Jobb ärver Runtime-miljön från runbooken. Kör ett molnjobb för en publicerad runbook:

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

Kommentar

Skapa/visa anrop för jobb förblir desamma och kan refereras från Job-REST API (Azure Automation) | Microsoft Learn.

Länka befintliga runbooks till systemgenererade Runtime-miljöer

Alla befintliga runbooks i ditt Azure Automation-konto skulle automatiskt länkas till systemgenererade Runtime-miljöer. Dessa systemgenererade Runtime-miljöer skapas baserat på runtime-språk, version och moduler/paket som finns i ditt respektive Azure Automation-konto. Läs mer. Om du vill uppdatera befintliga runbooks ändrar du Runtime-miljön genom att följa stegen som beskrivs här.

Nästa steg

• För en översikt över Körningsmiljö.
• Information om hur du felsöker problem med runbook-körning finns i Felsöka runbook-problem.