Compartir vía

az batchai cluster

  • Obsoleto
  • Referencia

Este grupo de comandos está en desuso implícitamente porque el grupo de comandos "batchai" está en desuso y se quitará en una versión futura.

Comandos para administrar clústeres.

Comandos

Nombre Description Tipo Estado
az batchai cluster auto-scale

Establezca parámetros de escalado automático para un clúster.

 Principal Obsoleto
az batchai cluster create

Cree un clúster.

 Principal Obsoleto
az batchai cluster delete

Elimine un clúster.

 Principal Obsoleto
az batchai cluster file

Comandos para trabajar con archivos generados por la tarea de configuración del nodo.

 Principal Obsoleto
az batchai cluster file list

Enumera los archivos generados por la tarea de configuración del nodo del clúster.

 Principal Obsoleto
az batchai cluster list

Enumerar clústeres.

 Principal Obsoleto
az batchai cluster node

Comandos para trabajar con nodos de clúster.

 Principal Obsoleto
az batchai cluster node exec

Ejecuta una línea de comandos en el nodo de un clúster con reenvío de puertos opcionales.

 Principal Obsoleto
az batchai cluster node list

Enumere la información de inicio de sesión remoto de los nodos del clúster.

 Principal Obsoleto
az batchai cluster resize

Cambiar el tamaño de un clúster.

 Principal Obsoleto
az batchai cluster show

Mostrar información sobre un clúster.

 Principal Obsoleto

az batchai cluster auto-scale

Editar
Obsoleto

Este comando está en desuso implícitamente porque el grupo de comandos "batchai" está en desuso y se quitará en una versión futura.

Establezca parámetros de escalado automático para un clúster.

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

Ejemplos

Haga que un clúster se escale automáticamente entre 0 y 10 nodos en función del número de trabajos en cola y en ejecución.

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

Parámetros requeridos

--max

Número máximo de nodos.

--min

Número mínimo de nodos.

Parámetros opcionales

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--name -n

Nombre del clúster.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--workspace -w

Nombre del área de trabajo.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az batchai cluster create

Editar
Obsoleto

Este comando está en desuso implícitamente porque el grupo de comandos "batchai" está en desuso y se quitará en una versión futura.

Cree un clúster.

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]

Ejemplos

Cree un clúster de GPU de un solo nodo con la imagen predeterminada y la cuenta de almacenamiento automático.

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

Cree un clúster con un comando de instalación que instale descomprimir en cada nodo, la salida del comando se almacenará en la cuenta de almacenamiento automático Recurso compartido de archivos de Azure.

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'

Cree un clúster que proporcione todos los 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

Cree un clúster mediante un archivo de configuración.

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

Parámetros requeridos

--name -n

Nombre del clúster.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--workspace -w

Nombre del área de trabajo.

Parámetros opcionales

--afs-mount-path

Ruta de acceso de montaje relativa para el recurso compartido de archivos de Azure. El recurso compartido de archivos estará disponible en $AZ_BATCHAI_MOUNT_ROOT/<relative_mount_path> carpeta.

Valor predeterminado: afs
--afs-name

Nombre del recurso compartido de archivos de Azure que se va a montar en cada nodo de clúster. Debe usarse junto con --storage-account-name. Se pueden montar varios recursos compartidos mediante el archivo de configuración (consulte la opción --config-file).

--bfs-mount-path

Ruta de acceso de montaje relativa para el contenedor de Azure Storage. El contenedor estará disponible en la carpeta $AZ_BATCHAI_MOUNT_ROOT/<relative_mount_path> .

Valor predeterminado: bfs
--bfs-name

Nombre del contenedor de Azure Storage que se va a montar en cada nodo de clúster. Debe usarse junto con --storage-account-name. Se pueden montar varios contenedores mediante el archivo de configuración (consulte la opción --config-file).

--config-file -f

Ruta de acceso a un archivo JSON que contiene parámetros de creación de clústeres (representación json de azure.mgmt.batchai.models.ClusterCreateParameters).

--custom-image

Id. de ARM de una imagen de máquina virtual que se va a usar para la creación de nodos. Tenga en cuenta que debe proporcionar --image que contiene información sobre la imagen base que se usa para esta creación de imágenes.

--generate-ssh-keys

Genere archivos de clave pública y privada SSH en el directorio ~/.ssh (si falta).

--image -i

Imagen del sistema operativo para los nodos de clúster. El valor puede contener un alias (UbuntuLTS, UbuntuDSVM) o especificar los detalles de la imagen con el formato "publisher:offer:sku:version". Si no se proporciona la configuración de la imagen a través de la línea de comandos o el archivo de configuración, Batch AI elegirá la imagen predeterminada del sistema operativo.

--max

Número máximo de nodos para el clúster de escalado automático.

--min

Número mínimo de nodos para el clúster de escalado automático.

--nfs

Nombre o identificador de ARM de un servidor de archivos que se va a montar en cada nodo de clúster. Debe proporcionar el identificador de ARM completo si el servidor de archivos pertenece a un área de trabajo diferente. Se pueden montar varios NFS mediante el archivo de configuración (consulte la opción --config-file).

--nfs-mount-path

Ruta de acceso de montaje relativa para NFS. NfS estará disponible en $AZ_BATCHAI_MOUNT_ROOT/<relative_mount_path> carpeta.

Valor predeterminado: nfs
--password -p

Contraseña opcional para la cuenta de usuario administrador que se va a crear en cada nodo de proceso.

--setup-task

Línea de comandos que se debe ejecutar en cada nodo de proceso cuando se ha asignado o reiniciado. La tarea se ejecuta en una subshell de Bash en la cuenta raíz.

--setup-task-output

Ruta de acceso del directorio para almacenar los registros de la tarea de instalación. Tenga en cuenta que Batch AI creará varios directorios auxiliares en esta ruta de acceso. Los directorios creados se notifican como stdOutErrPathSuffix mediante el comando "az cluster show".

--ssh-key -k

Valor o ruta de acceso de clave pública SSH opcional. Si se ha asignado y no se especifica ninguna contraseña, se usará la clave SSH predeterminada (~/.ssh/id_rsa.pub).

--storage-account-key

Clave de la cuenta de almacenamiento. Obligatorio si la cuenta de almacenamiento pertenece a una suscripción diferente. Se puede especificar mediante AZURE_BATCHAI_STORAGE_KEY variable de entorno.

--storage-account-name

Nombre de la cuenta de almacenamiento para recursos compartidos de archivos de Azure o contenedores de Azure Storage que se van a montar en cada nodo de clúster. Se puede especificar mediante AZURE_BATCHAI_STORAGE_ACCOUNT variable de entorno.

--subnet

Id. de ARM de una subred de red virtual en la que colocar el clúster.

--target -t

Número de nodos que se deben asignar inmediatamente después de la creación del clúster. Si el clúster está en modo de escalado automático, BatchAI puede cambiar el número de nodos más adelante en función del número de trabajos en ejecución y en cola.

--use-auto-storage

Si se proporciona, el comando creará una cuenta de almacenamiento en un grupo de recursos nuevo o existente denominado "batchaiautostorage". También creará un recurso compartido de archivos de Azure con el nombre "batchaishare", el contenedor de blobs de Azure con el nombre "batchaicontainer". El recurso compartido de archivos y el contenedor de blobs se montarán en cada nodo de clúster en $AZ_BATCHAI_MOUNT_ROOT/autoafs y $AZ_BATCHAI_MOUNT_ROOT/autobfs. Si el grupo de recursos ya existe y contiene una cuenta de almacenamiento approapriate que pertenece a la misma región que el clúster, este comando reutilizará la cuenta de almacenamiento existente.

Valor predeterminado: False
--user-name -u

Nombre de la cuenta de usuario administrador que se va a crear en cada nodo de proceso. Si no se proporciona el valor y no se proporciona ninguna configuración de usuario en el archivo de configuración, se usará el nombre del usuario actual.

--vm-priority

Prioridad de máquina virtual.

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

Tamaño de máquina virtual para nodos de clúster (por ejemplo, Standard_NC6 para 1 nodo de GPU).

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az batchai cluster delete

Editar
Obsoleto

Este comando está en desuso implícitamente porque el grupo de comandos "batchai" está en desuso y se quitará en una versión futura.

Elimine un clúster.

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

Ejemplos

Elimine un clúster y espere a que se complete la eliminación.

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

Envíe un comando delete para un clúster y no espere a que se complete la eliminación.

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

Elimine el clúster sin pedir confirmación (para escenarios no interactivos).

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

Parámetros opcionales

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--name -n

Nombre del clúster.

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

Valor predeterminado: False
--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--workspace -w

Nombre del área de trabajo.

--yes -y

No solicita confirmación.

Valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az batchai cluster list

Editar
Obsoleto

Este comando está en desuso implícitamente porque el grupo de comandos "batchai" está en desuso y se quitará en una versión futura.

Enumerar clústeres.

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

Ejemplos

Enumere todos los clústeres de un área de trabajo.

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

Parámetros requeridos

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--workspace -w

Nombre del área de trabajo.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az batchai cluster resize

Editar
Obsoleto

Este comando está en desuso implícitamente porque el grupo de comandos "batchai" está en desuso y se quitará en una versión futura.

Cambiar el tamaño de un clúster.

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

Ejemplos

Cambie el tamaño de un clúster a cero para dejar de pagarlo.

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

Cambie el tamaño de un clúster para que tenga 10 nodos.

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

Parámetros requeridos

--target -t

Número de destino de nodos de proceso.

Parámetros opcionales

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--name -n

Nombre del clúster.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--workspace -w

Nombre del área de trabajo.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az batchai cluster show

Editar
Obsoleto

Este comando está en desuso implícitamente porque el grupo de comandos "batchai" está en desuso y se quitará en una versión futura.

Mostrar información sobre un clúster.

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

Ejemplos

Mostrar información completa sobre un clúster.

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

Mostrar el resumen del clúster.

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

Parámetros opcionales

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--name -n

Nombre del clúster.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--workspace -w

Nombre del área de trabajo.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.