Batch-erőforrások kezelése az Azure CLI-vel
Az Azure Batch-fiókokat és -erőforrásokat az Azure parancssori felületével (Azure CLI) kezelheti. Vannak parancsok a Batch-erőforrások, például készletek, feladatok és tevékenységek létrehozására és frissítésére. A Batch API-k, a PowerShell-parancsmagok és az Azure Portal számos feladatához létrehozhat szkripteket is.
Futtathatja az Azure CLI-t az Azure Cloud Shellben , vagy telepítheti helyileg az Azure CLI-t. A verziók Windows, Mac és Linux operációs rendszerekhez (OS) érhetők el.
Ez a cikk azt ismerteti, hogyan használhatja az Azure CLI-t 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 a Cloud Shellben.
- 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 az 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.
Az 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 bejelentkezhet a Batch-fiókjába . Parancsok szkriptből vagy alkalmazásból való futtatásához jelentkezzen be az Azure CLI-be egy szolgáltatásnévvel.
Ha interaktív módon szeretne bejelentkezni az Azure CLI-be, futtassa a következőtaz login:
az login
Bejelentkezés Batch-fiókba
Ezután jelentkezzen be Batch-fiókjába az Azure CLI-ben az az batch account login paranccsal. 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 Microsoft Entra ID használatával történő hitelesítés. Ezt a módszert a legtöbb forgatókönyvben 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 egyszerű szolgáltatás létrehozása.
Hitelesítés Microsoft Entra ID-vel
A Batch-fiókkal való hitelesítés alapértelmezett módja a Microsoft Entra-azonosító. Amikor interaktívan vagy szolgáltatásnévvel jelentkezik be az Azure CLI-be, ugyanezekkel a gyorsítótárazott hitelesítő adatokkal bejelentkezhet Batch-fiókjába a Microsoft Entra-azonosítóval. 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 pedig a fiókkulcsoktól. Csak az Azure-szerepköröket kell kezelnie, nem a fiókkulcsokat. A Microsoft Entra ID ezután kezeli a hozzáférést és a hitelesítést.
Ha Microsoft Entra-azonosítóval szeretne bejelentkezni Batch-fiókjába, futtassa a következőt az batch login: . Mindenképpen adja meg 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 kulcsú hitelesítéssel szeretne bejelentkezni Batch-fiókjába, futtassa az batch login a paraméterrel --shared-key-auth. Mindenképpen adja meg 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 parancsot az batch -h.
A gyakori Batch-feladatokhoz több példa parancssori felületi szkript is létezik. Ezek a példák bemutatják, hogyan használhat számos elérhető parancsot a Batchhez az Azure CLI-ben. Megtudhatja, hogyan hozhat létre és kezelhet Batch-fiókokat, készleteket, feladatokat és feladatokat.
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 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öltheti a feladat bemeneti fájljait, és letöltheti a feladat bemeneti fájljait.
Erőforrások létrehozása JSON-nal
A Legtöbb Batch-erőforrást csak parancssori paraméterekkel hozhatja létre. Egyes funkciókhoz ehelyett 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 egy kezdő tevékenységhez.
JSON-fájl használatával például konfigurálhat egy új Batch-készleterőforrást:
az batch pool <your-batch-pool-configuration>.json
Ha 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. Nyissa meg az erőforrás-művelet referenciaoldalának Példák szakaszát. Ezután keresse meg az Erőforrástípus> hozzáadása <című alszakaszt. Például adjon hozzá egy alapfeladatot. 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 a 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 lekérdezések tervezése Batch-erőforrásokhoz.
| Záradék | Leírás |
|---|---|
--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. |
Egy példaszkript, amely bemutatja, hogyan használhatja ezeket a záradékokat, olvassa el a Feladat és tevékenységek futtatása a Batch használatával című témakört.
Hibaelhárítás
Ha segítségre van szüksége a Batch-parancsokkal kapcsolatban, adja hozzá -h a parancs végéhez. Ne adjon hozzá más beállításokat. Ha például segítséget szeretne kérni 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 a pool001 nevű készlet tulajdonságainak megjelenítéséhez futtassa a következőtaz 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 több rendszerhéj-környezetben is futtatható, de kisebb formátumváltozatokkal. Ha az Azure CLI-parancsokkal nem várt eredményeket kap, olvassa el az Azure CLI sikeres használatát ismertető témakört.