Share via

az batchai cluster

  • Preterido
  • Referência

Este grupo de comandos foi implicitamente preterido porque o grupo de comandos 'batchai' foi preterido e será removido numa versão futura.

Comandos para gerenciar clusters.

Comandos

Name Description Tipo Estado
az batchai cluster auto-scale

Defina parâmetros de dimensionamento automático para um cluster.

 Principal Preterido
az batchai cluster create

Crie um cluster.

 Principal Preterido
az batchai cluster delete

Excluir um cluster.

 Principal Preterido
az batchai cluster file

Comandos para trabalhar com arquivos gerados pela tarefa de configuração do nó.

 Principal Preterido
az batchai cluster file list

Listar arquivos gerados pela tarefa de configuração do nó do cluster.

 Principal Preterido
az batchai cluster list

Listar clusters.

 Principal Preterido
az batchai cluster node

Comandos para trabalhar com nós de cluster.

 Principal Preterido
az batchai cluster node exec

Executa uma linha de comando no nó de um cluster com encaminhamento de portas opcionais.

 Principal Preterido
az batchai cluster node list

Liste as informações de login remoto para os nós do cluster.

 Principal Preterido
az batchai cluster resize

Redimensione um cluster.

 Principal Preterido
az batchai cluster show

Mostrar informações sobre um cluster.

 Principal Preterido

az batchai cluster auto-scale

Editar
Preterido

Este comando foi implicitamente preterido porque o grupo de comandos 'batchai' foi preterido e será removido em uma versão futura.

Defina parâmetros de dimensionamento automático para um cluster.

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

Exemplos

Faça um cluster para dimensionar automaticamente entre 0 e 10 nós, dependendo do número de trabalhos enfileirados e em execução.

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

Parâmetros Obrigatórios

--max

Número máximo de nós.

--min

Número mínimo de nós.

Parâmetros Opcionais

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--name -n

Nome do cluster.

--resource-group -g

o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--workspace -w

Nome do espaço de trabalho.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az batchai cluster create

Editar
Preterido

Este comando foi implicitamente preterido porque o grupo de comandos 'batchai' foi preterido e será removido em uma versão futura.

Crie um 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]

Exemplos

Crie um cluster de GPU de nó único com imagem padrão e conta de armazenamento automático.

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

Crie um cluster com um comando setup que instala o unzip em cada nó, a saída do comando será armazenada na conta de armazenamento automático Azure File Share.

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'

Crie um cluster que forneça todos os parâmetros 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

Crie um cluster usando um arquivo de configuração.

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

Parâmetros Obrigatórios

--name -n

Nome do cluster.

--resource-group -g

o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--workspace -w

Nome do espaço de trabalho.

Parâmetros Opcionais

--afs-mount-path

Caminho de montagem relativo para o compartilhamento de arquivos do Azure. O compartilhamento de arquivos estará disponível na pasta $AZ_BATCHAI_MOUNT_ROOT/<>relative_mount_path.

valor predefinido: afs
--afs-name

Nome do Compartilhamento de Arquivos do Azure a ser montado em cada nó de cluster. Deve ser usado em conjunto com --storage-account-name. Vários compartilhamentos podem ser montados usando o arquivo de configuração (consulte a opção --config-file).

--bfs-mount-path

Caminho de montagem relativo para o contêiner de Armazenamento do Azure. O contêiner estará disponível na pasta $AZ_BATCHAI_MOUNT_ROOT/<>relative_mount_path.

valor predefinido: bfs
--bfs-name

Nome do contêiner de Armazenamento do Azure a ser montado em cada nó de cluster. Deve ser usado em conjunto com --storage-account-name. Vários contêineres podem ser montados usando o arquivo de configuração (consulte a opção --config-file).

--config-file -f

Um caminho para um arquivo json contendo parâmetros de criação de cluster (representação json de azure.mgmt.batchai.models.ClusterCreateParameters).

--custom-image

ID ARM de uma imagem de máquina virtual a ser usada para a criação de nós. Nota, você precisa fornecer --image contendo informações sobre a imagem base usada para esta criação de imagem.

--generate-ssh-keys

Gere arquivos de chave pública e privada SSH no diretório ~/.ssh (se faltar).

--image -i

Imagem do sistema operacional para nós de cluster. O valor pode conter um alias (UbuntuLTS, UbuntuDSVM) ou especificar detalhes da imagem no formato "publisher:offer:sku:version". Se a configuração da imagem não for fornecida via linha de comando ou arquivo de configuração, o Batch AI escolherá a imagem padrão do sistema operacional.

--max

Os nós máximos contam para o cluster de dimensionamento automático.

--min

Os nós mínimos contam para o cluster de dimensionamento automático.

--nfs

Nome ou ID ARM de um servidor de arquivos a ser montado em cada nó do cluster. Você precisará fornecer ID ARM completo se o servidor de arquivos pertencer a um espaço de trabalho diferente. Vários NFS podem ser montados usando o arquivo de configuração (consulte a opção --config-file).

--nfs-mount-path

Caminho de montagem relativo para NFS. O NFS estará disponível na pasta $AZ_BATCHAI_MOUNT_ROOT/<>relative_mount_path.

valor predefinido: nfs
--password -p

Senha opcional para a conta de usuário administrador a ser criada em cada nó de computação.

--setup-task

Uma linha de comando que deve ser executada em cada nó de computação quando ele é alocado ou reinicializado. A tarefa é executada em um subshell bash em conta root.

--setup-task-output

Caminho do diretório para armazenar onde os logs da tarefa de instalação. Observe que o Batch AI criará vários diretórios auxiliares sob esse caminho. Os diretórios criados são relatados como stdOutErrPathSuffix pelo comando 'az cluster show'.

--ssh-key -k

Valor ou caminho de chave pública SSH opcional. Se ommited e nenhuma senha especificada, a chave SSH padrão (~/.ssh/id_rsa.pub) será usada.

--storage-account-key

Chave da conta de armazenamento. Necessário se a conta de armazenamento pertencer a uma assinatura diferente. Pode ser especificado usando AZURE_BATCHAI_STORAGE_KEY variável de ambiente.

--storage-account-name

Nome da conta de armazenamento para Compartilhamentos de Arquivos do Azure e/ou Contêineres de Armazenamento do Azure a serem montados em cada nó de cluster. Pode ser especificado usando AZURE_BATCHAI_STORAGE_ACCOUNT variável de ambiente.

--subnet

ID ARM de uma sub-rede de rede virtual para colocar o cluster.

--target -t

Número de nós que devem ser alocados imediatamente após a criação do cluster. Se o cluster estiver no modo de dimensionamento automático, o BatchAI poderá alterar o número de nós posteriormente com base no número de trabalhos em execução e enfileirados.

--use-auto-storage

Se fornecido, o comando criará uma conta de armazenamento em um grupo de recursos novo ou existente chamado "batchaiautostorage". Ele também criará o Compartilhamento de Arquivos do Azure com o nome "batchaishare", o Contêiner de Blob do Azure com o nome "batchaicontainer". O Compartilhamento de Arquivos e o Contêiner de Blob serão montados em cada nó do cluster em $AZ_BATCHAI_MOUNT_ROOT/autoafs e $AZ_BATCHAI_MOUNT_ROOT/autobfs. Se o grupo de recursos já existir e contiver uma conta de armazenamento apropriada pertencente à mesma região do cluster, esse comando reutilizará a conta de armazenamento existente.

valor predefinido: False
--user-name -u

Nome da conta de usuário administrador a ser criada em cada nó de computação. Se o valor não for fornecido e nenhuma configuração de usuário for fornecida no arquivo de configuração, o nome do usuário atual será usado.

--vm-priority

Prioridade VM.

valores aceites: dedicated, lowpriority
--vm-size -s

Tamanho da VM para nós de cluster (por exemplo, Standard_NC6 para 1 nó GPU).

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az batchai cluster delete

Editar
Preterido

Este comando foi implicitamente preterido porque o grupo de comandos 'batchai' foi preterido e será removido em uma versão futura.

Excluir um cluster.

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

Exemplos

Exclua um cluster e aguarde a conclusão da exclusão.

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

Envie um comando delete para um cluster e não aguarde a conclusão da exclusão.

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

Exclua o cluster sem pedir confirmação (para cenários não interativos).

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

Parâmetros Opcionais

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--name -n

Nome do cluster.

--no-wait

Não espere que a operação de longa duração termine.

valor predefinido: False
--resource-group -g

o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--workspace -w

Nome do espaço de trabalho.

--yes -y

Não solicite confirmação.

valor predefinido: False
Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az batchai cluster list

Editar
Preterido

Este comando foi implicitamente preterido porque o grupo de comandos 'batchai' foi preterido e será removido em uma versão futura.

Listar clusters.

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

Exemplos

Liste todos os clusters em um espaço de trabalho.

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

Parâmetros Obrigatórios

--resource-group -g

o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--workspace -w

Nome do espaço de trabalho.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az batchai cluster resize

Editar
Preterido

Este comando foi implicitamente preterido porque o grupo de comandos 'batchai' foi preterido e será removido em uma versão futura.

Redimensione um cluster.

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

Exemplos

Redimensione um cluster para tamanho zero para parar de pagar por ele.

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

Redimensione um cluster para ter 10 nós.

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

Parâmetros Obrigatórios

--target -t

Número de destino de nós de computação.

Parâmetros Opcionais

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--name -n

Nome do cluster.

--resource-group -g

o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--workspace -w

Nome do espaço de trabalho.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az batchai cluster show

Editar
Preterido

Este comando foi implicitamente preterido porque o grupo de comandos 'batchai' foi preterido e será removido em uma versão futura.

Mostrar informações sobre um cluster.

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

Exemplos

Mostrar informações completas sobre um cluster.

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

Mostrar resumo do cluster.

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

Parâmetros Opcionais

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--name -n

Nome do cluster.

--resource-group -g

o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--workspace -w

Nome do espaço de trabalho.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.