az batchai cluster

  • Als veraltet markiert
  • Referenz

Diese Befehlsgruppe ist implizit veraltet, da die Befehlsgruppe "batchai" veraltet ist und in einer zukünftigen Version entfernt wird.

Befehle zum Verwalten von Clustern.

Befehle

Name Beschreibung Typ Status
az batchai cluster auto-scale

Legen Sie automatische Skalierungsparameter für einen Cluster fest.

 Kernspeicher Als veraltet markiert
az batchai cluster create

Erstellen eines Clusters.

 Kernspeicher Als veraltet markiert
az batchai cluster delete

Löschen eines Clusters.

 Kernspeicher Als veraltet markiert
az batchai cluster file

Befehle zum Arbeiten mit Dateien, die von der Knoteneinrichtungsaufgabe generiert werden.

 Kernspeicher Als veraltet markiert
az batchai cluster file list

Listet Dateien auf, die von der Knoteneinrichtungsaufgabe des Clusters generiert werden.

 Kernspeicher Als veraltet markiert
az batchai cluster list

Auflisten von Clustern.

 Kernspeicher Als veraltet markiert
az batchai cluster node

Befehle zum Arbeiten mit Clusterknoten.

 Kernspeicher Als veraltet markiert
az batchai cluster node exec

Führt eine Befehlszeile auf dem Knoten eines Clusters mit optionaler Portsweiterleitung aus.

 Kernspeicher Als veraltet markiert
az batchai cluster node list

Auflisten von Remoteanmeldungsinformationen für Die Knoten des Clusters.

 Kernspeicher Als veraltet markiert
az batchai cluster resize

Ändern sie die Größe eines Clusters.

 Kernspeicher Als veraltet markiert
az batchai cluster show

Zeigen Sie Informationen zu einem Cluster an.

 Kernspeicher Als veraltet markiert

az batchai cluster auto-scale

Bearbeiten
Als veraltet markiert

Dieser Befehl ist implizit veraltet, da die Befehlsgruppe "batchai" veraltet ist und in einer zukünftigen Version entfernt wird.

Legen Sie automatische Skalierungsparameter für einen Cluster fest.

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

Beispiele

Erstellen Sie einen Cluster, um abhängig von der Anzahl der in die Warteschlange gestellten und ausgeführten Aufträgen automatisch zwischen 0 und 10 Knoten zu skalieren.

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

Erforderliche Parameter

--max

Maximale Anzahl von Knoten.

--min

Minimale Anzahl von Knoten.

Optionale Parameter

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. 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.

--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.

--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.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--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
Als veraltet markiert

Dieser Befehl ist implizit veraltet, da die Befehlsgruppe "batchai" veraltet ist und in einer zukünftigen Version entfernt wird.

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 GPU-Cluster mit einem einzelnen Knoten 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 die Entpackung auf jedem Knoten installiert, die Befehlsausgabe wird auf dem automatischen Speicherkonto Azure File Share 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 Bereitstellungspfad für die Azure-Dateifreigabe. Die Dateifreigabe ist unter $AZ_BATCHAI_MOUNT_ROOT/<relative_mount_path> Ordner 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". 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 ist unter $AZ_BATCHAI_MOUNT_ROOT/<relative_mount_path> Ordner verfügbar.

Standardwert: bfs
--bfs-name

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

--config-file -f

Ein Pfad zu einer JSON-Datei, die Cluster-Erstellungsparameter 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 --Image bereitstellen müssen, das Informationen zum Basisimage enthält, das für diese Bilderstellung verwendet wird.

--generate-ssh-keys

Generieren Sie SSH-Dateien für öffentliche und private Schlüssel im Verzeichnis ~/.ssh (falls nicht vorhanden).

--image -i

Betriebssystemimage für Clusterknoten. Der Wert kann einen Alias (UbuntuLTS, UbuntuDSVM) enthalten oder Bilddetails im Format "publisher:offer:sku:version" angeben. Wenn die Imagekonfiguration nicht über die Befehlszeile oder Konfigurationsdatei bereitgestellt wird, wählt Batch AI das Standardmäßige Betriebssystemimage aus.

--max

Max. Knotenanzahl für den automatisch skalenten Cluster.

--min

Min knoten count for the auto-scale 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 Bereitstellungspfad für NFS. Der NFS wird unter $AZ_BATCHAI_MOUNT_ROOT/<relative_mount_path> Ordner verfügbar sein.

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 dem Stammkonto ausgeführt.

--setup-task-output

Verzeichnispfad zum Speichern, in dem die Setupaufgabenprotokolle 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 für SSH. Wenn kein Kennwort angegeben und nicht angegeben wird, 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 Umgebungsvariable angegeben werden.

--storage-account-name

Speicherkontoname für Azure-Dateifreigaben 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 Netzwerksubnetz, um den Cluster einzufügen.

--target -t

Anzahl der Knoten, die unmittelbar nach der Clustererstellung zugewiesen werden sollen. Wenn sich der Cluster im automatischen Skalierungsmodus 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 an $AZ_BATCHAI_MOUNT_ROOT/autoafs und $AZ_BATCHAI_MOUNT_ROOT/autobfs bereitgestellt. Wenn die Ressourcengruppe bereits vorhanden ist und ein Approapriate-Speicherkonto enthält, das derselben Region wie dem Cluster gehört, verwendet dieser Befehl das vorhandene Speicherkonto wieder.

Standardwert: False
--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 angegeben 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.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--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
Als veraltet markiert

Dieser Befehl ist implizit veraltet, da die Befehlsgruppe "batchai" veraltet ist und in einer zukünftigen Version entfernt wird.

Löschen eines Clusters.

az batchai cluster delete [--ids]
                          [--name]
                          [--no-wait]
                          [--resource-group]
                          [--subscription]
                          [--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 den 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

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--name -n

Name des Clusters.

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
--resource-group -g

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

--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.

--workspace -w

Name des Arbeitsbereichs.

--yes -y

Nicht zur Bestätigung auffordern

Standardwert: False
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.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--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
Als veraltet markiert

Dieser Befehl ist implizit veraltet, da die Befehlsgruppe "batchai" veraltet ist und in einer zukünftigen Version entfernt wird.

Auflisten von Clustern.

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

Beispiele

Listet alle Cluster in einem Arbeitsbereich auf.

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.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--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
Als veraltet markiert

Dieser Befehl ist implizit veraltet, da die Befehlsgruppe "batchai" veraltet ist und in einer zukünftigen Version entfernt wird.

Ändern sie die Größe eines Clusters.

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

Beispiele

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

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

Ändern Sie die Größe eines Clusters auf 10 Knoten.

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

Erforderliche Parameter

--target -t

Zielanzahl der Computeknoten.

Optionale Parameter

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. 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.

--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.

--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.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--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
Als veraltet markiert

Dieser Befehl ist implizit veraltet, da die Befehlsgruppe "batchai" veraltet ist und in einer zukünftigen Version entfernt wird.

Zeigen Sie Informationen zu einem Cluster an.

az batchai cluster show [--ids]
                        [--name]
                        [--resource-group]
                        [--subscription]
                        [--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

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. 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.

--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.

--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.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--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.