az batchai cluster

  • Déprécié
  • Référence

Ce groupe de commandes est implicitement déconseillé, car le groupe de commandes « batchai » est déconseillé et sera supprimé dans une version ultérieure.

Commandes pour gérer les clusters.

Commandes

Nom Description Type Statut
az batchai cluster auto-scale

Définissez des paramètres de mise à l’échelle automatique pour un cluster.

 Core Déprécié
az batchai cluster create

Créez un cluster.

 Core Déprécié
az batchai cluster delete

Supprimez un cluster.

 Core Déprécié
az batchai cluster file

Commandes permettant d’utiliser les fichiers générés par la tâche de configuration de nœud.

 Core Déprécié
az batchai cluster file list

Répertorier les fichiers générés par la tâche de configuration du nœud du cluster.

 Core Déprécié
az batchai cluster list

Répertorier les clusters.

 Core Déprécié
az batchai cluster node

Commandes à utiliser avec des nœuds de cluster.

 Core Déprécié
az batchai cluster node exec

Exécute une ligne de commande sur le nœud d’un cluster avec transfert de ports facultatifs.

 Core Déprécié
az batchai cluster node list

Répertoriez les informations de connexion à distance pour les nœuds du cluster.

 Core Déprécié
az batchai cluster resize

Redimensionnez un cluster.

 Core Déprécié
az batchai cluster show

Affichez des informations sur un cluster.

 Core Déprécié

az batchai cluster auto-scale

Modifier
Déprécié

Cette commande est implicitement déconseillée, car le groupe de commandes « batchai » est déconseillé et sera supprimé dans une version ultérieure.

Définissez des paramètres de mise à l’échelle automatique pour un cluster.

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

Exemples

Rendre un cluster à mettre à l’échelle automatiquement entre 0 et 10 nœuds en fonction du nombre de travaux mis en file d’attente et en cours d’exécution.

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

Paramètres obligatoires

--max

Nombre maximal de nœuds.

--min

Nombre minimal de nœuds.

Paramètres facultatifs

--ids

Un ou plusieurs ID de ressource (délimités par des espaces). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

--name -n

Nom du cluster.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--workspace -w

Nom de l’espace de travail.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az batchai cluster create

Modifier
Déprécié

Cette commande est implicitement déconseillée, car le groupe de commandes « batchai » est déconseillé et sera supprimé dans une version ultérieure.

Créez 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]

Exemples

Créez un cluster GPU à nœud unique avec une image par défaut et un compte de stockage automatique.

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

Créez un cluster avec une commande d’installation qui installe décompresser sur chaque nœud, la sortie de commande sera stockée sur le partage de fichiers Azure du compte de stockage automatique.

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'

Créez un cluster fournissant tous les paramètres manuellement.

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

Créez un cluster à l’aide d’un fichier de configuration.

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

Paramètres obligatoires

--name -n

Nom du cluster.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--workspace -w

Nom de l’espace de travail.

Paramètres facultatifs

--afs-mount-path

Chemin de montage relatif pour le partage de fichiers Azure. Le partage de fichiers est disponible dans $AZ_BATCHAI_MOUNT_ROOT/<relative_mount_path> dossier.

valeur par défaut: afs
--afs-name

Nom du partage de fichiers Azure à monter sur chaque nœud de cluster. Doit être utilisé conjointement avec --storage-account-name. Plusieurs partages peuvent être montés à l’aide du fichier de configuration (voir l’option --config-file).

--bfs-mount-path

Chemin de montage relatif pour Stockage Azure conteneur. Le conteneur sera disponible dans $AZ_BATCHAI_MOUNT_ROOT/<relative_mount_path> dossier.

valeur par défaut: bfs
--bfs-name

Nom de Stockage Azure conteneur à monter sur chaque nœud de cluster. Doit être utilisé conjointement avec --storage-account-name. Plusieurs conteneurs peuvent être montés à l’aide du fichier de configuration (voir l’option --config-file).

--config-file -f

Chemin d’accès à un fichier json contenant des paramètres de création de cluster (représentation json d’azure.mgmt.batchai.models.ClusterCreateParameters).

--custom-image

ID ARM d’une image de machine virtuelle à utiliser pour la création de nœuds. Notez que vous devez fournir --image contenant des informations sur l’image de base utilisée pour cette création d’image.

--generate-ssh-keys

Générez des fichiers de clé publique et privée SSH dans le répertoire ~/.ssh (le cas échéant).

--image -i

Image système d’opération pour les nœuds de cluster. La valeur peut contenir un alias (UbuntuLTS, UbuntuDSVM) ou spécifier les détails de l’image sous la forme « publisher:offer:sku:version ». Si la configuration de l’image n’est pas fournie par le biais d’une ligne de commande ou d’un fichier de configuration, Batch AI choisit l’image de système d’exploitation par défaut.

--max

Nombre maximal de nœuds pour le cluster à l’échelle automatique.

--min

Nombre minimal de nœuds pour le cluster de mise à l’échelle automatique.

--nfs

Nom ou ID ARM d’un serveur de fichiers à monter sur chaque nœud de cluster. Vous devez fournir un ID ARM complet si le serveur de fichiers appartient à un autre espace de travail. Plusieurs NFS peuvent être montés à l’aide du fichier de configuration (voir l’option --config-file).

--nfs-mount-path

Chemin de montage relatif pour NFS. Le NFS sera disponible dans $AZ_BATCHAI_MOUNT_ROOT/<relative_mount_path> dossier.

valeur par défaut: nfs
--password -p

Mot de passe facultatif pour le compte d’utilisateur administrateur à créer sur chaque nœud de calcul.

--setup-task

Ligne de commande qui doit être exécutée sur chaque nœud de calcul lorsqu’il a été alloué ou redémarré. La tâche est exécutée dans une sous-shell bash sous le compte racine.

--setup-task-output

Chemin d’accès au répertoire pour stocker les journaux d’activité de la tâche d’installation. Notez que Batch AI crée plusieurs répertoires d’assistance sous ce chemin. Les répertoires créés sont signalés comme stdOutErrPathSuffix par la commande « az cluster show ».

--ssh-key -k

Valeur ou chemin facultatif de clé publique SSH. Si aucun mot de passe n’est spécifié, la clé SSH par défaut (~/.ssh/id_rsa.pub) est utilisée.

--storage-account-key

Clé du compte de stockage. Obligatoire si le compte de stockage appartient à un autre abonnement. Peut être spécifié à l’aide de AZURE_BATCHAI_STORAGE_KEY variable d’environnement.

--storage-account-name

Stockage nom de compte pour les partages de fichiers Azure et/ou Stockage Azure conteneurs à monter sur chaque nœud de cluster. Peut être spécifié à l’aide de AZURE_BATCHAI_STORAGE_ACCOUNT variable d’environnement.

--subnet

ID ARM d’un sous-réseau de réseau virtuel dans lequel placer le cluster.

--target -t

Nombre de nœuds qui doivent être alloués immédiatement après la création du cluster. Si le cluster est en mode de mise à l’échelle automatique, BatchAI peut modifier le nombre de nœuds ultérieurement en fonction du nombre de travaux en cours d’exécution et en file d’attente.

--use-auto-storage

Si elle est fournie, la commande crée un compte de stockage dans un groupe de ressources nouveau ou existant nommé « batchaiautostorage ». Il crée également un partage de fichiers Azure avec le nom « batchaishare », le conteneur d’objets blob Azure avec le nom « batchaicontainer ». Le partage de fichiers et le conteneur d’objets blob sont montés sur chaque nœud de cluster à $AZ_BATCHAI_MOUNT_ROOT/autoafs et $AZ_BATCHAI_MOUNT_ROOT/autobfs. Si le groupe de ressources existe déjà et contient un compte de stockage approapriate appartenant à la même région que le cluster, cette commande réutilise le compte de stockage existant.

valeur par défaut: False
--user-name -u

Nom du compte d’utilisateur administrateur à créer sur chaque nœud de calcul. Si la valeur n’est pas fournie et qu’aucune configuration utilisateur n’est fournie dans le fichier de configuration, le nom de l’utilisateur actuel est utilisé.

--vm-priority

Priorité de la machine virtuelle.

valeurs acceptées: dedicated, lowpriority
--vm-size -s

Taille de machine virtuelle pour les nœuds de cluster (par exemple, Standard_NC6 pour 1 nœud GPU).

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az batchai cluster delete

Modifier
Déprécié

Cette commande est implicitement déconseillée, car le groupe de commandes « batchai » est déconseillé et sera supprimé dans une version ultérieure.

Supprimez un cluster.

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

Exemples

Supprimez un cluster et attendez la fin de la suppression.

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

Envoyez une commande delete pour un cluster et n’attendez pas la fin de la suppression.

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

Supprimez le cluster sans demander de confirmation (pour les scénarios non interactifs).

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

Paramètres facultatifs

--ids

Un ou plusieurs ID de ressource (délimités par des espaces). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

--name -n

Nom du cluster.

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

valeur par défaut: False
--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--workspace -w

Nom de l’espace de travail.

--yes -y

Ne pas demander de confirmation.

valeur par défaut: False
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az batchai cluster list

Modifier
Déprécié

Cette commande est implicitement déconseillée, car le groupe de commandes « batchai » est déconseillé et sera supprimé dans une version ultérieure.

Répertorier les clusters.

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

Exemples

Répertoriez tous les clusters d’un espace de travail.

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

Paramètres obligatoires

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--workspace -w

Nom de l’espace de travail.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az batchai cluster resize

Modifier
Déprécié

Cette commande est implicitement déconseillée, car le groupe de commandes « batchai » est déconseillé et sera supprimé dans une version ultérieure.

Redimensionnez un cluster.

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

Exemples

Redimensionnez un cluster sur une taille nulle pour arrêter de payer pour celui-ci.

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

Redimensionnez un cluster pour avoir 10 nœuds.

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

Paramètres obligatoires

--target -t

Nombre cible de nœuds de calcul.

Paramètres facultatifs

--ids

Un ou plusieurs ID de ressource (délimités par des espaces). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

--name -n

Nom du cluster.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--workspace -w

Nom de l’espace de travail.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az batchai cluster show

Modifier
Déprécié

Cette commande est implicitement déconseillée, car le groupe de commandes « batchai » est déconseillé et sera supprimé dans une version ultérieure.

Affichez des informations sur un cluster.

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

Exemples

Afficher des informations complètes sur un cluster.

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

Afficher le résumé du cluster.

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

Paramètres facultatifs

--ids

Un ou plusieurs ID de ressource (délimités par des espaces). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

--name -n

Nom du cluster.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--workspace -w

Nom de l’espace de travail.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.