Batch-erőforrássok kezelése az Azure CLI-vel
A Azure Batch-fiókokat és -erőforrásokat az Azure Command-Line Interface (Azure CLI) használatával kezelheti. Batch-erőforrások, például készletek, feladatok és tevékenységek létrehozására és frissítésére szolgáló parancsok találhatók. A Batch API-kon, a PowerShell-parancsmagokon és a Azure Portal keresztül számos feladathoz is létrehozhat szkripteket.
Futtathatja az Azure CLI-t az Azure Cloud Shell, vagy telepítheti az Azure CLI-t helyileg. A verziók Windows, Mac és Linux operációs rendszerekhez (OS) érhetők el.
Ez a cikk bemutatja, hogyan használható az Azure CLI Batch-fiókokkal és -erőforrásokkal.
Az Azure CLI beállítása
Válassza ki, hogyan szeretné beállítani az Azure CLI-t:
- Futtassa az Azure CLI-t Cloud Shell.
- Telepítse az Azure CLI-t helyileg.
- Az Azure CLI telepítése Windows rendszeren
- Az Azure CLI telepítése macOS rendszeren
- Telepítse az Azure CLI-t Linuxon több Linux-disztribúcióhoz.
Ha még nem használta az Azure CLI-t, a folytatás előtt tekintse meg az Azure CLI használatának első lépéseit .
Ha korábban helyileg telepítette az Azure CLI-t, mindenképpen frissítse a telepítést a legújabb verzióra.
Hitelesítés az Azure CLI-vel
Az Azure CLI És a Batch használatához először jelentkezzen be az Azure-fiókjába, majd jelentkezzen be a Batch-fiókjába.
Bejelentkezés azure-fiókba
Az Azure CLI használatához először jelentkezzen be az Azure-fiókjába. Ez a lépés hozzáférést biztosít az Azure Resource Manager-parancsokhoz, amelyek a Batch Management szolgáltatásparancsokat is tartalmazzák. Ezután parancsokat futtathat a Batch-fiókok, -kulcsok, alkalmazáscsomagok és kvóták kezeléséhez.
Azure-fiókját kétféleképpen hitelesítheti az Azure CLI-ben. A parancsok önálló futtatásához jelentkezzen be interaktívan az Azure CLI-be. Az Azure CLI gyorsítótárazza a hitelesítő adatokat, és ugyanezekkel a hitelesítő adatokkal bejelentkeztetheti Önt a Batch-fiókjába . Ha parancsokat szeretne futtatni egy szkriptből vagy alkalmazásból, jelentkezzen be az Azure CLI-be egy szolgáltatásnévvel.
Ha interaktívan szeretne bejelentkezni az Azure CLI-be, futtassa a következőt az login:
az login
Bejelentkezés a Batch-fiókba
Ezután jelentkezzen be Batch-fiókjába az Azure CLI-ben az az batch-fiók bejelentkezési parancsával. Ez a lépés hozzáférést biztosít a Batch szolgáltatásparancsaihoz. Ezután kezelheti a Batch-erőforrásokat, például készleteket, feladatokat és tevékenységeket.
Batch-fiókját kétféleképpen hitelesítheti az Azure CLI-ben. Az alapértelmezett módszer a hitelesítés Azure AD használatával. A legtöbb esetben ezt a módszert javasoljuk. Egy másik lehetőség a megosztott kulcsos hitelesítés használata.
Ha Azure CLI-szkripteket hoz létre a Batch-parancsok automatizálásához, bármelyik hitelesítési módszert használhatja. Bizonyos esetekben a megosztott kulcsos hitelesítés egyszerűbb lehet, mint egy szolgáltatásnév létrehozása.
Hitelesítés az Azure AD-vel
A Batch-fiókkal való hitelesítés alapértelmezett módja a Azure AD. Amikor interaktívan vagy szolgáltatásnévvel jelentkezik be az Azure CLI-be, ugyanezekkel a gyorsítótárazott hitelesítő adatokkal bejelentkezhet a Batch-fiókjába Azure AD. Ez a hitelesítési módszer azure-beli szerepköralapú hozzáférés-vezérlést (Azure RBAC) is kínál. Az Azure RBAC-ben a felhasználói hozzáférés a hozzárendelt szerepkörtől függ, nem a fiókkulcsoktól. Csak az Azure-szerepköröket kell kezelnie, a fiókkulcsokat nem. Azure AD ezután kezeli a hozzáférést és a hitelesítést.
Ha a Azure AD használatával szeretne bejelentkezni a Batch-fiókjába, futtassa a következőtaz batch login: . Ügyeljen arra, hogy tartalmazza a Batch-fiók nevének (-n) és az erőforráscsoport nevének (-g) kötelező paramétereit.
az batch account login -g <your-resource-group> -n <your-batch-account>
Hitelesítés megosztott kulccsal
Megosztott kulcsos hitelesítést is használhat a Batch-fiókba való bejelentkezéshez. Ez a módszer a fiók hozzáférési kulcsaival hitelesíti az Azure CLI-parancsokat a Batch szolgáltatáshoz.
Ha megosztott kulcsos hitelesítéssel szeretne bejelentkezni a Batch-fiókjába, futtassa az batch login a paraméterrel --shared-key-auth. Ügyeljen arra, hogy tartalmazza a Batch-fiók nevének (-n) és az erőforráscsoport nevének (-g) kötelező paramétereit.
az batch account login -g <your-resource-group> -n <your-batch-account> --shared-key-auth
Batch-parancsok megismerés
Az Azure CLI referenciadokumentációja felsorolja a Batch összes Azure CLI-parancsát.
Az Azure CLI összes Batch-parancsának listázásához futtassa a következőt az batch -h: .
A gyakori Batch-feladatokhoz több parancssori felületi szkript is létezik. Ezek a példák bemutatják, hogyan használhat számos parancsot a Batchhez az Azure CLI-ben. Megtudhatja, hogyan hozhat létre és kezelhet Batch-fiókokat, készleteket, feladatokat és tevékenységeket.
Batch CLI-bővítményparancsok használata
A Batch CLI-bővítmény használatával kódírás nélkül futtathat Batch-feladatokat. A bővítmény JSON-sablonokat használó parancsokat biztosít készletek, feladatok és feladatok létrehozásához az Azure CLI-vel. A bővítmény parancsokat is biztosít a Batch-fiókhoz társított Azure Storage-fiókhoz való csatlakozáshoz. Ezután feltölthet feladatbemeneti fájlokat, és letöltheti a feladatbemeneti fájlokat.
Erőforrások létrehozása JSON használatával
A Legtöbb Batch-erőforrást csak parancssori paraméterekkel hozhatja létre. Egyes funkciókhoz inkább egy JSON-konfigurációs fájlt kell megadnia. A JSON-fájl tartalmazza az új erőforrás konfigurációs adatait. Egy JSON-fájllal például erőforrásfájlokat kell megadnia az indítási tevékenységhez.
Például egy JSON-fájl használata egy új Batch-készleterőforrás konfigurálásához:
az batch pool <your-batch-pool-configuration>.json
Amikor JSON-fájlt ad meg egy új erőforráshoz, ne használjon más paramétereket a parancsban. A szolgáltatás csak a JSON-fájlt használja az erőforrás konfigurálásához.
A Batch REST API referenciadokumentációja felsorolja az erőforrás létrehozásához szükséges összes JSON-szintaxist.
Az erőforrás létrehozásához szükséges JSON-szintaxissal kapcsolatban az MSDN webhelyén található, Batch – REST API-referencia című dokumentáció nyújt segítséget. Lépjen az erőforrás-művelet referenciaoldalának Példák szakaszára. Ezután keresse meg az Erőforrástípus> hozzáadása <alszakaszt. Például adjon hozzá egy alapszintű feladatot. Használja a példa JSON-kódot sablonként a konfigurációs fájlokhoz.
JSON-fájlra hivatkozó szkriptre példát a Feladatok és tevékenységek futtatása a Batch-csel című témakörben talál.
Batch-erőforrások hatékony lekérdezése
A parancs használatával lekérdezheti Batch-fiókját, és listázhatja az összes erőforrást list . Például a fiók készleteinek és egy feladat tevékenységeinek listázásához:
az batch pool list
az batch task list --job-id <your-job-id>
A Batch-lekérdezés által visszaadott adatok mennyiségének korlátozásához adjon meg egy OData záradékot. Minden szűrés kiszolgálóoldali, így csak a kért adatokat kapja meg. Ezekkel az OData-záradékokkal sávszélességet és időt takaríthat meg a műveletekkel list . További információ: Hatékony lista típusú lekérdezések tervezése Batch-erőforrásokhoz.
| Záradék | Description |
|---|---|
--select-clause [select-clause] |
A tulajdonságok egy részét adja vissza minden entitás esetében. |
--filter-clause [filter-clause] |
Csak olyan entitásokat ad vissza, amelyek megfelelnek a megadott OData-kifejezésnek. |
--expand-clause [expand-clause] |
Az entitásadatokat egy mögöttes REST-hívással szerzi meg. A bővítés záradék jelenleg csak a stats tulajdonságot támogatja. |
A záradékok használatát bemutató példaszkriptért lásd: Feladat és tevékenységek futtatása a Batch használatával.
Hibaelhárítás
Ha segítségre van szüksége bármely Batch-paranccsal kapcsolatban, adja hozzá -h a parancs végéhez. Ne adjon hozzá más beállításokat. Ha például segítségre van szüksége egy Batch-fiók létrehozásához, futtassa a következőt az batch account create -h: .
Részletes parancskimenet visszaadásához adja hozzá -v vagy -vv a parancs végéhez. Ezekkel a kapcsolókkal megjelenítheti a teljes hibakimenetet. A -vv jelölő a tényleges REST-kéréseket és -válaszokat adja vissza.
A parancs kimenetének JSON formátumban való megtekintéséhez adja hozzá --json a parancs végéhez. Például egy pool001 nevű készlet tulajdonságainak megjelenítéséhez futtassa a következőt az batch pool show pool001 --json: . Ezután másolja és módosítsa a kimenetet, hogy Batch-erőforrásokat hozzon létre egy JSON-konfigurációs fájl használatával.
Az Azure CLI általános hibaelhárítása
Az Azure CLI számos rendszerhéj-környezetben futtatható, de kis formátumváltozásokkal. Ha váratlan eredményeket tapasztal az Azure CLI-parancsokkal, tekintse meg az Azure CLI sikeres használatát ismertető témakört.