Sdílet prostřednictvím

Vytváření runbooků Service Management Automation

  • Článek

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

V runboocích mezi těmito dvěma systémy není žádný rozdíl a stejný runbook může běžet buď s identickými funkcemi. Pokud se termín Automation používá v tomto článku, odkazuje na službu Service Management Automation i Microsoft Azure Automation.

Mezi další služby poskytované službou Automation pro práci s pracovními postupy Windows PowerShellu patří:

  • 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ě spravované a dostupné pro všechny runbooky.

  • Uživatelské rozhraní pro vytváření a testování runbooků

  • Sada rutin pro správu a spouštění runbooků

Vytvoření nebo import runbooku

Runbook můžete přidat do služby Service Management Automation 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 a Rychlé vytvoření.

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

  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ě Runbook pro účet Automation.

Import runbooku ze souboru skriptu pomocí Windows PowerShellu

Pomocí rutiny Import-SmaRunbook můžete vytvořit nový runbook ze souboru skriptu obsahujícího pracovní postup.

Následující ukázkové příkazy ukazují, jak importovat soubor skriptu do existujícího runbooku a pak 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 verzi konceptu pracovního postupu a pak ji publikujete, aby bylo možné ji spustit. Publikovanou verzi nelze upravit.

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

Portál pro správu obsahuje editor, který můžete použít k zobrazení a úpravám runbooků. Kromě poskytování základních funkcí pro úpravy textu poskytuje editor možnost automaticky vkládat kód pro runbooky, globální prostředky a aktivity.

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

  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. Proveďte požadované úpravy.

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

  8. Vyberte Publikovat , pokud chcete publikovat nejnovější verzi konceptu runbooku.

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

Pomocí následujícího postupu vložte kód do runbooku:

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

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

  3. Vyberte runbook, který chcete vložit ze prostředního sloupce, a vyberte šipku doprava.

  4. Pokud sada Runbook obsahuje parametry, budou uvedené pro vaše informace.

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

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

  7. Pokud runbook vyžaduje parametry, zadejte odpovídající hodnotu místo datového typu obklopeného složenými závorkami <>.

Úprava runbooku Automation pomocí PowerShellu

Pokud chcete upravit runbook pomocí Windows PowerShellu, upravte pracovní postup pomocí editoru podle svého výběru a uložte ho do souboru .ps1. Pomocí rutiny Get-SMARunbookDefinition můžete načíst obsah runbooku a potom rutinu Edit-SMARunbook nahradit stávající pracovní postup konceptu změněným pracovním postupem.

Načtení obsahu runbooku pomocí Windows PowerShellu

Následující ukázkové příkazy ukazují, jak načíst skript runbooku a uložit ho do souboru skriptu. V tomto příkladu se načte verze Konceptu. Je také možné načíst publikovanou verzi runbooku, i když tuto verzi nelze 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 runbooku pomocí Windows PowerShellu

Následující ukázkové příkazy ukazují, jak nahradit existující obsah runbooku obsahem souboru skriptu obsahujícího pracovní postup.

$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

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

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

  2. Pokud se doplněk SMA ISE nezobrazuje na pravé straně isE, 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 potřebné změny runbooku.

  8. Výběrem možnosti Odeslat koncept odešlete runbook do SMA. Tím se přepíše stávající verze konceptu runbooku.

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

Publikování runbooku

Po vytvoření runbooku ho musíte publikovat, aby ho mohl spustit pracovní proces runbooku. Každý runbook ve službě Service Management Automation má koncept a publikovanou verzi. Spustit je možné pouze publikovanou verzi a upravit je možné pouze verzi konceptu. Publikovaná verze není ovlivněna žádnými změnami ve verzi konceptu. Až budete připravení zpřístupnit verzi konceptu, publikujete ji, která přepíše publikovanou verzi verzí konceptu.

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

  1. Vyberte pracovní prostor Automation.

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

  3. Vyhledejte runbook, který chcete upravit, 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 Publish-SmaRunbook můžete použít k publikování runbooku pomocí Windows PowerShellu. Následující ukázkové 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í integrovaného skriptového prostředí (ISE) PowerShellu

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

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

  2. Pokud se doplněk SMA ISE nezobrazuje na pravé straně isE, 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.

Otestování runbooku

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

Při testování runbooku se spustí koncept runbooku a všechny akce, které provede, se dokončí. Není vytvořena žádná historie úloh, ale v podokně výstupu testu se zobrazují streamy Výstup a Upozornění a Chyba . Zprávy do podrobného datového proudu se zobrazí v podokně výstupu pouze v případě, že je proměnná $VerbosePreference nastavená na Pokračovat.

Při testování runbooku se pracovní postup spustí normálně a provede všechny akce s prostředky v prostředí. Z tohoto důvodu byste měli runbooky testovat pouze proti neprodukčním prostředkům.

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

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

Runbook můžete zastavit nebo pozastavit při testování pomocí tlačítek pod podoknem výstupu. Když Runbook pozastavíte, dokončí aktuální aktivitu a teprve pak se pozastaví. Po pozastavení runbooku ho můžete zastavit nebo restartovat.

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

Doplněk ISE PowerShellu poskytuje rutiny, které emulují standardní aktivity, jako je Get-SMACredential a Set-SMAVariable, takže runbook můžete 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žívaly 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 Konceptu v SMA. Otevře se nové okno. Vyberte Spustit novou úlohu a spusťte test. Výstup se zobrazí v okně.

Ukázky runbooků služby Automation

Následující runbooky jsou dodávány se službou Service Management Automation jako ukázkové runbooky pro ilustraci technik a osvědčených postupů. Jsou k dispozici pro použití v rozšíření Automation v sadě Microsoft Azure Pack pro Windows Server.

Název runbooku Popis
Sample-Deleting-VMCloud-Subscription Demonstruje užitečný scénář pro aktivaci runbooku, když uživatel odstraní předplatné cloudů virtuálních počítačů.
Ukázka správy 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 ke Configuration Manageru.
Sample-Managing-DataProtectionManager Ukazuje, jak se připojit k serveru Data Protection Manager (DPM) a zobrazit informace o discích nalezených na serveru DPM.
Sample-Managing-MySQLServers Ukazuje, jak načíst token zabezpečení, který se použije k načtení seznamu hostitelských serverů.
Sample-Managing-OperationsManager Demonstruje schopnost služby Service Management Automation pro připojení 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 Ukazuje, jak vytvořit nový plán a přidat službu SQL Serveru s definovanou kvótou do nového plánu.
Sample-Managing-ServiceBusClouds Ukazuje, jak se připojit ke cloudovému serveru služby Service Bus a zobrazit informace o vytvořených oborech názvů.
Sample-Managing-SQLServers Ukazuje, jak vytvořit novou skupinu serverů a přidat hostitelský server SQL.
Sample-Managing-UserAccounts Ukazuje, jak vytvořit uživatele v sadě Microsoft Azure Pack pro Windows Server, který se vytvoří v sadě Microsoft Azure Pack, a zobrazí se na portálu pro správu pro rozšíření Users pro správce. 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 pro tenanty, který není součástí této ukázky.
Sample-Managing-VirtualMachineManager Ukazuje, jak se připojit k serveru nástroje Virtual Machine Manager (VMM) a zobrazit informace o licenci serveru VMM.
Sample-Managing-VMClouds Ukazuje, jak získat přístup k informacím o připojení databáze serveru Service Provider Foundation a informace o objektech serveru VMM spravovaných službou Service Provider Foundation.
Sample-Managing-WebSiteCloud Ukazuje, jak se připojit k serveru kontroleru cloudů webů a zobrazit informace o nasazených serverech Web Site Clouds.
Sample-Modify-VMCloud-Subscription Demonstruje užitečný scénář pro aktivaci runbooku, když tenant nebo správce pozastaví nebo aktivuje předplatné cloudů virtuálních počítačů.
Sample-Using-Activities Demonstruje schopnost služby Service Management Automation používat aktivity.
Ukázkové použití kontrolních bodů 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ýstupy uživatele, který runbook Service Management Automation běží jako. Pak se připojí k serveru ServerName a vypíše uživatele určeného parametrem SampleCredential, který k serveru přistupuje.
Sample-Using-Modules Demonstruje import modulů v runboocích a vypíše počet již importovaných modulů na serveru ServerName. Potom naimportuje modul určený modulem ModulePath a vypíše nový počet modulů a informace odpovídající nově importovanému modulu.
Sample-Using-RunbookParameters Ukazuje, jak použít vstupní parametry pro runbooky a také určit, zda jsou parametry povinné, poskytovat výchozí hodnoty parametrů a používat hodnoty parametrů později v pracovním postupu.
Ukázkové použití runbooků Ukazuje, jak volat runbook z jiného runbooku.
Sample-Using-SuspendWorkflow Ukazuje, jak vynutit pozastavení runbooku. To může být užitečné, pokud se vyžaduje ruční krok před pokračováním runbooku, například přijetí schválení odhlášení od konkrétní osoby. Po dokončení ručního kroku se pozastavený runbook obnoví ručně, aby runbook pokračoval.
Ukázkové použití proměnných Demonstruje schopnost služby Service Management Automation používat proměnné.
Sample-Using-VMCloud-Automation Demonstruje užitečný scénář pro aktivaci runbooku na začátku události Service Provider Foundation.

Další kroky