Správa prostředků služby Batch pomocí Azure CLI
Účty a prostředky Azure Batch můžete spravovat pomocí rozhraní příkazového řádku Azure (Azure CLI). Existují příkazy pro vytváření a aktualizaci prostředků služby Batch, jako jsou fondy, úlohy a úkoly. Můžete také vytvářet skripty pro mnoho stejných úloh, které provedete prostřednictvím rozhraní API služby Batch, rutin PowerShellu a webu Azure Portal.
Azure CLI můžete spustit v Azure Cloud Shellu nebo nainstalovat Azure CLI místně. Verze jsou k dispozici pro operační systémy Windows, Mac a Linux.
Tento článek vysvětluje, jak používat Azure CLI s účty a prostředky Batch.
Nastavení Azure CLI
Zvolte, jak chcete nastavit Azure CLI:
- Spusťte Azure CLI v Cloud Shellu.
- Nainstalujte Azure CLI místně.
- Instalace Azure CLI ve Windows
- Instalace Azure CLI v systému macOS
- Nainstalujte Azure CLI v Linuxu pro více distribucí Linuxu.
Pokud s používáním Azure CLI teprve začínáte, přečtěte si téma Začínáme s Azure CLI , než budete pokračovat.
Pokud jste dříve nainstalovali Azure CLI místně, nezapomeňte instalaci aktualizovat na nejnovější verzi.
Ověřování pomocí Azure CLI
Pokud chcete použít Azure CLI se službou Batch, nejprve se přihlaste ke svému účtu Azure a pak se přihlaste ke svému účtu Batch.
Přihlášení k účtu Azure
Pokud chcete použít Azure CLI, nejprve se přihlaste ke svému účtu Azure. Tento krok poskytuje přístup k příkazům Azure Resource Manageru, které zahrnují příkazy služby Batch Management. Potom můžete spouštět příkazy pro správu účtů Batch, klíčů, balíčků aplikací a kvót.
Účet Azure můžete ověřit v Azure CLI dvěma způsoby. Pokud chcete příkazy spouštět sami, přihlaste se interaktivně k Azure CLI. Azure CLI ukládá vaše přihlašovací údaje do mezipaměti a může použít stejné přihlašovací údaje k přihlášení k účtu Batch po. Pokud chcete spouštět příkazy ze skriptu nebo aplikace, přihlaste se k Azure CLI pomocí instančního objektu.
Pokud se chcete interaktivně přihlásit k Azure CLI, spusťte az loginpříkaz :
az login
Přihlášení k účtu Batch
Dále se přihlaste ke svému účtu Batch v Azure CLI pomocí příkazu az batch account login . Tento krok vám poskytne přístup k příkazům služby Batch. Potom můžete spravovat prostředky služby Batch, jako jsou fondy, úlohy a úkoly.
Účet Batch můžete ověřit v Azure CLI dvěma způsoby. Výchozí metodou je ověření pomocí ID Microsoft Entra. Tuto metodu doporučujeme používat ve většině scénářů. Další možností je použít ověřování pomocí sdíleného klíče.
Pokud vytváříte skripty Azure CLI pro automatizaci příkazů Batch, můžete použít některou metodu ověřování. V některých scénářích může být ověřování pomocí sdíleného klíče jednodušší než vytvoření instančního objektu.
Ověřování pomocí Microsoft Entra ID
Výchozí metoda ověřování pomocí účtu Batch je prostřednictvím ID Microsoft Entra. Když se přihlásíte k Azure CLI interaktivně nebo pomocí instančního objektu, můžete se pomocí stejných přihlašovacích údajů uložených v mezipaměti přihlásit ke svému účtu Batch pomocí ID Microsoft Entra. Tato metoda ověřování také nabízí řízení přístupu na základě role v Azure (Azure RBAC). S Azure RBAC závisí přístup uživatelů na přiřazené roli, ne na klíčích účtu. Stačí spravovat jenom role Azure, ne klíče účtu. ID Microsoft Entra pak zpracovává přístup a ověřování.
Pokud se chcete přihlásit ke svému účtu Batch pomocí ID Microsoft Entra, spusťte az batch loginpříkaz . Nezapomeňte zahrnout požadované parametry pro název vašeho účtu Batch (-n) a název vaší skupiny prostředků (-g).
az batch account login -g <your-resource-group> -n <your-batch-account>
Ověřování pomocí sdíleného klíče
K přihlášení k účtu Batch můžete použít také ověřování pomocí sdíleného klíče. Tato metoda používá přístupové klíče k účtu k ověřování příkazů Azure CLI pro službu Batch.
Pokud se chcete přihlásit ke svému účtu Batch pomocí ověřování pomocí sdíleného klíče, spusťte az batch login ho s parametrem --shared-key-auth. Nezapomeňte zahrnout požadované parametry pro název vašeho účtu Batch (-n) a název vaší skupiny prostředků (-g).
az batch account login -g <your-resource-group> -n <your-batch-account> --shared-key-auth
Příkazy Služby Batch
Referenční dokumentace k Azure CLI obsahuje seznam všech příkazů Azure CLI pro Batch.
Pokud chcete vypsat všechny příkazy Batch v Azure CLI, spusťte az batch -hpříkaz .
Pro běžné úlohy batch existuje několik ukázkových skriptů rozhraní příkazového řádku. Tyto příklady ukazují, jak používat mnoho dostupných příkazů pro Batch v Azure CLI. Dozvíte se, jak vytvářet a spravovat účty Batch, fondy, úlohy a úkoly.
Použití příkazů rozšíření Rozhraní příkazového řádku služby Batch
Pomocí rozšíření Batch CLI můžete spouštět úlohy Batch bez psaní kódu. Rozšíření poskytuje příkazy pro vytváření fondů, úloh a úloh pomocí Azure CLI pomocí šablon JSON. Rozšíření také poskytuje příkazy pro připojení k účtu Azure Storage propojenému s vaším účtem Batch. Pak můžete nahrát vstupní soubory úlohy a stáhnout vstupní soubory úlohy.
Vytváření prostředků pomocí JSON
Většinu prostředků služby Batch můžete vytvářet pouze pomocí parametrů příkazového řádku. Některé funkce vyžadují, abyste místo toho zadali konfigurační soubor JSON. Soubor JSON obsahuje podrobnosti o konfiguraci vašeho nového prostředku. K zadání souborů prostředků pro spouštěcí úlohu musíte například použít soubor JSON.
Pokud chcete například použít soubor JSON ke konfiguraci nového prostředku fondu Batch:
az batch pool <your-batch-pool-configuration>.json
Když pro nový prostředek zadáte soubor JSON, nepoužívejte v příkazu jiné parametry. Služba ke konfiguraci prostředku používá pouze soubor JSON.
Referenční dokumentace k rozhraní REST API služby Batch obsahuje všechny syntaxe JSON potřebné k vytvoření prostředku.
Pokud si chcete prohlédnout syntaxi souboru JSON vyžadovanou k vytvoření prostředku, prostudujte si dokumentaci Reference k rozhraní REST API služby Batch. Přejděte do části Příklady na referenční stránce operace prostředku. Pak vyhledejte pododdíl s názvem Přidat <typ> prostředku. Můžete například přidat základní úkol. Jako šablony konfiguračních souborů použijte ukázkový kód JSON.
Ukázkový skript, který určuje soubor JSON, najdete v článku Spuštění úlohy a úkolů pomocí služby Batch.
Efektivní dotazování prostředků služby Batch
Pomocí příkazu můžete zadat dotaz na svůj účet Batch a zobrazit seznam všech prostředků list . Pokud chcete například zobrazit seznam fondů v účtu a úkolech v úloze:
az batch pool list
az batch task list --job-id <your-job-id>
Pokud chcete omezit množství dat, která dotaz Batch vrátí, zadejte klauzuli OData. Veškeré filtrování probíhá na straně serveru, takže obdržíte jenom data, která požadujete. Pomocí těchto klauzulí OData můžete ušetřit šířku pásma a čas s operacemi list . Další informace naleznete v tématu Návrh efektivních seznamů dotazů pro prostředky batch.
| Klauzule | Popis |
|---|---|
--select-clause [select-clause] |
Vrátí podmnožinu vlastností pro každou entitu. |
--filter-clause [filter-clause] |
Vrátí pouze ty entity, které odpovídají zadanému výrazu OData. |
--expand-clause [expand-clause] |
Získá informace o entitách v rámci jediného základního volání REST. Klauzule expand v současné době podporuje pouze vlastnost stats. |
Ukázkový skript, který ukazuje, jak tyto klauzule používat, najdete v tématu Spuštění úlohy a úkolů se službou Batch.
Řešení problému
Pokud chcete získat nápovědu k libovolnému příkazu Batch, přidejte -h na konec příkazu. Nepřidávejte další možnosti. Pokud například chcete získat pomoc s vytvořením účtu Batch, spusťte az batch account create -hpříkaz .
Pokud chcete vrátit podrobný výstup příkazu, přidejte -v nebo -vv na konec příkazu. Pomocí těchto přepínačů zobrazte úplný výstup chyby. Příznak -vv vrátí skutečné požadavky a odpovědi REST.
Pokud chcete zobrazit výstup příkazu ve formátu JSON, přidejte --json na konec příkazu. Pokud chcete například zobrazit vlastnosti fondu s názvem pool001, spusťte az batch pool show pool001 --jsonpříkaz . Potom zkopírujte a upravte výstup a vytvořte prostředky Batch pomocí konfiguračního souboru JSON.
Obecné řešení potíží s Azure CLI
Azure CLI může běžet v několika prostředích prostředí, ale s mírnými variacemi formátu. Pokud máte neočekávané výsledky s příkazy Azure CLI, přečtěte si, jak úspěšně používat Azure CLI.