Gestire le risorse di Batch con l'interfaccia della riga di comando di Azure
È possibile gestire gli account e le risorse di Azure Batch usando l'interfaccia della riga di comando di Azure interfaccia della riga di comando di Azure. Sono disponibili comandi per la creazione e l'aggiornamento di risorse batch, ad esempio pool, processi e attività. È anche possibile creare script per molte delle stesse attività eseguite tramite LE API Batch, i cmdlet di PowerShell e le portale di Azure.
È possibile eseguire l'interfaccia della riga di comando di Azure in Azure Cloud Shell o installare l'interfaccia della riga di comando di Azure in locale. Le versioni sono disponibili per i sistemi operativi Windows, Mac e Linux.
Questo articolo illustra come usare l'interfaccia della riga di comando di Azure con account e risorse batch.
Configurare l'interfaccia della riga di comando di Azure
Scegliere come configurare l'interfaccia della riga di comando di Azure:
- Eseguire l'interfaccia della riga di comando di Azure in Cloud Shell.
- Installare l'interfaccia della riga di comando di Azure in locale.
Se non si ha familiarità con l'uso dell'interfaccia della riga di comando di Azure, vedere Introduzione all'interfaccia della riga di comando di Azure prima di continuare.
Se in precedenza è stata installata l'interfaccia della riga di comando di Azure in locale, assicurarsi di aggiornare l'installazione alla versione più recente.
Eseguire l'autenticazione con l'interfaccia della riga di comando di Azure
Per usare l'interfaccia della riga di comando di Azure con Batch, accedere prima all'account Azure e quindi accedere all'account Batch.
Accedere all'account Azure
Per usare l'interfaccia della riga di comando di Azure, accedere prima all'account Azure. Questo passaggio consente di accedere ai comandi di Azure Resource Manager, inclusi i comandi del servizio Gestione Batch. È quindi possibile eseguire comandi per gestire account Batch, chiavi, pacchetti dell'applicazione e quote.
È possibile autenticare l'account Azure nell'interfaccia della riga di comando di Azure) in due modi. Per eseguire i comandi manualmente, accedere all'interfaccia della riga di comando di Azure in modo interattivo. L'interfaccia della riga di comando di Azure memorizza nella cache le credenziali e può usare le stesse credenziali per accedere all'account Batch dopo. Per eseguire comandi da uno script o da un'applicazione, accedere all'interfaccia della riga di comando di Azure con un'entità servizio.
Per accedere all'interfaccia della riga di comando di Azure in modo interattivo, eseguire az login:
az login
Accedere all'account Batch
Accedere quindi all'account Batch nell'interfaccia della riga di comando di Azure usando il comando az batch account login . Questo passaggio consente di accedere ai comandi del servizio Batch. È quindi possibile gestire risorse batch come pool, processi e attività.
È possibile autenticare l'account Batch nell'interfaccia della riga di comando di Azure in due modi. Il metodo predefinito consiste nell'eseguire l'autenticazione usando Microsoft Entra ID. È consigliabile usare questo metodo nella maggior parte degli scenari. Un'altra opzione consiste nell'usare l'autenticazione con chiave condivisa.
Se si creano script dell'interfaccia della riga di comando di Azure per automatizzare i comandi di Batch, è possibile usare uno dei due metodi di autenticazione. In alcuni scenari, l'autenticazione con chiave condivisa potrebbe essere più semplice rispetto alla creazione di un'entità servizio.
Eseguire l'autenticazione con ID Microsoft Entra
Il metodo predefinito per l'autenticazione con l'account Batch è tramite Microsoft Entra ID. Quando si accede all'interfaccia della riga di comando di Azure in modo interattivo o con un'entità servizio, è possibile usare le stesse credenziali memorizzate nella cache per accedere all'account Batch con Microsoft Entra ID. Questo metodo di autenticazione offre anche il controllo degli accessi in base al ruolo di Azure. Con il controllo degli accessi in base al ruolo di Azure, l'accesso utente dipende dal ruolo assegnato, non dalle chiavi dell'account. È sufficiente gestire i ruoli di Azure, non le chiavi dell'account. Microsoft Entra ID gestisce quindi l'accesso e l'autenticazione.
Per accedere all'account Batch con Microsoft Entra ID, eseguire az batch login. Assicurarsi di includere i parametri necessari per il nome dell'account Batch (-n) e il nome del gruppo di risorse (-g).
az batch account login -g <your-resource-group> -n <your-batch-account>
Eseguire l'autenticazione con chiave condivisa
È anche possibile usare l'autenticazione con chiave condivisa per accedere all'account Batch. Questo metodo usa le chiavi di accesso dell'account per autenticare i comandi dell'interfaccia della riga di comando di Azure per il servizio Batch.
Per accedere all'account Batch con l'autenticazione con chiave condivisa, eseguire az batch login con il parametro --shared-key-auth. Assicurarsi di includere i parametri necessari per il nome dell'account Batch (-n) e il nome del gruppo di risorse (-g).
az batch account login -g <your-resource-group> -n <your-batch-account> --shared-key-auth
Informazioni sui comandi di Batch
La documentazione di riferimento dell'interfaccia della riga di comando di Azure elenca tutti i comandi dell'interfaccia della riga di comando di Azure per Batch.
Per elencare tutti i comandi di Batch nell'interfaccia della riga di comando di Azure, eseguire az batch -h.
Esistono più script dell'interfaccia della riga di comando di esempio per le attività batch comuni. Questi esempi illustrano come usare molti comandi disponibili per Batch nell'interfaccia della riga di comando di Azure. È possibile imparare a creare e gestire account, pool, processi e attività di Batch.
Usare i comandi di estensione dell'interfaccia della riga di comando di Batch
È possibile usare l'estensione dell'interfaccia della riga di comando di Batch per eseguire processi Batch senza scrivere codice. L'estensione fornisce comandi per l'uso di modelli JSON per la creazione di pool, processi e attività con l'interfaccia della riga di comando di Azure. L'estensione fornisce anche comandi per connettersi a un account Archiviazione di Azure collegato all'account Batch. È quindi possibile caricare i file di input del processo e scaricare i file di input del processo.
Creare risorse con JSON
È possibile creare la maggior parte delle risorse batch usando solo i parametri della riga di comando. Alcune funzionalità richiedono invece di specificare un file di configurazione JSON. Il file JSON contiene i dettagli di configurazione per la nuova risorsa. Ad esempio, è necessario usare un file JSON per specificare i file di risorse per un'attività di avvio.
Ad esempio, per usare un file JSON per configurare una nuova risorsa del pool di Batch:
az batch pool <your-batch-pool-configuration>.json
Quando si specifica un file JSON per una nuova risorsa, non usare altri parametri nel comando. Il servizio usa solo il file JSON per configurare la risorsa.
La documentazione di riferimento dell'API REST batch elenca qualsiasi sintassi JSON necessaria per creare una risorsa.
Per la sintassi JSON necessaria per creare una risorsa, vedere la documentazione di riferimento sull'API REST di Batch. Passare alla sezione Esempi nella pagina di riferimento dell'operazione di risorsa. Trovare quindi la sottosezione intitolata Aggiungi <tipo di> risorsa. Ad esempio, Aggiungere un'attività di base. Usare il codice JSON di esempio come modelli per i file di configurazione.
Per uno script di esempio che specifica un file JSON, vedere Eseguire processi in Azure Batch con l'interfaccia della riga di comando di Azure.
Eseguire query su risorse Batch in modo efficiente
È possibile eseguire query sull'account Batch ed elencare tutte le risorse usando il list comando . Ad esempio, per elencare i pool nell'account e nelle attività in un processo:
az batch pool list
az batch task list --job-id <your-job-id>
Per limitare la quantità di dati restituiti dalla query batch, specificare una clausola OData. Tutti i filtri si verificano sul lato server, quindi si ricevono solo i dati richiesti. Usare queste clausole OData per risparmiare larghezza di banda e tempo con list le operazioni. Per altre informazioni, vedere Progettare query di elenco efficienti per le risorse batch.
| Clausola | Descrizione |
|---|---|
--select-clause [select-clause] |
Restituisce un subset di proprietà per ogni entità. |
--filter-clause [filter-clause] |
Restituisce solo le entità che corrispondono all'espressione OData specificata. |
--expand-clause [expand-clause] |
Ottiene le informazioni sull'entità in una singola chiamata REST sottostante. La clausola expand supporta attualmente solo la proprietà stats. |
Per uno script di esempio che illustra come usare queste clausole, vedere Eseguire un processo e attività con Batch.
Risoluzione dei problemi
Per ottenere assistenza con qualsiasi comando di Batch, aggiungere -h alla fine del comando. Non aggiungere altre opzioni. Ad esempio, per ottenere informazioni sulla creazione di un account Batch, eseguire az batch account create -h.
Per restituire l'output dettagliato del comando, aggiungere -v o -vv alla fine del comando. Usare queste opzioni per visualizzare l'output completo degli errori. Il -vv flag restituisce le richieste e le risposte REST effettive.
Per visualizzare l'output del comando in formato JSON, aggiungere --json alla fine del comando. Ad esempio, per visualizzare le proprietà di un pool denominato pool001, eseguire az batch pool show pool001 --json. Copiare e modificare quindi l'output per creare risorse batch usando un file di configurazione JSON.
Risoluzione dei problemi generali dell'interfaccia della riga di comando di Azure
L'interfaccia della riga di comando di Azure può essere eseguita in diversi ambienti della shell, ma con lievi variazioni di formato. Se si hanno risultati imprevisti con i comandi dell'interfaccia della riga di comando di Azure, vedere Come usare correttamente l'interfaccia della riga di comando di Azure.