az batchai cluster

Referenz

Befehle zum Verwalten von Clustern.

Befehle

az batchai cluster auto-scale	Legen Sie die Parameter für die automatische Skalierung für einen Cluster fest.
az batchai cluster create	Erstellen eines Clusters
az batchai cluster delete	Löschen eines Clusters.
az batchai cluster file	Befehle zum Arbeiten mit Dateien, die von der Knoteneinrichtungsaufgabe generiert werden.
az batchai cluster file list	Listet Dateien auf, die von der Knoteneinrichtungsaufgabe des Clusters generiert werden.
az batchai cluster list	Listencluster.
az batchai cluster node	Befehle zum Arbeiten mit Clusterknoten.
az batchai cluster node exec	Führt eine Befehlszeile auf dem Knoten eines Clusters mit optionaler Portsweiterleitung aus.
az batchai cluster node list	Auflisten von Remoteanmeldungsinformationen für Clusterknoten.
az batchai cluster resize	Ändern der Größe eines Clusters.
az batchai cluster show	Informationen zu einem Cluster anzeigen.

az batchai cluster auto-scale

Bearbeiten

Legen Sie die Parameter für die automatische Skalierung für einen Cluster fest.

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

Beispiele

Erstellen Sie einen Cluster zum automatischen Skalieren zwischen 0 und 10 Knoten abhängig von der Anzahl der in die Warteschlange gestellten und ausgeführten Aufträgen.

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

Erforderliche Parameter

--max

Maximale Anzahl von Knoten.

--min

Mindestanzahl von Knoten.

Optionale Parameter

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Es sollte eine vollständige Ressourcen-ID sein, die alle Informationen von Argumenten der Ressource-ID enthält. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--name -n

Name des Clusters.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--workspace -w

Name des Arbeitsbereichs.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az batchai cluster create

Bearbeiten

Erstellen eines Clusters

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]

Beispiele

Erstellen Sie einen einzelnen GPU-Cluster mit Standardimage und automatischem Speicherkonto.

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

Erstellen Sie einen Cluster mit einem Setupbefehl, der auf jedem Knoten entzipt, wird die Befehlsausgabe auf dem azure File Share-Konto für automatische Speicher gespeichert.

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'

Erstellen Sie einen Cluster, der alle Parameter manuell bereitstellt.

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

Erstellen Sie einen Cluster mithilfe einer Konfigurationsdatei.

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

Erforderliche Parameter

--name -n

Name des Clusters.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--workspace -w

Name des Arbeitsbereichs.

Optionale Parameter

--afs-mount-path

Relativer Mount-Pfad für die Azure-Dateifreigabe. Die Dateifreigabe ist im Ordner $AZ_BATCHAI_MOUNT_ROOT/<relative_mount_path> verfügbar.

Standardwert: afs

--afs-name

Name der Azure-Dateifreigabe, die auf jedem Clusterknoten bereitgestellt werden soll. Muss in Verbindung mit dem Namen "-storage-account-name" verwendet werden. Mehrere Freigaben können mithilfe der Konfigurationsdatei bereitgestellt werden (siehe Option "--config-file").

--bfs-mount-path

Relativer Bereitstellungspfad für Azure Storage-Container. Der Container steht im Ordner $AZ_BATCHAI_MOUNT_ROOT/<relative_mount_path> zur Verfügung.

Standardwert: bfs

--bfs-name

Name des Azure Storage-Containers, der auf jedem Clusterknoten bereitgestellt werden soll. Muss in Verbindung mit dem Namen "-storage-account-name" verwendet werden. Mehrere Container können mithilfe der Konfigurationsdatei bereitgestellt werden (siehe Option "--config-file").

--config-file -f

Ein Pfad zu einer JSON-Datei, die Cluster-Create-Parameter enthält (json-Darstellung von azure.mgmt.batchai.models.ClusterCreateParameters).

--custom-image

ARM-ID eines virtuellen Computerimages, das für die Erstellung von Knoten verwendet werden soll. Beachten Sie, dass Sie Informationen zum Basisbild bereitstellen müssen, das für diese Bilderstellung verwendet wird.

--generate-ssh-keys

Generieren Sie öffentliche und private Schlüsseldateien in ~/.ssh-Verzeichnis (falls fehlt).

--image -i

Betriebssystemimage für Clusterknoten. Der Wert kann einen Alias (UbuntuLTS, UbuntuDSVM) enthalten oder Bilddetails im Formular "publisher:offer:sku:version" angeben. Wenn die Bildkonfiguration nicht über befehlszeilen- oder Konfigurationsdatei bereitgestellt wird, wählt Batch AI standardmäßiges Betriebssystemimage aus.

--max

Max. Knotenanzahl für den automatisch skalierenden Cluster.

--min

Min.-Knotenanzahl für den automatisch skalierenden Cluster.

--nfs

Name oder ARM-ID eines Dateiservers, der auf jedem Clusterknoten bereitgestellt werden soll. Sie müssen vollständige ARM-ID angeben, wenn der Dateiserver zu einem anderen Arbeitsbereich gehört. Mehrere NFS können mithilfe der Konfigurationsdatei bereitgestellt werden (siehe Option "--config-file").

--nfs-mount-path

Relativer Mount-Pfad für NFS. Der NFS steht im Ordner $AZ_BATCHAI_MOUNT_ROOT/<relative_mount_path> zur Verfügung.

Standardwert: nfs

--password -p

Optionales Kennwort für das Administratorbenutzerkonto, das auf jedem Computeknoten erstellt werden soll.

--setup-task

Eine Befehlszeile, die auf jedem Computeknoten ausgeführt werden soll, wenn er zugewiesen oder neu gestartet wird. Die Aufgabe wird in einer bash-Untershell unter Stammkonto ausgeführt.

--setup-task-output

Verzeichnispfad zum Speichern, in dem die Protokolle von Setupaufgaben gespeichert werden. Beachten Sie, dass Batch AI mehrere Hilfsverzeichnisse unter diesem Pfad erstellt. Die erstellten Verzeichnisse werden als stdOutErrPathSuffix durch den Befehl "az cluster show" gemeldet.

--ssh-key -k

Optionaler PUBLIC Key-Wert oder Pfad. Wenn ommited und kein Kennwort angegeben ist, wird standardmäßiger SSH-Schlüssel (~/.ssh/id_rsa.pub) verwendet.

--storage-account-key

Speicherkontoschlüssel Erforderlich, wenn das Speicherkonto zu einem anderen Abonnement gehört. Kann mithilfe AZURE_BATCHAI_STORAGE_KEY Umgebungsvariablen angegeben werden.

--storage-account-name

Speicherkontoname für Azure File Shares und/oder Azure Storage Container, die auf jedem Clusterknoten bereitgestellt werden sollen. Kann mithilfe AZURE_BATCHAI_STORAGE_ACCOUNT Umgebungsvariable angegeben werden.

--subnet

ARM-ID eines virtuellen Netzwerk-Subnetzs, um den Cluster einzufügen.

--target -t

Anzahl der Knoten, die unmittelbar nach der Clustererstellung zugewiesen werden sollen. Wenn sich der Cluster im Modus für die automatische Skalierung befindet, kann BatchAI die Anzahl der Knoten später basierend auf der Anzahl der ausgeführten und in die Warteschlange gestellten Aufträgen ändern.

--use-auto-storage

Wenn angegeben, erstellt der Befehl ein Speicherkonto in einer neuen oder vorhandenen Ressourcengruppe namens "batchaiautostorage". Außerdem wird Azure File Share mit dem Namen "batchaishare", Azure Blob Container mit dem Namen "batchaicontainer" erstellt. Der Dateifreigabe- und Blobcontainer wird auf jedem Clusterknoten bei $AZ_BATCHAI_MOUNT_ROOT/autoafs und $AZ_BATCHAI_MOUNT_ROOT/autobfs bereitgestellt. Wenn die Ressourcengruppe bereits vorhanden ist und ein approapriates Speicherkonto enthält, das zu derselben Region wie cluster gehört, verwendet dieser Befehl das vorhandene Speicherkonto.

--user-name -u

Name des Administratorbenutzerkontos, das auf jedem Computeknoten erstellt werden soll. Wenn der Wert nicht angegeben wird und keine Benutzerkonfiguration in der Konfigurationsdatei bereitgestellt wird, wird der Name des aktuellen Benutzers verwendet.

--vm-priority

VM-Priorität.

Zulässige Werte: dedicated, lowpriority

--vm-size -s

VM-Größe für Clusterknoten (z. B. Standard_NC6 für 1 GPU-Knoten).

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az batchai cluster delete

Bearbeiten

Löschen eines Clusters.

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

Beispiele

Löschen Sie einen Cluster, und warten Sie, bis der Löschvorgang abgeschlossen ist.

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

Senden Sie einen Löschbefehl für einen Cluster, und warten Sie nicht, bis der Löschvorgang abgeschlossen ist.

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

Löschen Sie Cluster, ohne eine Bestätigung zu verlangen (für nicht interaktive Szenarien).

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

Optionale Parameter

--ids

--name -n

Name des Clusters.

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--workspace -w

Name des Arbeitsbereichs.

--yes -y

Nicht zur Bestätigung auffordern

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az batchai cluster list

Bearbeiten

Listencluster.

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

Beispiele

Alle Cluster in einem Arbeitsbereich auflisten.

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

Erforderliche Parameter

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--workspace -w

Name des Arbeitsbereichs.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az batchai cluster resize

Bearbeiten

Ändern der Größe eines Clusters.

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

Beispiele

Ändern Sie die Größe eines Clusters auf null, um die Zahlung für sie zu beenden.

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

Ändern Sie die Größe eines Clusters, um über 10 Knoten zu verfügen.

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

Erforderliche Parameter

--target -t

Zielanzahl der Berechnungsknoten.

Optionale Parameter

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Es sollte eine vollständige Ressourcen-ID sein, die alle Informationen der Argumente "Resource Id" enthält. Sie sollten entweder --ids oder andere Argumente "Resource Id" angeben.

--name -n

Name des Clusters.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--workspace -w

Name des Arbeitsbereichs.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az batchai cluster show

Bearbeiten

Informationen zu einem Cluster anzeigen.

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

Beispiele

Vollständige Informationen zu einem Cluster anzeigen.

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

Zusammenfassung des Clusters anzeigen.

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

Optionale Parameter

--ids

--name -n

Name des Clusters.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--workspace -w

Name des Arbeitsbereichs.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az batchai cluster

Befehle

az batchai cluster auto-scale

Beispiele

Erforderliche Parameter

Optionale Parameter

az batchai cluster create

Beispiele

Erforderliche Parameter

Optionale Parameter

az batchai cluster delete

Beispiele

Optionale Parameter

az batchai cluster list

Beispiele

Erforderliche Parameter

az batchai cluster resize

Beispiele

Erforderliche Parameter

Optionale Parameter

az batchai cluster show

Beispiele

Optionale Parameter

Feedback