Service Management Automation-runbookok készítése

  • Cikk

Fontos

A Service Management Automation (SMA) ezen verziója elérte a támogatás végét. Javasoljuk, hogy frissítsen az SMA 2022-re.

A Service Management Automation és a Microsoft Azure Automation runbookjai Windows PowerShell munkafolyamatok vagy PowerShell-szkriptek. Lehetővé teszik a felhőkiszolgálók kezeléséhez és központi telepítéséhez kapcsolódó adminisztratív folyamatok automatizálását, illetve bármely olyan egyéb feladat automatizálását, amely egy Windows PowerShell-parancsprogrammal elvégezhető.

A két rendszer között nincs különbség a runbookokban, és ugyanaz a runbook ugyanazzal a funkcióval is futtatható. A cikkben az Automation kifejezés a Service Management Automationre és a Microsoft Azure Automation is vonatkozik.

Az automatizálás egyebek között az alábbi kiegészítő szolgáltatásokat nyújtja a Windows PowerShell-munkafolyamatok használatához:

  • Runbookok központi tárolása és kezelése.

  • Méretezhető architektúra a Runbookok ütemezéséhez és futtatásához.

  • A központilag kezelhető globális erőforrások az összes Runbook számára elérhetők.

  • A felhasználói kezelőfelület lehetővé teszi a Runbookok elkészítését és tesztelését.

  • Rendelkezésre áll a Runbookok kezelésére és elindítására szolgáló parancsmagok készlete.

Runbook létrehozása vagy importálása

Runbookot a Service Management Automation szolgáltatáshoz úgy adhat hozzá, hogy létrehozza azt a felügyeleti portálon, vagy egy fájlból importálja.

Runbook létrehozása a felügyeleti portálon

  1. A Felügyeleti portálon válassza az Új, Az App Services, az Automation, a Runbook, a Gyors létrehozás lehetőséget.

  2. Adja meg a szükséges adatokat, és válassza a Létrehozás lehetőséget. A runbook nevének betűvel kell kezdődnie, és tartalmazhat betűket, számokat, aláhúzásjeleket és kötőjeleket.

  3. Ha most szeretné szerkeszteni a runbookot, válassza a Runbook szerkesztése lehetőséget. Ellenkező esetben válassza az OK gombot.

  4. Az új runbook megjelenik a Runbookok lapon.

Runbook importálása fájlból

  1. A Felügyeleti portálon válassza az Automation lehetőséget, majd válasszon egy Automation-fiókot.

  2. Válassza az Importálás lehetőséget.

  3. Válassza a Tallózás a fájlhoz lehetőséget, és keresse meg az importálni kívánt szkriptfájlt.

  4. Ha most szeretné szerkeszteni a runbookot, válassza a Runbook szerkesztése lehetőséget. Ellenkező esetben válassza az OK gombot.

  5. Az új runbook megjelenik az Automation-fiók Runbookok lapján.

Runbook importálása szkriptfájlból Windows PowerShell

Az Import-SmaRunbook parancsmaggal létrehozhat egy új runbookot egy munkafolyamatot tartalmazó szkriptfájlból.

A következő mintaparancsok bemutatják, hogyan végezhető el a parancsfájl egy létező runbookba történő importálása, majd közzététele.

$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

Runbook szerkesztése

A Service Management Automation minden runbookja két verzióval rendelkezik: Piszkozat és Közzétett. Szerkessze a munkafolyamat Piszkozat verzióját, majd tegye közzé, hogy végrehajthassa. A Közzétett verzió nem szerkeszthető.

Runbook szerkesztése a felügyeleti portállal

A kezelési portál tartalmaz egy, a runbookok megtekintésére és szerkesztésére szolgáló szerkesztőt. Az alapszintű szövegszerkesztési képességek mellett a szerkesztő lehetővé teszi a runbookok, globális eszközök és tevékenységek kódjának automatikus beszúrását.

  1. Válassza a kezelési portál Automatizáláselemét.

  2. Válassza a Runbook lapot.

  3. Válassza ki a szerkeszteni kívánt runbook nevét.

  4. Válassza a Szerző lapot.

  5. Válassza a piszkozat lehetőséget a képernyő tetején vagy a Szerkesztés gombot a képernyő alján.

  6. Hajtsa végre a szükséges módosításokat.

  7. A módosítások befejezésekor válassza a Mentés lehetőséget.

  8. Válassza a Közzététel lehetőséget, ha közzé szeretné tenni a runbook legújabb piszkozatverzióját.

Válassza a runbookok, globális eszközök és tevékenységek kódjának beszúrásához szükséges lapot:

Az alábbi lépéseket követve szúrjon be kódot egy runbookba:

  1. Nyissa meg a runbookot a kezelési portál szerkesztőjében.

  2. A képernyő alján válassza a Beszúrás , majd a Runbook lehetőséget.

  3. Jelölje ki a középoszlopból beszúrni kívánt runbookot, és válassza a jobbra mutató nyilat.

  4. Ha a runbook paraméterekkel rendelkezik, akkor a program ezeket tájékoztatási céllal felsorolja.

  5. Válassza a pipa gombot.

  6. A kijelölt runbook futtatásához használható kód be lesz szúrva az aktuális runbookba.

  7. Ha a runbook paramétereket igényel, adjon meg egy megfelelő értéket a kapcsos zárójelekkel <>körülvett adattípus helyett.

Automation-runbook szerkesztése a PowerShell-lel

Ha Windows PowerShell használatával szeretne szerkeszteni egy runbookot, először módosítania kell a munkafolyamatot a választott szerkesztővel, majd menteni egy .ps1 fájlba. A Get-SMARunbookDefinition parancsmaggal lekérheti a runbook tartalmát, majd az Edit-SMARunbook parancsmaggal lecserélheti a meglévő piszkozat-munkafolyamatot a módosítottra.

Runbook tartalmának lekérése Windows PowerShell

A következő mintaparancsok bemutatják, hogyan kérhető le egy runbook parancsfájlja és menthető egy parancsfájlba. Ez a példa a vázlatverzió lekérését mutatja be. A runbook Közzétett verzióját is lekérheti, bár ez a verzió nem módosítható.

$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

Runbook tartalmának módosítása Windows PowerShell

A következő mintaparancsok bemutatják, hogyan cserélhető le egy runbook meglévő tartalma egy munkafolyamatot tartalmazó parancsfájl tartalmára.

$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

Automation-runbook szerkesztése a PowerShell ISE-vel

Windows PowerShell integrált szkriptelési környezet (ISE) egy olyan alkalmazás, amely parancsok futtatását, valamint szkriptek írását, tesztelését és hibakeresését teszi lehetővé. Az SMA PowerShell ISE bővítmény lehetővé teszi, hogy ezzel az eszközzel Automation-runbookokat írjon és teszteljen.

  1. Nyissa meg a Windows PowerShell ISE-t.

  2. Ha az SMA ISE bővítmény nem jelenik meg az ISE jobb oldalán, nyissa meg a Bővítmények menüt, és engedélyezze az SMA ISE bővítményt.

  3. Jelentkezzen be az SMA-ba a Konfiguráció lapon.

  4. Válassza a Runbook lapot. Meg kell jelennie az SMA-runbookok listájának.

  5. Jelölje ki a szerkeszteni kívánt runbookot, és válassza a Letöltés lehetőséget. Ez letölti a runbook helyi példányát az SMA-ból.

  6. Válassza a Megnyitás lehetőséget. Ezzel létrehoz egy új lapot a runbookhoz.

  7. Végezze el a runbook szükséges módosításait.

  8. Válassza a Piszkozat feltöltése lehetőséget a runbook SMA-ba való küldéséhez. Ez felülírja a runbook meglévő piszkozatverzióját.

  9. Válassza a Piszkozat közzététele lehetőséget, ha közzé szeretné tenni a runbook legújabb piszkozatverzióját.

Runbook közzététele

Miután létrehozta a runbookot, közzé kell tennie, hogy a runbook-feldolgozó végrehajthassa. A Service Management Automation minden runbookja piszkozattal és közzétett verzióval rendelkezik. Kizárólag a Közzétett verziót lehet futtatni, és kizárólag a Piszkozat verzió szerkeszthető. A Közzétett verzióra nincsenek hatással a Piszkozat verzióban végrehajtott módosítások. Ha készen áll a Piszkozat verziójának elérhetővé fogadására, közzéteszi azt, amely felülírja a Közzétett verziót a Piszkozat verzióval.

Runbook közzététele a felügyeleti portálon

  1. Válassza ki az Automation-munkaterületet.

  2. A képernyő tetején válassza a Runbookok lehetőséget.

  3. Keresse meg a szerkeszteni kívánt runbookot, és kattintson annak nevére.

  4. A képernyő tetején válassza a Szerző lehetőséget.

  5. Válassza a Piszkozat lehetőséget.

  6. A képernyő alján válassza a Közzététel lehetőséget.

  7. Válassza az Igen lehetőséget az ellenőrző üzenethez.

Runbook közzététele a PowerShell használatával

A Windows PowerShellben a Publish-SmaRunbook parancsmaggal tehet közzé egy runbookot. A következő, mintaként megadott parancsok bemutatják, miként tehet közzé egy runbookot.

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

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

Runbook közzététele a PowerShell ISE használatával

Windows PowerShell integrált szkriptelési környezet (ISE) egy olyan alkalmazás, amely parancsok futtatását, valamint szkriptek írását, tesztelését és hibakeresését teszi lehetővé. Az SMA PowerShell ISE bővítmény lehetővé teszi, hogy ezzel az eszközzel Automation-runbookokat írjon és teszteljen.

  1. Nyissa meg a Windows PowerShell ISE-t.

  2. Ha az SMA ISE bővítmény nem jelenik meg az ISE jobb oldalán, nyissa meg a Bővítmények menüt, és engedélyezze az SMA ISE bővítményt.

  3. Jelentkezzen be az SMA-ba a Konfiguráció lapon.

  4. Válassza a Runbook lapot. Meg kell jelennie az SMA-runbookok listájának.

  5. Válassza ki a runbookot, és válassza a Piszkozat közzététele lehetőséget a runbook legújabb piszkozatverziójának közzétételéhez.

Runbook tesztelése

A runbook piszkozatverzióját a Service Management Automationben tesztelheti, miközben változatlanul hagyja a runbook közzétett verzióját. Ezzel leellenőrizheti, hogy a runbook megfelelően működik-e, mielőtt lecseréli a közzétett verziót.

A runbook tesztelésekor a program a runbook vázlatát hajtja végre, és minden elvégzett műveletet végrehajt. Nem jön létre feladatelőzmény, de a Kimenet tesztelése panelen megjelennek a Kimenet és figyelmeztetés és hiba streamek. A Részletes Stream üzenetei csak akkor jelennek meg a Kimeneti panelen, ha a $VerbosePreference változóa Continue (Folytatás) értékre van állítva.

A runbookok tesztelésekor továbbra is a szokásos módon hajtja végre a munkafolyamatot, és végrehajtja a környezetben lévő erőforrásokon végzett műveleteket. Ezért soha ne tesztelje a runbookokat termelési erőforrásokon.

Runbook tesztelése a Service Management Automationben

Runbook teszteléséhez nyissa meg a runbook Piszkozat verzióját a felügyeleti portálon. A teszt elindításához kattintson a képernyő alján található Teszt gombra.

A runbookot a Kimeneti ablak alatti gombokkal leállíthatja vagy felfüggesztheti. A runbook felfüggesztésekor a teszt a felfüggesztés előtt még végrehajtja az aktuális tevékenységet. A felfüggesztés után a runbookot megállíthatja vagy újraindíthatja.

Runbook tesztelése a PowerShell ISE használatával

A PowerShell ISE bővítmény olyan parancsmagokat biztosít, amelyek emulálják az olyan szabványos tevékenységeket, mint a Get-SMACredential és a Set-SMAVariable, így ugyanúgy tesztelheti a runbookot a helyi számítógépen, mint bármely más szkriptet.

A rendszer letölti a globális eszközöket és azok értékeit az automatizálási csoportból a helyi teszteléshez. Ezeket az értékeket az Eszközök lapon vizsgálhatja meg vagy módosíthatja. A titkosított értékek narancssárga színnel jelennek meg, és az értékek nem töltődnek le. Ha ezeket az eszközöket helyi tesztelésben szeretné használni, akkor helyileg kell megadnia az értéküket.

A runbook SMA-ban való teszteléséhez válassza a Piszkozat tesztelése az SMA-ban lehetőséget. Ekkor megnyílik egy új ablak. A teszt elindításához válassza az Új feladat indítása lehetőséget. A kimenet megjelenik az ablakban.

Automation-runbook-minták

Az alábbi runbookok a Service Management Automationt mintaként futtatják a technikák és az ajánlott eljárások szemléltetésére. Ezek a Windows Serverhez készült Microsoft Azure Pack Automation bővítményben használhatók.

Runbook neve Description
Sample-Deleting-VMCloud-Subscription Példahelyzetet mutat be Runbook indítására, amikor egy felhasználó VM Clouds előfizetést töröl.
Sample-Managing-Azure Bemutatja, hogyan csatlakozhat Egy Microsoft Azure-előfizetéshez, és hogyan hajthat végre alapműveleteket a Microsoft Azure PowerShell modul használatával.
Sample-Managing-ConfigurationManager Bemutatja, hogy a Service Management Automation képes-e csatlakozni a Configuration Manager.
Sample-Managing-DataProtectionManager Bemutatja, hogyan kell Data Protection Manager (DPM) kiszolgálóhoz csatlakozni és megtekinteni a DPM-kiszolgálón található lemezek adatait.
Sample-Managing-MySQLServers Bemutatja, hogyan kell az állomáskiszolgálók listájának beolvasásához használt biztonsági jogkivonatot beolvasni.
Sample-Managing-OperationsManager Bemutatja, hogy a Service Management Automation képes-e csatlakozni a System Center Operations Managerhez.
Sample-Managing-Orchestrator Bemutatja, hogyan csatlakozhat a System Center Orchestratorhoz, és hogyan indíthat el egy Orchestrator-runbookot a meglévő infrastruktúra használatához.
Sample-Managing-Plans Bemutatja, hogyan kell új tervet létrehozni és megadott kvótával rendelkező SQL Server szolgáltatást hozzáadni az új tervhez.
Sample-Managing-ServiceBusClouds Bemutatja, hogyan kell Service Bus Cloud kiszolgálóhoz csatlakozni és megtekinteni a létrehozott névterek adatait.
Sample-Managing-SQLServers Bemutatja, hogyan kell új kiszolgálócsoportot létrehozni és SQL állomáskiszolgálót felvenni.
Sample-Managing-UserAccounts Bemutatja, hogyan hozhat létre felhasználót a Windows Serverhez készült Microsoft Azure Packben, amely a Microsoft Azure Packben jön létre, és hogyan jelenik meg a felügyeleti portálon a rendszergazdák számára – Felhasználók bővítmény. Ezt a felhasználót azonban integrálnia kell a hitelesítési szolgáltatóba (például AuthSite) a bérlők felügyeleti portáljának eléréséhez, amely nem szerepel ebben a mintában.
Sample-Managing-VirtualMachineManager Bemutatja, hogyan kell csatlakozni a Virtual Machine Manager (VMM) alkalmazáshoz és megtekinteni a VMM kiszolgálólicenc adatait.
Sample-Managing-VMClouds Bemutatja, hogyan érhetők el a Service Provider Foundation kiszolgáló adatbázis-kapcsolat és a Service Provider Foundation által kezelt VMM kiszolgálóobjektumok adatai.
Sample-Managing-WebSiteCloud Bemutatja, hogyan kell csatlakozni a Web Site Clouds vezérlőkiszolgálóhoz és megtekinteni a Web Site Clouds telepített kiszolgálóinak adatait.
Sample-Modify-VMCloud-Subscription Példahelyzetet mutat be Runbook indítására, amikor egy bérlő vagy rendszergazda VM Clouds előfizetést függeszt fel vagy aktivál.
Sample-Using-Activities Bemutatja, hogy a Service Management Automation képes-e tevékenységeket használni
Sample-Using-Checkpoints Bemutatja, hogy az ellenőrzőpontok használhatók-e a Service Management Automationben.
Sample-Using-Connections Bemutatja, hogy a Service Management Automation képes-e kapcsolatokat használni a távoli rendszerekhez való csatlakozáshoz.
Sample-Using-Credentials Bemutatja, hogy a Service Management Automation képes-e hitelesítő adatokat használni, és kimenetként adja ki azt a felhasználót, akiként a Service Management Automation runbook fut. Ezután csatlakozik a „ServerName” kiszolgálóhoz, és kiírja a kiszolgálóhoz hozzáférő, a „SampleCredential” által megadott felhasználót.
Sample-Using-Modules Modulok Runbookokba végzett importálását mutatja be, és kiírja a „ServerName” kiszolgálóra már importált modulok számát. Ezután importálja a „ModulePath” által megadott modult, és kiírja az új modulszámot és az újonnan importált modul adatait.
Sample-Using-RunbookParameters Bemutatja, hogyan lehet bemeneti paramétereket használni Runbookokban, hogy lehet megadni, hogy a paraméterek megadása kötelező legyen, hogyan biztosíthatók alapértelmezett paraméterértékek, és később a munkafolyamatban hogyan használhatók paraméterértékek.
Sample-Using-Runbooks Bemutatja, hogyan kell Runbookot meghívni egy másik Runbookból.
Sample-Using-SuspendWorkflow Bemutatja hogyan kell kikényszeríteni Runbook felfüggesztését. Ez akkor lehet hasznos, ha manuális lépésre van szükség a runbook folytatásához, például egy adott személytől kap bejelentkezési jóváhagyást. A manuális lépés befejezése után a felfüggesztett Runbook folytatásával folytatható a Runbook.
Sample-Using-Variables Bemutatja, hogy a Service Management Automation képes-e változókat használni.
Sample-Using-VMCloud-Automation Bemutatja, hogyan indítható Runbook a Service Provider Foundation esemény indításakor.

Következő lépések