az batchai cluster

  • Deprecato
  • Riferimento

Questo gruppo di comandi è deprecato in modo implicito perché il gruppo di comandi 'batchai' è deprecato e verrà rimosso in una versione futura.

Comandi per gestire i cluster.

Comandi

Nome Descrizione Tipo Status
az batchai cluster auto-scale

Impostare i parametri di scalabilità automatica per un cluster.

 Memoria centrale Deprecato
az batchai cluster create

Creare un cluster.

 Memoria centrale Deprecato
az batchai cluster delete

Eliminare un cluster.

 Memoria centrale Deprecato
az batchai cluster file

Comandi da usare con i file generati dall'attività di installazione del nodo.

 Memoria centrale Deprecato
az batchai cluster file list

Elencare i file generati dall'attività di configurazione del nodo del cluster.

 Memoria centrale Deprecato
az batchai cluster list

Elencare i cluster.

 Memoria centrale Deprecato
az batchai cluster node

Comandi da usare con i nodi del cluster.

 Memoria centrale Deprecato
az batchai cluster node exec

Esegue una riga di comando nel nodo di un cluster con l'inoltro di porte facoltative.

 Memoria centrale Deprecato
az batchai cluster node list

Elencare le informazioni di accesso remoto per i nodi del cluster.

 Memoria centrale Deprecato
az batchai cluster resize

Ridimensionare un cluster.

 Memoria centrale Deprecato
az batchai cluster show

Visualizzare informazioni su un cluster.

 Memoria centrale Deprecato

az batchai cluster auto-scale

Modifica
Deprecato

Questo comando è deprecato in modo implicito perché il gruppo di comandi 'batchai' è deprecato e verrà rimosso in una versione futura.

Impostare i parametri di scalabilità automatica per un cluster.

az batchai cluster auto-scale --max
                              --min
                              [--ids]
                              [--name]
                              [--resource-group]
                              [--subscription]
                              [--workspace]

Esempio

Impostare un cluster per la scalabilità automatica tra 0 e 10 nodi in base al numero di processi in coda ed in esecuzione.

az batchai cluster auto-scale -g MyResourceGroup -w MyWorkspace -n MyCluster --min 0 --max 10

Parametri necessari

--max

Numero massimo di nodi.

--min

Numero minimo di nodi.

Parametri facoltativi

--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

--name -n

Nome del cluster.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--workspace -w

Nome dell'area di lavoro.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az batchai cluster create

Modifica
Deprecato

Questo comando è deprecato in modo implicito perché il gruppo di comandi 'batchai' è deprecato e verrà rimosso in una versione futura.

Creare un cluster.

az batchai cluster create --name
                          --resource-group
                          --workspace
                          [--afs-mount-path]
                          [--afs-name]
                          [--bfs-mount-path]
                          [--bfs-name]
                          [--config-file]
                          [--custom-image]
                          [--generate-ssh-keys]
                          [--image]
                          [--max]
                          [--min]
                          [--nfs]
                          [--nfs-mount-path]
                          [--password]
                          [--setup-task]
                          [--setup-task-output]
                          [--ssh-key]
                          [--storage-account-key]
                          [--storage-account-name]
                          [--subnet]
                          [--target]
                          [--use-auto-storage]
                          [--user-name]
                          [--vm-priority {dedicated, lowpriority}]
                          [--vm-size]

Esempio

Creare un cluster GPU a nodo singolo con l'immagine predefinita e l'account di archiviazione automatica.

az batchai cluster create -g MyResourceGroup -w MyWorkspace -n MyCluster \
    -s Standard_NC6 -t 1 --use-auto-storage --generate-ssh-keys

Creare un cluster con un comando di installazione che installa unzip in ogni nodo, l'output del comando verrà archiviato nella condivisione file di Azure dell'account di archiviazione automatica.

az batchai cluster create -g MyResourceGroup -w MyWorkspace -n MyCluster \
    --use-auto-storage \
    -s Standard_NC6 -t 1 -k id_rsa.pub \
    --setup-task 'apt update; apt install unzip -y' \
    --setup-task-output '$AZ_BATCHAI_MOUNT_ROOT/autoafs'

Creare un cluster che fornisca tutti i parametri manualmente.

az batchai cluster create -g MyResourceGroup -w MyWorkspace -n MyCluster \
    -i UbuntuLTS -s Standard_NC6 --vm-priority lowpriority \
    --min 0 --target 1 --max 10 \
    --storage-account-name MyStorageAccount \
    --nfs MyNfsToMount --afs-name MyAzureFileShareToMount \
    --bfs-name MyBlobContainerNameToMount \
    -u AdminUserName -k id_rsa.pub -p ImpossibleToGuessPassword

Creare un cluster usando un file di configurazione.

az batchai cluster create -g MyResourceGroup -w MyWorkspace -n MyCluster -f cluster.json

Parametri necessari

--name -n

Nome del cluster.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--workspace -w

Nome dell'area di lavoro.

Parametri facoltativi

--afs-mount-path

Percorso di montaggio relativo per la condivisione file di Azure. La condivisione file sarà disponibile nella cartella $AZ_BATCHAI_MOUNT_ROOT/<relative_mount_path> .

Valore predefinito: afs
--afs-name

Nome della condivisione file di Azure da montare in ogni nodo del cluster. Deve essere usato insieme a --storage-account-name. È possibile montare più condivisioni usando il file di configurazione (vedere l'opzione --config-file).

--bfs-mount-path

Percorso di montaggio relativo per Archiviazione di Azure contenitore. Il contenitore sarà disponibile nella cartella $AZ_BATCHAI_MOUNT_ROOT/<relative_mount_path> .

Valore predefinito: bfs
--bfs-name

Nome del contenitore Archiviazione di Azure da montare in ogni nodo del cluster. Deve essere usato insieme a --storage-account-name. È possibile montare più contenitori usando il file di configurazione (vedere l'opzione --config-file).

--config-file -f

Percorso di un file JSON contenente i parametri di creazione del cluster (rappresentazione json di azure.mgmt.batchai.models.ClusterCreateParameters).

--custom-image

ID ARM di un'immagine di macchina virtuale da usare per la creazione di nodi. Si noti che è necessario specificare --image contenente informazioni sull'immagine di base usata per la creazione dell'immagine.

--generate-ssh-keys

Generare file di chiave pubblica e privata SSH nella directory ~/.ssh (se mancante).

--image -i

Immagine del sistema operativo per i nodi del cluster. Il valore può contenere un alias (UbuntuLTS, UbuntuDSVM) o specificare i dettagli dell'immagine nel formato "publisher:offer:sku:version". Se la configurazione dell'immagine non viene fornita tramite la riga di comando o il file di configurazione, Batch per intelligenza artificiale sceglierà l'immagine del sistema operativo predefinita.

--max

Numero massimo di nodi per il cluster di scalabilità automatica.

--min

Numero minimo di nodi per il cluster di scalabilità automatica.

--nfs

Nome o ID ARM di un file server da montare in ogni nodo del cluster. È necessario specificare l'ID ARM completo se il file server appartiene a un'area di lavoro diversa. È possibile montare più NFS usando il file di configurazione (vedere l'opzione --config-file).

--nfs-mount-path

Percorso di montaggio relativo per NFS. NFS sarà disponibile nella cartella $AZ_BATCHAI_MOUNT_ROOT/<relative_mount_path> .

Valore predefinito: nfs
--password -p

Password facoltativa per l'account utente amministratore da creare in ogni nodo di calcolo.

--setup-task

Riga di comando che deve essere eseguita in ogni nodo di calcolo quando viene allocata o riavviata. L'attività viene eseguita in una sottoshell bash nell'account radice.

--setup-task-output

Percorso della directory in cui archiviare i log dell'attività di installazione. Si noti che Batch per intelligenza artificiale creerà diverse directory helper in questo percorso. Le directory create vengono segnalate come stdOutErrPathSuffix dal comando 'az cluster show'.

--ssh-key -k

Valore o percorso della chiave pubblica SSH facoltativo. Se ommited e nessuna password specificata, verrà usata la chiave SSH predefinita (~/.ssh/id_rsa.pub).

--storage-account-key

Archiviazione chiave dell'account. Obbligatorio se l'account di archiviazione appartiene a una sottoscrizione diversa. Può essere specificato usando AZURE_BATCHAI_STORAGE_KEY variabile di ambiente.

--storage-account-name

Archiviazione nome dell'account per condivisioni file di Azure e/o contenitori Archiviazione di Azure da montare in ogni nodo del cluster. Può essere specificato usando AZURE_BATCHAI_STORAGE_ACCOUNT variabile di ambiente.

--subnet

ID ARM di una subnet di rete virtuale in cui inserire il cluster.

--target -t

Numero di nodi che devono essere allocati immediatamente dopo la creazione del cluster. Se il cluster è in modalità di scalabilità automatica, BatchAI può modificare il numero di nodi in un secondo momento in base al numero di processi in esecuzione e in coda.

--use-auto-storage

Se specificato, il comando creerà un account di archiviazione in un gruppo di risorse nuovo o esistente denominato "batchaiautostorage". Verrà anche creata una condivisione file di Azure con nome "batchaishare", contenitore BLOB di Azure con nome "batchaicontainer". La condivisione file e il contenitore BLOB verranno montati in ogni nodo del cluster in $AZ_BATCHAI_MOUNT_ROOT/autoafs e $AZ_BATCHAI_MOUNT_ROOT/autobfs. Se il gruppo di risorse esiste già e contiene un account di archiviazione approapriato appartenente alla stessa area del cluster, questo comando riutilizza l'account di archiviazione esistente.

Valore predefinito: False
--user-name -u

Nome dell'account utente amministratore da creare in ogni nodo di calcolo. Se il valore non viene specificato e non viene specificata alcuna configurazione utente nel file di configurazione, verrà usato il nome dell'utente corrente.

--vm-priority

Priorità della macchina virtuale.

Valori accettati: dedicated, lowpriority
--vm-size -s

Dimensioni della macchina virtuale per i nodi del cluster ,ad esempio Standard_NC6 per 1 nodo GPU.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az batchai cluster delete

Modifica
Deprecato

Questo comando è deprecato in modo implicito perché il gruppo di comandi 'batchai' è deprecato e verrà rimosso in una versione futura.

Eliminare un cluster.

az batchai cluster delete [--ids]
                          [--name]
                          [--no-wait]
                          [--resource-group]
                          [--subscription]
                          [--workspace]
                          [--yes]

Esempio

Eliminare un cluster e attendere il completamento dell'eliminazione.

az batchai cluster delete -g MyResourceGroup -w MyWorkspace -n MyCluster

Inviare un comando di eliminazione per un cluster e non attendere il completamento dell'eliminazione.

az batchai cluster delete -g MyResourceGroup -w MyWorkspace -n MyCluster --no-wait

Eliminare il cluster senza chiedere conferma (per scenari non interattivi).

az batchai cluster delete -g MyResourceGroup -w MyWorkspace -n MyCluster -y

Parametri facoltativi

--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

--name -n

Nome del cluster.

--no-wait

Indica che non è necessario attendere il termine dell'operazione a esecuzione prolungata.

Valore predefinito: False
--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--workspace -w

Nome dell'area di lavoro.

--yes -y

Indica che non è richiesta la conferma.

Valore predefinito: False
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az batchai cluster list

Modifica
Deprecato

Questo comando è deprecato in modo implicito perché il gruppo di comandi 'batchai' è deprecato e verrà rimosso in una versione futura.

Elencare i cluster.

az batchai cluster list --resource-group
                        --workspace

Esempio

Elencare tutti i cluster in un'area di lavoro.

az batchai cluster list -g MyResourceGroup -w MyWorkspace -o table

Parametri necessari

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--workspace -w

Nome dell'area di lavoro.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az batchai cluster resize

Modifica
Deprecato

Questo comando è deprecato in modo implicito perché il gruppo di comandi 'batchai' è deprecato e verrà rimosso in una versione futura.

Ridimensionare un cluster.

az batchai cluster resize --target
                          [--ids]
                          [--name]
                          [--resource-group]
                          [--subscription]
                          [--workspace]

Esempio

Ridimensionare un cluster a zero per interrompere il pagamento.

az batchai cluster resize -g MyResourceGroup -w MyWorkspace -n MyCluster -t 0

Ridimensionare un cluster per avere 10 nodi.

az batchai cluster resize -g MyResourceGroup -w MyWorkspace -n MyCluster -t 10

Parametri necessari

--target -t

Numero di nodi di calcolo di destinazione.

Parametri facoltativi

--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

--name -n

Nome del cluster.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--workspace -w

Nome dell'area di lavoro.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az batchai cluster show

Modifica
Deprecato

Questo comando è deprecato in modo implicito perché il gruppo di comandi 'batchai' è deprecato e verrà rimosso in una versione futura.

Visualizzare informazioni su un cluster.

az batchai cluster show [--ids]
                        [--name]
                        [--resource-group]
                        [--subscription]
                        [--workspace]

Esempio

Visualizzare informazioni complete su un cluster.

az batchai cluster show -g MyResourceGroup -w MyWorkspace -n MyCluster

Visualizzare il riepilogo del cluster.

az batchai cluster show -g MyResourceGroup -w MyWorkspace -n MyCluster -o table

Parametri facoltativi

--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

--name -n

Nome del cluster.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--workspace -w

Nome dell'area di lavoro.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.