Futtatókörnyezet és a kapcsolódó runbookok kezelése
Ez a cikk bemutatja, hogyan hozhat létre futtatókörnyezetet, és hogyan hajthat végre különböző műveleteket az Azure Portalon és a REST API-n keresztül.
Előfeltételek
Azure Automation-fiók támogatott nyilvános régióban (kivéve Közép-India, Észak-Németország, Észak-Olaszország, Közép-Izrael, Lengyelország középső régiója, az Egyesült Arab Emírségek középső régiója és kormányzati felhők).
Váltás a futtatókörnyezet és a régi élmény között
Futtatókörnyezeti élmény
Válassza az Áttekintés lehetőséget, majd válassza a Runtime-környezet kipróbálási élménye lehetőséget.
A Folyamatautomatizálás területen a Futtatókörnyezetek (előzetes verzió) és a Megosztott erőforrások alatt lévő modulok és Python-csomagok törlődnek, mivel a futtatókörnyezet lehetővé teszi a Runbook végrehajtása során szükséges csomagok kezelését.
Ha vissza szeretne térni a modulok és csomagok kezelésének régi felületére, válassza a bal oldali panel Áttekintés elemét, majd válassza a Váltás régi felületre lehetőséget.
Régi élmény
Lépjen az Automation-fiókjához, a Folyamatautomatizálás területen a futtatókörnyezetek (előzetes verzió) el lesznek távolítva, és a megosztott erőforrások, modulok és Python-csomagok alatt láthatók.
Feljegyzés
A runbook-frissítések továbbra is megmaradnak az új futtatókörnyezet és a régi élmény között. A runbookhoz társított Futtatókörnyezetben végzett módosítások a runbookok régi környezetben történő végrehajtása során is megmaradnak.
Futtatókörnyezet kezelése
Futtatókörnyezet létrehozása
Jelentkezzen be az Azure Portalra, és válassza ki az Automation-fiókját.
A Folyamatautomatizálás területen válassza a Futtatókörnyezetek (előzetes verzió), majd a Létrehozás lehetőséget.
Az Alapszintű beállítások területen adja meg a következő adatokat:
A futtatókörnyezet neve . Betűrenddel kell kezdődnie, és csak ábécéket, számokat, aláhúzásjeleket és kötőjeleket tartalmazhat.
A Nyelv legördülő listában válassza ki a futtatókörnyezet szkriptnyelvét.
- Válassza a PowerShellt a PowerShell szkriptelési nyelvéhez vagy a Python szkriptnyelvhez készült Pythont .
Válassza ki a futtatókörnyezet verzióját a szkriptnyelvhez.
- PowerShell esetén – 5.1, 7.2
- Python esetén – válassza a 3.8- és a 3.10-et (előzetes verzió)
Adja meg a megfelelő leírást.
Válassza a Tovább lehetőséget, és a Csomagok lapon töltse fel a runbook végrehajtása során szükséges csomagokat. Az Az PowerShell-csomag alapértelmezés szerint fel van töltve az összes PowerShell-futtatókörnyezethez, amely tartalmazza az Azure-erőforrások kezeléséhez szükséges összes parancsmagot. A legördülő menüből kiválaszthatja az Az-csomag verzióját. Válassza a Nincs lehetőséget, ha nem szeretné, hogy a csomag fel legyen töltve a runbook végrehajtása során.
Feljegyzés
Az Azure CLI-parancsok támogatottak (előzetes verzió) a PowerShell 7.2 Futtatókörnyezethez társított runbookokban. Az Azure CLI-parancsok 2.56.0-s verziója alapértelmezett csomagként érhető el a PowerShell 7.2 Futtatókörnyezetben.
További szükséges csomagok feltöltése a runbook végrehajtása során. Válassza a Fájl hozzáadása lehetőséget a számítógépen helyben tárolt fájl(ok) hozzáadásához, vagy válassza a Hozzáadás gyűjteményből lehetőséget a csomagok PowerShell-gyűjteményből való feltöltéséhez.
Feljegyzés
- Egy csomag importálása több percet is igénybe vehet. A 100 MB az importálható fájlok maximális teljes mérete.
- .zip-fájlok használata PowerShell-runbook-típusokhoz az itt leírtak szerint
- Python 3.8-csomagok esetén használja a cp38-amd64-et célzó .whl-fájlokat.
- Python 3.10 -csomagok (előzetes verzió) esetén a cp310 Linux operációs rendszert célzó .whl-fájlokat használjon.
Válassza a Tovább lehetőséget, és a Véleményezés + Létrehozás lapon ellenőrizze, hogy a beállítások helyesek-e. Amikor a Létrehozás lehetőséget választja, az Azure a kiválasztott futtatókörnyezeti beállításokon futtatja az ellenőrzést. Ha az ellenőrzés sikeres, létrehozhat futtatókörnyezetet, a portál pedig jelzi a módosítani kívánt beállításokat.
A Futtatókörnyezetek (előzetes verzió) lapon megtekintheti az Automation-fiók újonnan létrehozott futtatókörnyezetét. Ha nem találja az újonnan létrehozott futtatókörnyezeteket a listában, válassza a Frissítés lehetőséget.
Futtatókörnyezet megtekintése
Szerezze be a futtatókörnyezet tulajdonságait az Automation-fiókból.
GET
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runtimeEnvironments/<runtimeEnvironmentName>?api-version=2023-05-15-preview
Futtatókörnyezetek listázása
Az Automation-fiók összes futtatókörnyezetének listázása:
Az Automation-fiók Folyamatautomatizálás területén válassza a Futtatókörnyezetek (előzetes verzió) lehetőséget.
Az Az PowerShell-csomag összetevőinek megtekintése
Az Az PowerShell-csomag összes összetevőcsomagjának megtekintéséhez futtassa Get-Module -ListAvailable a parancsmagot egy PowerShell-runbookban.
A feladat kimenete az összes összetevőcsomagot és azok verzióit jeleníti meg.
Futtatókörnyezet törlése
Ha törölni szeretné a futtatókörnyezetet az Automation-fiókból, kövesse az alábbi lépéseket:
Az Automation-fiók Folyamatautomatizálás területén válassza a Futtatókörnyezetek (előzetes verzió) lehetőséget.
Válassza ki a törölni kívánt futtatókörnyezetet.
A Futtatókörnyezet törléséhez válassza a Törlés lehetőséget.
Futtatókörnyezet frissítése
A futtatókörnyezet nyelve és a futtatókörnyezet verziója nem módosítható tulajdonságok. Azonban frissítheti a modulok verzióját, és hozzáadhat vagy eltávolíthat csomagokat a Futtatókörnyezetben. A futtatókörnyezethez csatolt runbookok automatikusan frissülnek az új beállításokkal.
Az Automation-fiók Folyamatautomatizálás területén válassza a Futtatókörnyezetek (előzetes verzió) lehetőséget.
Válassza ki a frissíteni kívánt futtatókörnyezetet.
Válassza ki a verziót a legördülő listából a meglévő csomagok verziójának frissítéséhez.
Válassza a Mentés lehetőséget.
Válassza az Add a file to upload packages from your local computer or Add from gallery to upload packages from PowerShell-galéria (Fájl hozzáadása) lehetőséget a helyi számítógépről való csomagok feltöltéséhez, vagy a gyűjteményből való feltöltéshez.
Feljegyzés
Egyszerre legfeljebb 10 csomagot adhat hozzá a Futtatókörnyezethez. 10 csomag hozzáadása után győződjön meg arról, hogy menti a fájlt .
Runtime-környezethez társított runbookok kezelése
Runbook létrehozása
Futtatókörnyezettel konfigurált új PowerShell-runbookot is létrehozhat.
Előfeltétel
- Runbook létrehozása előtt győződjön meg arról, hogy létrehozott egy futtatókörnyezetet.
A futtatókörnyezethez csatolt új runbook létrehozásához kövesse az alábbi lépéseket:
Az Automation-fiók Folyamatautomatizálás területén válassza a Runbookok lehetőséget.
Válassza a Létrehozás lehetőséget.
Az Alapok lapon létrehozhat egy új runbookot, vagy feltölthet egy fájlt a helyi számítógépről vagy a PowerShell-gyűjteményből.
Adja meg a runbook nevét. Betűvel kell kezdődnie, és csak betűket, számokat, aláhúzásjeleket és kötőjeleket tartalmazhat.
A Runbook típus legördülő listájában válassza ki a létrehozni kívánt runbook típusát.
Válassza ki a runbookhoz konfigurálni kívánt futtatókörnyezetet . Választhat a meglévő futtatókörnyezetekből, vagy létrehozhat új futtatókörnyezetet, és összekapcsolhatja a Runbookhoz. A futtatókörnyezetek listája a b lépésben kiválasztott Runbook-típus alapján van feltöltve.
Adja meg a megfelelő leírást.
Feljegyzés
A PowerShell-runbook típusa esetén csak a PowerShell-futtatókörnyezet szerepel a listán a kiválasztáshoz. A Python Runbook típusa esetén csak a Python Runtime-környezetek jelennek meg a kijelöléshez.
Adjon hozzá címkéket a runbookhoz, tekintse át a beállításokat, és válassza a Létrehozás lehetőséget egy új runbook létrehozásához.
Ez a runbook a kiválasztott futtatókörnyezethez van csatolva. A kiválasztott futtatókörnyezet összes csomagja elérhető lesz a runbook végrehajtása során.
Runbook frissítése
A runbook frissítéséhez módosítsa a runbookhoz társított futtatókörnyezetet. A frissítéshez egy vagy több runbookot is választhat. A runbook futási állapotában nincs hatással a runbookhoz társított futtatókörnyezet módosításával.
Az Automation-fiók Folyamatautomatizálás területén válassza a Runbookok lehetőséget.
Jelölje be a frissíteni kívánt runbook(ok) jelölőnégyzetét.
Válassza a Frissítés lehetőséget.
Válassza ki azt a futtatókörnyezetet a legördülő listából, amelyhez a runbook(ok)t össze szeretné kapcsolni.
Válassza a Frissítés lehetőséget a kiválasztott runbook(ok) új futtatókörnyezettel való frissítéséhez.
Ellenőrizze, hogy a runbook a frissítés után a várt módon fut-e. Ha a runbook nem adja meg a várt eredményt, az 1–4. lépés végrehajtásával ismét frissítheti a futtatókörnyezetet a régi felületre.
Feljegyzés
A runbook-frissítések továbbra is megmaradnak az új futtatókörnyezet és a régi élmény között. A runbookhoz társított futtatókörnyezetben végzett módosítások a runbookok régi környezetben történő végrehajtása során is megmaradnak.
Runbook frissítésének tesztelése
Futtasson egy tesztfeladatot egy másik futtatókörnyezettel rendelkező runbookhoz. Ez a forgatókönyv akkor hasznos, ha egy runbookot futásidejű környezettel kell tesztelni a frissítés előtt.
A runbookok frissítéséhez módosítsa az adott runbookhoz társított futtatókörnyezetet. Javasoljuk, hogy a módosítások közzététele előtt tesztelje a runbook végrehajtását. Annak érdekében, hogy a runbook a várt módon működjön.
A runbook végrehajtásának teszteléséhez a futtatókörnyezet módosításainak közzététele előtt kövesse az alábbi lépéseket:
Nyissa meg a Runbookok lapot, és válassza ki azt a runbookot, amelyhez frissíteni szeretné a Futtatókörnyezetet.
A Runbook szerkesztése lapon válassza a Szerkesztés a Portálon lehetőséget a szövegszerkesztő megnyitásához.
A Futtatókörnyezet környezet mező a meglévő konfigurációt jeleníti meg. Válassza ki az új futtatókörnyezetet a legördülő listából.
Válassza a Teszt panelt a runbook végrehajtásának teszteléséhez a frissített futtatókörnyezettel. Válassza a Start elemet a tesztfuttatás megkezdéséhez.
Zárja be a tesztpanelt, és szükség esetén végezze el a szükséges módosításokat a Runbook-kódban vagy a Futtatókörnyezetben.
Válassza a Közzététel lehetőséget a runbookhoz társított futtatókörnyezet frissítéséhez.
Válassza az Igen lehetőséget a korábban közzétett verzió felülbírálásához és a módosítások megerősítéséhez.
Felhőfeladat létrehozása
Jelenleg a Runtime-környezethez társított runbookok az Azure-ban futnának.
Meglévő runbookok összekapcsolása a rendszer által létrehozott futtatókörnyezetekkel
Az Azure Automation-fiók összes meglévő runbookja automatikusan a rendszer által létrehozott futtatókörnyezetekhez lesz társítva. Ezek a rendszer által létrehozott futtatókörnyezetek a saját Azure Automation-fiókban található futtatókörnyezeti nyelv, verzió és modulok/csomagok alapján jönnek létre. További információ. A meglévő runbookok frissítéséhez módosítsa a futtatókörnyezetet az itt ismertetett lépések végrehajtásával.
Következő lépések
- Áttekintő futtatókörnyezet.
- A runbook végrehajtásával kapcsolatos problémák elhárításához tekintse meg a runbookokkal kapcsolatos problémák hibaelhárítását.