Správa prostředí modulu runtime a přidružených runbooků

Tento článek obsahuje informace o tom, jak vytvořit prostředí runtime a provádět různé operace prostřednictvím webu Azure Portal a rozhraní REST API.

Požadavky

Účet Azure Automation v podporované veřejné oblasti (s výjimkou centrální Indie, Německa – sever, Itálie – sever, Izrael – střed, Polsko – střed, Spojené arabské emiráty a cloudy pro státní správu).

Přepínání mezi prostředím runtime a starým prostředím

Prostředí prostředí runtime

1. Vyberte Přehled a pak vyberte Vyzkoušet prostředí prostředí runtime.

   

2. V části Automatizace procesů máte prostředí runtime (Preview) a moduly a balíčky Pythonu v rámci sdílených prostředků se odeberou, protože prostředí runtime umožňuje správu balíčků vyžadovaných během provádění runbooku.

   

3. Pokud se chcete vrátit ke starému prostředí pro správu modulů a balíčků, vyberte v levém podokně Přehled a pak vyberte Přepnout na staré prostředí.

   

Staré prostředí

1. Přejděte ke svému účtu Automation v části Automatizace procesů, prostředí runtime (Preview) se odeberou a v části Sdílené prostředky, Moduly a balíčky Pythonu se zobrazí.

   

Poznámka:

Aktualizace runbooků se uchovávají mezi novým prostředím runtime a starým prostředím. Všechny změny provedené v prostředí runtime propojeném s runbookem se zachovají během provádění runbooku ve starém prostředí.

Správa prostředí runtime

Vytvoření prostředí runtime

Azure Portal

1. Přihlaste se k webu Azure Portal a vyberte svůj účet Automation.

2. V části Automatizace procesů vyberte běhová prostředí (Preview) a pak vyberte Vytvořit.

3. V základních informacích zadejte následující podrobnosti:

   1. Název prostředí runtime Musí začínat abecedou a může obsahovat pouze abecedy, čísla, podtržítka a pomlčky.

   2. V rozevíracím seznamu Jazyk vyberte skriptovací jazyk pro prostředí Runtime.

      • Zvolte PowerShell pro skriptovací jazyk PowerShellu nebo Python pro skriptovací jazyk Python.

   3. Vyberte verzi modulu runtime pro skriptovací jazyk.

      • Pro PowerShell – zvolte 5.1, 7.2
      • Pro Python – zvolte 3.8, 3.10 (Preview)

   4. Zadejte odpovídající popis.

      

4. Vyberte Další a na kartě Balíčky nahrajte balíčky potřebné během provádění runbooku. Balíček Az PowerShellu se ve výchozím nastavení nahraje pro všechna prostředí PowerShell Runtime, která zahrnují všechny rutiny pro správu prostředků Azure. V rozevíracím seznamu můžete zvolit verzi balíčku Az. Pokud nechcete, aby se balíček nahrál během provádění runbooku, vyberte Žádné .

   

   Poznámka:

   Příkazy Azure CLI se podporují (Preview) v runboocích přidružených k prostředí PowerShellu 7.2 Runtime. Příkazy Azure CLI verze 2.56.0 jsou dostupné jako výchozí balíček v prostředí PowerShellu 7.2 Runtime.

5. K nahrání dalších balíčků potřebných při provádění runbooku. Vyberte Přidat soubor a přidejte soubory uložené místně v počítači nebo vyberte Přidat z galerie a nahrajte balíčky z galerie Prostředí PowerShell.

   

   Poznámka:

   • Při importu balíčku může trvat několik minut. 100 MB je maximální celková velikost souborů, které můžete importovat.
   • Použití .zip souborů pro typy runbooků PowerShellu, jak je uvedeno tady
   • Pro balíčky Pythonu 3.8 použijte soubory .whl, které cílí na cp38-amd64.
   • Pro balíčky Pythonu 3.10 (Preview) použijte soubory .whl, které cílí na cp310 Operační systém Linux.

6. Vyberte Další a na kartě Zkontrolovat a vytvořit ověřte správnost nastavení. Když vyberete Vytvořit, Azure spustí ověřování v nastavení prostředí runtime, které jste zvolili. Pokud ověření projde, můžete pokračovat vytvořením prostředí runtime jinak, portál indikuje nastavení, která potřebujete upravit.

Na stránce Prostředí runtime (Preview) můžete zobrazit nově vytvořené prostředí runtime pro váš účet Automation. Pokud v seznamu nenajdete nově vytvořená prostředí runtime, vyberte Aktualizovat.

REST API

Nové prostředí runtime pro PowerShell 7.2 můžete vytvořit pomocí modulu Az PowerShell ve službě 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>" 
} 

Nahrajte balíček Az.Accounts do prostředí 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" 
    } 
  } 
} 

Zobrazení prostředí runtime

Získejte vlastnosti prostředí Runtime z účtu Automation.

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

Výpis prostředí runtime

Zobrazení seznamu všech prostředí runtime z účtu Automation:

Azure Portal

1. V účtu Automation v části Automatizace procesů vyberte běhová prostředí (Preview).

   

REST API

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

Zobrazení komponent balíčku Az PowerShellu

Pokud chcete zobrazit všechny balíčky komponent balíčku Az PowerShellu, spusťte Get-Module -ListAvailable rutinu v runbooku PowerShellu.

Výstup úlohy by zobrazoval všechny balíčky komponent a jejich verze.

Odstranění prostředí runtime

Pokud chcete prostředí Runtime odstranit z účtu Automation, postupujte takto:

Azure Portal

1. V účtu Automation v části Automatizace procesů vyberte běhová prostředí (Preview).

2. Vyberte prostředí runtime, které chcete odstranit.

3. Vyberte Odstranit a odstraňte prostředí 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 

Aktualizace prostředí runtime

Jazyk runtime a verze modulu runtime jsou neměnné vlastnosti. Můžete ale aktualizovat verzi modulů a přidat nebo odebrat balíčky v prostředí runtime. Runbooky propojené s prostředím runtime se automaticky aktualizují o nová nastavení.

Azure Portal

1. V účtu Automation v části Automatizace procesů vyberte běhová prostředí (Preview).

2. Vyberte prostředí runtime, které chcete aktualizovat.

3. Výběrem verze z rozevíracího seznamu aktualizujte verzi existujících balíčků.

4. Zvolte Uložit.

   

5. Vyberte Přidat soubor pro nahrání balíčků z místního počítače nebo přidat z galerie a nahrajte balíčky z Galerie prostředí PowerShell.

   

   Poznámka:

   Do prostředí runtime můžete přidat až 10 balíčků najednou. Po přidání 10 balíčků nezapomeňte uložit .

REST API

Aktualizujte verzi modulu Az existujícího prostředí runtime:

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" 

        } 

     } 

} 

Správa runbooků propojených s prostředím runtime

Vytvoření runbooku

Můžete vytvořit nový runbook PowerShellu nakonfigurovaný s prostředím runtime.

Azure Portal

Předpoklad

• Před vytvořením runbooku se ujistěte, že jste vytvořili prostředí runtime.

Pokud chcete vytvořit nový runbook propojený s prostředím runtime, postupujte takto:

1. V účtu Automation v části Automatizace procesů vyberte Runbooky.

2. Vyberte Vytvořit.

3. Na kartě Základy můžete vytvořit nový runbook nebo nahrát soubor z místního počítače nebo z galerie Prostředí PowerShell.

   1. Zadejte název runbooku. Musí začínat písmenem a může obsahovat pouze písmena, číslice, podtržítka a pomlčky.

   2. V rozevíracím seznamu Typ runbooku vyberte typ runbooku, který chcete vytvořit.

   3. Vyberte prostředí runtime, které se má pro runbook nakonfigurovat. Můžete vybrat z existujících prostředí runtime nebo vytvořit nové prostředí runtime a propojit ho s runbookem. Seznam prostředí runtime se naplní na základě typu runbooku vybraného v kroku b.

   4. Zadejte odpovídající popis.

      

   Poznámka:

   Pro typ runbooku PowerShellu by se pro výběr zobrazilo pouze prostředí PowerShell Runtime. V případě typu runbooku Python by se pro výběr zobrazila pouze prostředí Python Runtime.

4. Přidejte do runbooku značky , zkontrolujte nastavení a vyberte Vytvořit a vytvořte nový runbook.

Tento runbook je propojený s vybraným prostředím runtime. Všechny balíčky ve zvoleném prostředí runtime by byly během provádění runbooku k dispozici.

REST API

Předpoklad

• Nakonfigurujte prostředí PowerShell Runtime a zadejte ho jako vstup pro vytvoření runbooku.

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

Poznámka:

Podobná rozhraní API fungují také pro typ runbooku Pythonu.

Aktualizace runbooku

Runbook můžete aktualizovat změnou prostředí runtime propojeného s runbookem. Pro aktualizaci můžete zvolit jeden nebo více runbooků. Změna prostředí runtime propojeného s tímto runbookem nebude mít vliv na runbook ve stavu spuštění.

Azure Portal

1. V účtu Automation v části Automatizace procesů vyberte Runbooky.

2. Zaškrtněte políčko pro runbooky, které chcete aktualizovat.

3. Vyberte Aktualizovat.

4. V rozevíracím seznamu vyberte prostředí Runtime, ke kterému chcete propojit runbooky.

5. Výběrem možnosti Aktualizovat aktualizujete vybrané runbooky pomocí nového prostředí runtime.

Zkontrolujte, jestli se runbook po aktualizaci spustí podle očekávání. Pokud runbook neposkytne očekávaný výsledek, můžete prostředí runtime znovu aktualizovat na staré prostředí pomocí kroků 1 až 4.

Poznámka:

Aktualizace runbooků se uchovávají mezi novým prostředím runtime a starým prostředím. Všechny změny provedené v prostředí modulu runtime propojeném s runbookem se zachovají během provádění runbooku ve starém prostředí.

REST API

Aktualizujte prostředí runtime propojené s runbookem.

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

Poznámka:

Volání zobrazení/odstranění runbooku zůstávají stejná a lze na něj odkazovat – REST API Azure Automation | Microsoft Learn.

Testovací aktualizace runbooku

Spusťte testovací úlohu runbooku s jiným prostředím runtime. Tento scénář je užitečný, když je potřeba runbook před aktualizací otestovat s prostředím runtime.

Azure Portal

Runbooky můžete aktualizovat změnou prostředí runtime propojeného s tímto runbookem. Před publikováním změn doporučujeme otestovat spuštění runbooku. Je potřeba zajistit, aby runbook fungoval očekávaným způsobem.

Pokud chcete otestovat spouštění runbooků před publikováním změn prostředí runtime, postupujte takto:

1. Přejděte na stránku Runbooků a vyberte runbook, pro který chcete aktualizovat prostředí runtime.

   

2. Na stránce Upravit runbook vyberte Upravit na portálu a otevřete textový editor.

3. Pole Prostředí runtime zobrazuje existující konfiguraci. V rozevíracím seznamu vyberte nové prostředí runtime.

   

4. Výběrem testovacího podokna otestujte spuštění runbooku s aktualizovaným prostředím runtime. Výběrem možnosti Start zahájíte testovací běh.

5. Zavřete testovací podokno a v případě potřeby proveďte požadované změny v kódu runbooku nebo prostředí runtime.

6. Výběrem možnosti Publikovat aktualizujte prostředí runtime propojené s runbookem.

7. Pokud chcete přepsat dříve publikovanou verzi, vyberte Ano a potvrďte změny.

REST API

Spusťte testovací úlohu runbooku s jiným prostředím runtime. Tento scénář je užitečný, když je potřeba runbook před aktualizací otestovat s prostředím runtime.

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

Vytvoření cloudové úlohy

Azure Portal

V současné době by runbooky propojené s prostředím runtime běžely v Azure.

REST API

Úlohy dědí prostředí runtime z runbooku. Spusťte cloudovou úlohu pro publikovaný 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": "" 
  } 
} 

Poznámka:

Vytváření a zobrazení volání pro úlohu zůstává stejné a lze na něj odkazovat z rozhraní JOB-REST API (Azure Automation) | Microsoft Learn.

Propojení existujících runbooků s prostředími runtime generovaným systémem

Všechny existující runbooky ve vašem účtu Azure Automation se automaticky propojí s prostředími runtime generovaným systémem. Tato systémem generovaná prostředí runtime se vytvářejí na základě jazyka runtime, verze a modulů nebo balíčků, které jsou přítomné ve vašem příslušném účtu Azure Automation. Další informace. Pokud chcete aktualizovat existující runbooky, změňte prostředí runtime podle zde uvedených kroků.

Další kroky

• Přehled prostředí runtime
• Informace o řešení potíží se spouštěním runbooků najdete v tématu Řešení potíží s runbooky.