az batchai cluster

  • Preterido
  • Referência

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

Comandos para gerenciar clusters.

Comandos

Nome Description Tipo Status
az batchai cluster auto-scale

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

 Núcleo Preterido
az batchai cluster create

Criar um cluster.

 Núcleo Preterido
az batchai cluster delete

Excluir um cluster.

 Núcleo Preterido
az batchai cluster file

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

 Núcleo Preterido
az batchai cluster file list

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

 Núcleo Preterido
az batchai cluster list

Listar clusters.

 Núcleo Preterido
az batchai cluster node

Comandos para trabalhar com nós de cluster.

 Núcleo Preterido
az batchai cluster node exec

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

 Núcleo Preterido
az batchai cluster node list

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

 Núcleo Preterido
az batchai cluster resize

Redimensionar um cluster.

 Núcleo Preterido
az batchai cluster show

Mostrar informações sobre um cluster.

 Núcleo Preterido

az batchai cluster auto-scale

Editar
Preterido

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

Definir 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 em fila e em execução.

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

Parâmetros Exigidos

--max

Número máximo de nós.

--min

Número mínimo de nós.

Parâmetros Opcionais

--ids

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

--name -n

Nome do cluster.

--resource-group -g

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--workspace -w

Nome do espaço de trabalho.

Parâmetros Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az batchai cluster create

Editar
Preterido

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

Criar 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 de instalação que instala descompactar 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 fornecendo 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 Exigidos

--name -n

Nome do cluster.

--resource-group -g

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 padrão: 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 padrão: 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. Note, você precisa fornecer --image contendo informações sobre a imagem base usada para a criação desta imagem.

--generate-ssh-keys

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

--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 por meio da linha de comando ou do arquivo de configuração, o Batch AI escolherá a imagem padrão do sistema operacional.

--max

Contagem máxima de nós para o cluster de dimensionamento automático.

--min

Contagem mínima de nós para o cluster de dimensionamento automático.

--nfs

Nome ou ID ARM de um servidor de arquivos a ser montado em cada nó de cluster. Você precisará fornecer a ID completa do ARM 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 padrão: 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 for alocado ou reinicializado. A tarefa é executada em um subshell bash na conta root.

--setup-task-output

Caminho do diretório para armazenar onde os logs da tarefa de instalação. Observe que a IA em lote criará vários diretórios auxiliares nesse 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 de conta de armazenamento. Obrigató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 do 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 em fila.

--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 Blobs do Azure com o nome "batchaicontainer". O Compartilhamento de Arquivos e o Contêiner de Blobs 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 padrão: False
--user-name -u

Nome da conta de usuário admin 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 da VM.

Valores aceitos: dedicated, lowpriority
--vm-size -s

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

Parâmetros Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az batchai cluster delete

Editar
Preterido

Esse comando foi preterido implicitamente 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 de exclusão 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 solicitar confirmação (para cenários não interativos).

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

Parâmetros Opcionais

--ids

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

--name -n

Nome do cluster.

--no-wait

Não aguarde a conclusão da operação de execução longa.

Valor padrão: False
--resource-group -g

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--workspace -w

Nome do espaço de trabalho.

--yes -y

Não solicite confirmação.

Valor padrão: False
Parâmetros Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az batchai cluster list

Editar
Preterido

Esse comando foi preterido implicitamente 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

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

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

Parâmetros Exigidos

--resource-group -g

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 Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az batchai cluster resize

Editar
Preterido

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

Redimensionar 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 Exigidos

--target -t

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

Parâmetros Opcionais

--ids

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

--name -n

Nome do cluster.

--resource-group -g

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--workspace -w

Nome do espaço de trabalho.

Parâmetros Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az batchai cluster show

Editar
Preterido

Esse comando foi preterido implicitamente 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 o resumo do cluster.

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

Parâmetros Opcionais

--ids

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

--name -n

Nome do cluster.

--resource-group -g

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--workspace -w

Nome do espaço de trabalho.

Parâmetros Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.