az batchai cluster

Opdrachten voor het beheren van clusters.

Opdracht

az batchai cluster auto-scale

Parameters voor automatisch schalen instellen voor een cluster.

az batchai cluster create

Een cluster maken.

az batchai cluster delete

Een cluster verwijderen.

az batchai cluster file

Opdrachten voor het werken met bestanden die zijn gegenereerd door de installatietaak van het knooppunt.

az batchai cluster file list

Lijst met bestanden die zijn gegenereerd door de installatietaak van het clusterknooppunt.

az batchai cluster list

Clusters op een lijst zetten.

az batchai cluster node

Opdrachten voor het werken met clusterknooppunten.

az batchai cluster node exec

Hiermee wordt een opdrachtregel uitgevoerd op het knooppunt van een cluster met optionele doorsturen via poorten.

az batchai cluster node list

Externe aanmeldingsgegevens voor clusterknooppunten opsommen.

az batchai cluster resize

Het cluster het 100-00-cluster het 1000-

az batchai cluster show

Informatie over een cluster tonen.

az batchai cluster auto-scale

Parameters voor automatisch schalen instellen voor een cluster.

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

Voorbeelden

Maak een cluster om automatisch te schalen tussen 0 en 10 knooppunten, afhankelijk van het aantal taken in de wachtrij en de taken die worden uitgevoerd.

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

Vereiste parameters

--max

Maximum aantal knooppunten.

--min

Minimum aantal knooppunten.

Optionele parameters

--ids

Een of meer resource-ID's (door spaties scheidingstekens). Dit moet een volledige resource-id zijn die alle gegevens van de argumenten 'Resource-id' bevat. U moet --id's of andere argumenten voor resource-id's verstrekken.

--name -n

Naam van cluster.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name> .

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met az account set -s NAME_OR_ID behulp van .

--workspace -w

De naam van de werkruimte.

az batchai cluster create

Een cluster maken.

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]
                          [--subscription]
                          [--target]
                          [--use-auto-storage]
                          [--user-name]
                          [--vm-priority {dedicated, lowpriority}]
                          [--vm-size]

Voorbeelden

Maak een GPU-cluster met één knooppunt met een standaardafbeelding en een account voor automatische opslag.

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

Maak een cluster met een installatieopdracht waarmee unzip op elk knooppunt wordt geïnstalleerd. De uitvoer van de opdracht wordt opgeslagen in het azure-bestandsaccount voor automatische opslag.

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'

Maak een cluster dat handmatig alle parameters levert.

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

Maak een cluster met behulp van een configuratiebestand.

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

Vereiste parameters

--name -n

Naam van cluster.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name> .

--workspace -w

De naam van de werkruimte.

Optionele parameters

--afs-mount-path

Relatief pad voor het maken van een Azure-bestands share. De bestands share is beschikbaar in $AZ_BATCHAI_MOUNT_ROOT/<relative_mount_path> map.

standaardwaarde: afs
--afs-name

De naam van de Azure-bestands share die aan elk clusterknooppunt moet worden bevestigd. Moet worden gebruikt in combinatie met --storage-account-name. Meerdere shares kunnen worden bevestigd met behulp van een configuratiebestand (zie de optie --config-file).

--bfs-mount-path

Relatief pad voor het Azure Storage container. De container is beschikbaar op $AZ_BATCHAI_MOUNT_ROOT/<relative_mount_path> map.

standaardwaarde: bfs
--bfs-name

Naam van Azure Storage container die aan elk clusterknooppunt moet worden bevestigd. Moet worden gebruikt in combinatie met --storage-account-name. Er kunnen meerdere containers worden gemonteerd met behulp van een configuratiebestand (zie de optie --config-file).

--config-file -f

Een pad naar een JSON-bestand met parameters voor het maken van clusters (json-weergave van azure.mgmt.batchai.models.ClusterCreateParameters).

--custom-image

ARM-id van een virtuele-machine-afbeelding die moet worden gebruikt voor het maken van knooppunten. Opmerking: u moet --image met informatie over de basisafbeelding die wordt gebruikt voor het maken van deze afbeelding, verstrekken.

--generate-ssh-keys

Genereer openbare en persoonlijke SSH-sleutelbestanden in de map ~/.ssh (indien ontbreekt).

--image -i

Installatie afbeelding van besturingssysteem voor clusterknooppunten. De waarde kan een alias bevatten (UbuntuLTS, UbuntuDSVM) of afbeeldingsdetails opgeven in de vorm 'publisher:offer:sku:version'. Als de configuratie van de installatie afbeelding niet wordt opgegeven via de opdrachtregel of het configuratiebestand, Batch AI standaardbesturingssysteemafbeelding kiezen.

--max

Maximum aantal knooppunten voor het cluster voor automatisch schalen.

--min

Minimum aantal knooppunten voor het cluster voor automatisch schalen.

--nfs

Naam of ARM-id van een bestandsserver die aan elk clusterknooppunt moet worden bevestigd. U moet een volledige ARM-id verstrekken als de bestandsserver tot een andere werkruimte behoort. Er kunnen meerdere NFS's worden toegevoegd met behulp van een configuratiebestand (zie de optie --config-file).

--nfs-mount-path

Relatief pad voor NFS. De NFS is beschikbaar op $AZ_BATCHAI_MOUNT_ROOT/<relative_mount_path> map.

standaardwaarde: nfs
--password -p

Optioneel wachtwoord voor het beheerdersaccount dat op elk rekenpunt moet worden gemaakt.

--setup-task

Een opdrachtregel die op elk rekenpunt moet worden uitgevoerd wanneer het is toegewezen of opnieuw is opgestart. De taak wordt uitgevoerd in een bash-subshell onder het hoofdaccount.

--setup-task-output

Mappad voor het opslaan van de logboeken van de installatietaak. Opmerking: Batch AI worden verschillende helperdirecties onder dit pad. De gemaakte directories worden gerapporteerd als stdOutErrPathSuffix door de opdracht 'az cluster show'.

--ssh-key -k

Optionele openbare SSH-sleutelwaarde of -pad. Als u dit wegwerkt en er geen wachtwoord is opgegeven, wordt de standaard-SSH-sleutel (~/.ssh/id_rsa.pub) gebruikt.

--storage-account-key

Storage accountsleutel. Vereist als het opslagaccount tot een ander abonnement behoort. Kan worden opgegeven met behulp AZURE_BATCHAI_STORAGE_KEY omgevingsvariabele.

--storage-account-name

Storage accountnaam voor Azure-bestands shares en/of Azure Storage containers die aan elk clusterknooppunt moeten worden bevestigd. Kan worden opgegeven met behulp AZURE_BATCHAI_STORAGE_ACCOUNT omgevingsvariabele.

--subnet

ARM-id van een subnet van een virtueel netwerk waarin het cluster moet worden op gezet.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met az account set -s NAME_OR_ID behulp van .

--target -t

Het aantal knooppunten dat direct na het maken van het cluster moet worden toegewezen. Als het cluster zich in de modus voor automatisch schalen heeft, kan BatchAI het aantal knooppunten later wijzigen op basis van het aantal taken dat wordt uitgevoerd en in de wachtrij wordt geplaatst.

--use-auto-storage

Indien opgegeven, maakt de opdracht een opslagaccount in een nieuwe of bestaande resourcegroep met de naam 'batchaiautostorage'. Er wordt ook een Azure-bestandsshare met de naam 'batchaishare' en een Azure Blob-container met de naam batchaicontainer. De bestands share en blobcontainer worden aan elk clusterknooppunt aan $AZ_BATCHAI_MOUNT_ROOT/autoafs en $AZ_BATCHAI_MOUNT_ROOT/autobfs toegevoegd. Als de resourcegroep al bestaat en een opslagaccount bevat dat tot dezelfde regio als het cluster behoort, wordt met deze opdracht een bestaand opslagaccount opnieuw gebruikt.

--user-name -u

De naam van het beheerdersaccount dat op elk rekenpunt moet worden gemaakt. Als de waarde niet is opgegeven en er geen gebruikersconfiguratie is opgegeven in het configuratiebestand, wordt de naam van de huidige gebruiker gebruikt.

--vm-priority

VM-prioriteit.

geaccepteerde waarden: dedicated, lowpriority
--vm-size -s

VM-grootte voor clusterknooppunten (bijvoorbeeld Standard_NC6 voor 1 GPU-knooppunt).

az batchai cluster delete

Een cluster verwijderen.

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

Voorbeelden

Verwijder een cluster en wacht tot de verwijdering is voltooid.

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

Verzend een verwijderopdracht voor een cluster en wacht niet tot de verwijdering is voltooid.

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

Verwijder het cluster zonder om bevestiging te vragen (voor niet-interactieve scenario's).

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

Optionele parameters

--ids

Een of meer resource-ID's (door spaties scheidingstekens). Dit moet een volledige resource-id zijn die alle gegevens van de argumenten 'Resource-id' bevat. U moet --id's of andere argumenten voor resource-id's verstrekken.

--name -n

Naam van cluster.

--no-wait

Wacht niet tot de langlopende bewerking is uitgevoerd.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name> .

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met az account set -s NAME_OR_ID behulp van .

--workspace -w

De naam van de werkruimte.

--yes -y

Niet vragen om bevestiging.

az batchai cluster list

Clusters op een lijst zetten.

az batchai cluster list --resource-group
                        --workspace
                        [--query-examples]
                        [--subscription]

Voorbeelden

Een lijst met alle clusters in een werkruimte maken.

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

Vereiste parameters

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name> .

--workspace -w

De naam van de werkruimte.

Optionele parameters

--query-examples

JMESPath-tekenreeks voor u aanbevelen. U kunt een van de query's kopiƫren en plakken na de parameter --query tussen dubbele aanhalingstekens om de resultaten te bekijken. U kunt een of meer positionele trefwoorden toevoegen, zodat we suggesties kunnen geven op basis van deze sleutelwoorden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met az account set -s NAME_OR_ID behulp van .

az batchai cluster resize

Het cluster het 100-00-cluster het 1000-

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

Voorbeelden

Pas de grootte van een cluster aan op nul om er niet meer voor te betalen.

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

U kunt het cluster het 10-knooppunt geven.

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

Vereiste parameters

--target -t

Doelaantal rekenknooppunten.

Optionele parameters

--ids

Een of meer resource-ID's (door spaties scheidingstekens). Dit moet een volledige resource-id zijn die alle gegevens van de argumenten 'Resource-id' bevat. U moet --id's of andere argumenten voor resource-id's verstrekken.

--name -n

Naam van cluster.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met az account set -s NAME_OR_ID behulp van .

--workspace -w

De naam van de werkruimte.

az batchai cluster show

Informatie over een cluster tonen.

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

Voorbeelden

Volledige informatie over een cluster tonen.

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

De samenvatting van het cluster tonen.

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

Optionele parameters

--ids

Een of meer resource-ID's (door spaties scheidingstekens). Dit moet een volledige resource-id zijn die alle gegevens van de argumenten 'Resource-id' bevat. U moet --id's of andere argumenten voor resource-id's verstrekken.

--name -n

Naam van cluster.

--query-examples

JMESPath-tekenreeks voor u aanbevelen. U kunt een van de query's kopiƫren en plakken na de parameter --query tussen dubbele aanhalingstekens om de resultaten te bekijken. U kunt een of meer positionele trefwoorden toevoegen, zodat we suggesties kunnen geven op basis van deze sleutelwoorden.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met az account set -s NAME_OR_ID behulp van .

--workspace -w

De naam van de werkruimte.