Vytváření runbooků služby Service Management Automation

  • Článek

Důležité

Tato verze služby Service Management Automation (SMA) dosáhla konce podpory. Doporučujeme upgradovat na SMA 2022.

Runbooky ve službách Service Management Automation a Microsoft Azure Automation jsou Windows PowerShell pracovní postupy nebo skripty PowerShellu. Poskytují možnost automatizovat procesy správy pro řízení a nasazování cloudových serverů nebo jakýchkoli jiných funkcí, které může provádět skript prostředí Windows PowerShell.

V sadách Runbook mezi těmito dvěma systémy není žádný rozdíl a stejný runbook může běžet v obou systémech se stejnými funkcemi. Když se v tomto článku používá termín Automatizace, odkazuje na službu Service Management Automation i microsoft Azure Automation.

K dalším funkcím poskytovaným službami automatizace pro práci s pracovními postupy prostředí Windows PowerShell patří tyto:

  • Centralizované úložiště a správa Runbooků

  • Škálovatelná architektura pro plánování a spouštění Runbooků

  • Globální prostředky, které jsou centrálně řízené a dostupné všem sadám Runbook.

  • Uživatelské rozhraní pro vytváření obsahu a testování sad Runbook.

  • Sada rutin pro správu a spouštění sad Runbook.

Vytvoření nebo import runbooku

Runbook můžete do služby Service Management Automation přidat tak, že ho vytvoříte na portálu pro správu, nebo ho naimportujete ze souboru.

Vytvoření runbooku na portálu pro správu

  1. Na portálu pro správu vyberte Nový, App Services, Automation, Runbook, Rychle vytvořit.

  2. Zadejte požadované informace a vyberte Vytvořit. Název Runbooku musí začínat písmenem a může obsahovat písmena, čísla, pomlčky a podtržítka.

  3. Pokud chcete runbook upravit, vyberte Upravit runbook. V opačném případě vyberte OK.

  4. Nový runbook se zobrazí na kartě Runbooky .

Import runbooku ze souboru

  1. Na portálu pro správu vyberte Automation a pak vyberte účet Automation.

  2. Vyberte Importovat.

  3. Vyberte Vyhledat soubor a vyhledejte soubor skriptu, který chcete importovat.

  4. Pokud chcete runbook upravit, vyberte Upravit runbook. V opačném případě vyberte OK.

  5. Nový runbook se zobrazí na kartě Runbooky pro účet Automation.

Import runbooku ze souboru skriptu pomocí Windows PowerShell

K vytvoření nového runbooku ze souboru skriptu obsahujícího pracovní postup můžete použít rutinu Import-SmaRunbook .

Následující vzorové příkazy ukazují, jak importovat soubor skriptu do existujícího Runbooku a potom ho publikovat.

$webServer = 'https://MyServer'
$port = 9090
$runbookName = "Test-Runbook"
$scriptPath = "c:\runbooks\Test-Runbook.ps1"

Import-SmaRunbook -WebServiceEndpoint $webServer -Port $port -Path $scriptPath
Publish-SMARunbook -WebServiceEndpoint $webServer -Port $port -Name $runbookName

Úprava runbooku

Každý runbook ve službě Service Management Automation má dvě verze: Koncept a Publikováno. Upravíte koncept pracovního postupu a pak ho publikujete tak, aby se mohl spustit. Publikovanou verzi nelze upravit.

Úprava runbooku pomocí portálu pro správu

Portál pro správu obsahuje editor, který se dá používat k zobrazení a úpravám Runbooků. Kromě základních funkcí pro úpravu textu poskytuje editor možnost automatického vkládání kódu pro runbooky, globální prostředky a aktivity.

  1. Na portálu pro správu vyberte Automatizace.

  2. Vyberte kartu Runbooky .

  3. Vyberte název runbooku, který chcete upravit.

  4. Vyberte kartu Autor .

  5. Buď vyberte Koncept v horní části obrazovky, nebo tlačítko Upravit v dolní části obrazovky.

  6. Udělejte požadované úpravy.

  7. Po dokončení úprav vyberte Uložit .

  8. Pokud chcete publikovat nejnovější verzi konceptu runbooku, vyberte Publikovat .

Vyberte požadovanou kartu pro kroky pro vložení kódu pro runbooky, globální prostředky a aktivity:

Pokud chcete vložit kód do runbooku, postupujte takto:

  1. Otevřete Runbook v editoru portálu pro správu.

  2. V dolní části obrazovky vyberte Vložit a pak runbook.

  3. Vyberte runbook, který chcete vložit, ze středového sloupce a vyberte šipku doprava.

  4. Pokud má Runbook parametry, budou uvedené pro vaši informaci.

  5. Vyberte tlačítko zaškrtnutí.

  6. Kód pro spuštění vybrané sady Runbook se vloží do aktuálního runbooku.

  7. Pokud runbook vyžaduje parametry, zadejte místo datového typu odpovídající hodnotu uzavřenou do složených závorek <>.

Úprava runbooku Automation pomocí PowerShellu

Pokud chcete Runbook upravit pomocí prostředí Windows PowerShell, upravte pracovní postup pomocí editoru podle své volby a uložte ho do souboru .ps1. Pomocí rutiny Get-SMARunbookDefinition můžete načíst obsah runbooku a potom pomocí rutiny Edit-SMARunbook nahradit existující pracovní postup konceptu změněným pracovním postupem.

Načtení obsahu sady Runbook pomocí Windows PowerShell

Následující vzorové příkazy ukazují, jak načíst skript pro Runbook a uložit ho do souboru skriptu. V tomto příkladu se načte koncept. Je také možné načíst publikovanou verzi runbooku, i když tuto verzi nejde změnit.

$webServer = 'https://MyServer'
$port = 9090
$runbookName = "Test-Runbook"
$scriptPath = "c:\runbooks\Test-Runbook.ps1"

$runbookDefinition = Get-SMARunbookDefinition -WebServiceEndpoint $webServer -Port $port -Name $runbookName -Type Draft
$runbookContent = $runbookDefinition.Content

Out-File -InputObject $runbookContent -FilePath $scriptPath

Změna obsahu sady Runbook pomocí Windows PowerShell

Následující vzorové příkazy ukazují, jak nahradit existující obsah Runbooku obsahem souboru skriptu s pracovním postupem.

$webServer = 'https://MyServer'
$port = 9090
$runbookName = "Test-Runbook"
$scriptPath = "c:\runbooks\Test-Runbook.ps1"

Edit-SmaRunbook -WebServiceEndpoint $webServer -Port $port -Name $runbookName -Path $scriptPath -Overwrite
Publish-SmaRunbook -WebServiceEndpoint $webServer -Port $port -Name $runbookName -Path $scriptPath

Úprava runbooku Automation pomocí prostředí PowerShell ISE

Windows PowerShell integrované skriptovací prostředí (ISE) je aplikace, která umožňuje spouštět příkazy a psát, testovat a ladit skripty. Doplněk SMA PowerShell ISE umožňuje používat tento nástroj k psaní a testování runbooků služby Automation.

  1. Otevřete Integrované skriptovací prostředí (ISE) v prostředí Windows PowerShell.

  2. Pokud se doplněk SMA ISE na pravé straně ise nezobrazuje, otevřete nabídku Doplňky a povolte doplněk SMA ISE.

  3. Přihlaste se k SMA na kartě Konfigurace .

  4. Vyberte kartu Runbook . Měl by se zobrazit seznam runbooků SMA.

  5. Vyberte runbook, který chcete upravit, a vyberte Stáhnout. Tím se stáhne místní kopie runbooku z SMA.

  6. Vyberte Otevřít. Tím se vytvoří nová karta s runbookem.

  7. Proveďte v runbooku potřebné změny.

  8. Vyberte Nahrát koncept a odešlete runbook do SMA. Tím se přepíše stávající koncept runbooku.

  9. Pokud chcete publikovat nejnovější verzi konceptu runbooku, vyberte Publikovat koncept.

Publikování runbooku

Po vytvoření runbooku ho musíte publikovat, aby ho pracovní proces runbooku mohl spustit. Každý runbook ve službě Service Management Automation má koncept a publikovanou verzi. Spouštět se dá jenom publikovaná verze a upravovat jde jenom koncept. Jakékoliv změny konceptu nemají vliv na publikovanou verzi. Až budete připraveni zpřístupnit koncept, publikujete ho, čímž se publikovaná verze přepíše konceptovou verzí.

Publikování runbooku pomocí portálu pro správu

  1. Vyberte pracovní prostor Automation .

  2. V horní části obrazovky vyberte Runbooky.

  3. Vyhledejte Runbook pro úpravu a klikněte na jeho název.

  4. V horní části obrazovky vyberte Vytvořit.

  5. Vyberte Koncept.

  6. V dolní části obrazovky vyberte Publikovat.

  7. Vyberte Ano pro ověřovací zprávu.

Publikování runbooku pomocí PowerShellu

Runbook můžete v prostředí Windows PowerShell publikovat pomocí rutiny Publish-SmaRunbook. Následující vzorové příkazy ukazují, jak publikovat Runbook.

$webServer = 'https://MyServer'
$port = 9090
$runbookPath = 'c:\runbooks\Sample-TestRunbook.ps1'
$runbookName = 'Test-Runbook'

Publish-SmaRunbook -WebServiceEndpoint $webServer -Port $port -Name $runbookName

Publikování runbooku pomocí prostředí PowerShell ISE

Windows PowerShell integrované skriptovací prostředí (ISE) je aplikace, která umožňuje spouštět příkazy a psát, testovat a ladit skripty. Doplněk SMA PowerShell ISE umožňuje používat tento nástroj k psaní a testování runbooků služby Automation.

  1. Otevřete Integrované skriptovací prostředí (ISE) v prostředí Windows PowerShell.

  2. Pokud se doplněk SMA ISE na pravé straně ise nezobrazuje, otevřete nabídku Doplňky a povolte doplněk SMA ISE.

  3. Přihlaste se k SMA na kartě Konfigurace .

  4. Vyberte kartu Runbook . Měl by se zobrazit seznam runbooků SMA.

  5. Vyberte runbook a výběrem možnosti Publikovat koncept publikujte nejnovější verzi konceptu runbooku.

Testování runbooku

Verzi konceptu runbooku můžete otestovat ve službě Service Management Automation a publikovanou verzi runbooku ponechat beze změny. Tímto způsobem můžete ověřit, že Runbook správně funguje, před nahrazením publikované verze.

Při testování Runbooku se spustí jeho koncept a dokončí všechny akce, které dělá. Nevytvoří se žádná historie úloh, ale v podokně Výstup testu se zobrazí datové proudy Výstupa Upozornění a Chyba . Zprávy do podrobného Stream se zobrazí v podokně Výstup pouze v případě, že je proměnná $VerbosePreference nastavená na Pokračovat.

Při testování runbooku se pracovní postup provádí normálně a provádí všechny akce s prostředky v prostředí. Proto byste měli Runbooky testovat jenom s prostředky z nevýrobního prostředí.

Testování runbooku ve službě Service Management Automation

Pokud chcete runbook otestovat, otevřete na portálu pro správu verzi Konceptu runbooku. Výběrem tlačítka Test v dolní části obrazovky spusťte test.

Runbook můžete během testování zastavit nebo pozastavit pomocí tlačítek pod podoknem Výstup. Když Runbook pozastavíte, dokončí aktuální aktivitu a teprve pak se pozastaví. Pozastavený Runbook nejde zastavit ani znova spustit.

Testování runbooku pomocí prostředí PowerShell ISE

Doplněk ISE v PowerShellu poskytuje rutiny, které emulují standardní aktivity, jako jsou Get-SMACredential a Set-SMAVariable, takže můžete runbook otestovat na místním počítači stejně jako jakýkoli jiný skript.

Globální prostředky a jejich hodnoty se stáhnou ze skupiny automatizace, aby se použily pro místní testování. Tyto hodnoty můžete zkontrolovat nebo změnit na kartě Prostředky . Šifrované hodnoty se zobrazují oranžově a jejich hodnoty se nestáhnou. Pokud chcete tyto prostředky použít v místním testování, musíte jejich hodnotu nastavit místně.

Pokud chcete runbook otestovat v SMA, vyberte Test Draft in SMA (Test Draft in SMA). Otevře se nové okno. Výběrem možnosti Spustit novou úlohu spusťte test. Výstup se zobrazí v okně .

Ukázky runbooků služby Automation

Následující runbooky se dodávají se službou Service Management Automation jako ukázkové runbooky, které ilustrují techniky a osvědčené postupy. Jsou k dispozici pro použití v rozšíření Automation v Microsoft Azure Packu pro Windows Server.

Název sady Runbook Description
Sample-Deleting-VMCloud-Subscription Demonstruje užitečný scénář pro spuštění sady Runbook, když uživatel odstraní odběr služby VM Clouds.
Sample-Managing-Azure Ukazuje, jak se připojit k předplatnému Microsoft Azure a provádět základní operace pomocí modulu Microsoft Azure PowerShell.
Sample-Managing-ConfigurationManager Demonstruje schopnost služby Service Management Automation připojit se k Configuration Manager.
Sample-Managing-DataProtectionManager Demonstruje postup připojení k serveru Data Protection Manager (DPM) a zobrazení informací o discích, které se nachází na serveru DPM.
Sample-Managing-MySQLServers Demonstruje, jak získat token zabezpečení, který bude použit pro načtení seznamu hostitelských serverů.
Sample-Managing-OperationsManager Demonstruje schopnost služby Service Management Automation připojit se k nástroji System Center Operations Manager.
Sample-Managing-Orchestrator Ukazuje, jak se připojit k nástroji System Center Orchestrator a spustit runbook nástroje Orchestrator pro použití stávající infrastruktury.
Sample-Managing-Plans Demonstruje postup vytvoření nového plánu a přidání služby serveru SQL s definovanou kvótou pro nový plán.
Sample-Managing-ServiceBusClouds Demonstruje postup připojení k serveru Service Bus Cloud a zobrazení informací o vytvořených oborech názvů.
Sample-Managing-SQLServers Demonstruje postup vytvoření nové serverové skupiny a přidání hostitelského serveru SQL.
Sample-Managing-UserAccounts Ukazuje, jak vytvořit uživatele v Microsoft Azure Packu pro Windows Server, který se vytvoří v Microsoft Azure Packu a zobrazí se na portálu pro správu rozšíření Administrators Users. Tento uživatel by ale měl být také integrovaný do zprostředkovatele ověřování (například AuthSite) pro přístup k portálu pro správu tenantů, který není součástí této ukázky.
Sample-Managing-VirtualMachineManager Demonstruje postup připojení k serveru Virtual Machine Manager (VMM) a zobrazení informací o licenci serveru VMM.
Sample-Managing-VMClouds Demonstruje způsob přístupu k informacím o Service Provider Foundation připojení databáze serveru a k informacím o objektech serveru VMM spravovaných produktem Service Provider Foundation.
Sample-Managing-WebSiteCloud Demonstruje postup připojení k serveru řadiče Web Site Clouds a zobrazení informací o nasazených serverech Web Site Clouds.
Sample-Modify-VMCloud-Subscription Demonstruje užitečný scénář pro spuštění sady Runbook, kdy klient nebo správce pozastaví nebo aktivuje odběry VM Clouds.
Sample-Using-Activities Demonstruje schopnost služby Service Management Automation používat aktivity.
Sample-Using-Checkpoints Demonstruje schopnost používat kontrolní body ve službě Service Management Automation.
Sample-Using-Connections Demonstruje schopnost služby Service Management Automation používat připojení pro připojení ke vzdáleným systémům.
Sample-Using-Credentials Demonstruje schopnost služby Service Management Automation používat přihlašovací údaje a výstup uživatele, pod kterým runbook Service Management Automation běží. Poté se připojí k serveru „Název_serveru“ a vrátí uživatele zadaného pomocí „Příklad_pověření“, který přistupuje na server.
Sample-Using-Modules Demonstruje importování modulů v sadách Runbook a vrací počet již importovaných modulů na serveru „Název_serveru“. Poté importuje modul specifikovaný údajem „Umístění_modulu“ a vrací nový počet modulů a informace odpovídající nově importovanému modulu.
Sample-Using-RunbookParameters Demonstruje způsob používání vstupních parametrů pro sady Runbook a rovněž specifikuje, zda jsou vyžadovány parametry, poskytuje výchozí hodnoty parametrů a používá hodnoty parametrů později v pracovním postupu.
Sample-Using-Runbooks Demonstruje postup volání sady Runbook z jiné sady Runbook.
Sample-Using-SuspendWorkflow Demonstruje způsob vynucení pozastavení sady Runbook. To může být užitečné, pokud se před pokračováním runbooku vyžaduje ruční krok, například získání souhlasu s odhlášením od konkrétní osoby. Po dokončení manuálního kroku je pozastavená sada Runbook ručně obnovena a pokračuje v sadě Runbook.
Sample-Using-Variables Demonstruje schopnost služby Service Management Automation používat proměnné.
Sample-Using-VMCloud-Automation Demonstruje užitečný scénář pro spuštění sady Runbook na začátku události Service Provider Foundation.

Další kroky