az batchai cluster

  • Afgeschaft
  • Referentie

Deze opdrachtgroep is impliciet afgeschaft omdat de opdrachtgroep 'batchai' is afgeschaft en in een toekomstige release wordt verwijderd.

Opdrachten voor het beheren van clusters.

Opdracht

Name Description Type Status
az batchai cluster auto-scale

Stel parameters voor automatisch schalen in voor een cluster.

 Basis Afgeschaft
az batchai cluster create

Een cluster maken.

 Basis Afgeschaft
az batchai cluster delete

Een cluster verwijderen.

 Basis Afgeschaft
az batchai cluster file

Opdrachten om te werken met bestanden die zijn gegenereerd door de knooppuntinstallatietaak.

 Basis Afgeschaft
az batchai cluster file list

Bestanden weergeven die zijn gegenereerd door de knooppuntinstallatietaak van het cluster.

 Basis Afgeschaft
az batchai cluster list

Clusters weergeven.

 Basis Afgeschaft
az batchai cluster node

Opdrachten voor het werken met clusterknooppunten.

 Basis Afgeschaft
az batchai cluster node exec

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

 Basis Afgeschaft
az batchai cluster node list

Geef externe aanmeldingsgegevens weer voor de knooppunten van het cluster.

 Basis Afgeschaft
az batchai cluster resize

Het formaat van een cluster wijzigen.

 Basis Afgeschaft
az batchai cluster show

Informatie over een cluster weergeven.

 Basis Afgeschaft

az batchai cluster auto-scale

Bewerken
Afgeschaft

Deze opdracht is impliciet afgeschaft omdat de opdrachtgroep 'batchai' is afgeschaft en in een toekomstige release wordt verwijderd.

Stel parameters voor automatisch schalen in 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 het uitvoeren van taken.

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 (met spatie gescheiden). Dit moet een volledige resource-id zijn die alle informatie over de argumenten Resource-id bevat. Geef de argumenten --id's of andere resource-id's op.

--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 behulp van az account set -s NAME_OR_ID.

--workspace -w

Naam van werkruimte.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

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

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az batchai cluster create

Bewerken
Afgeschaft

Deze opdracht is impliciet afgeschaft omdat de opdrachtgroep 'batchai' is afgeschaft en in een toekomstige release wordt verwijderd.

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

Voorbeelden

Maak een GPU-cluster met één knooppunt met standaardinstallatiekopieën en automatisch opslagaccount.

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 uitpakken op elk knooppunt wordt geïnstalleerd. De uitvoer van de opdracht wordt opgeslagen in het Azure-bestandsshare van het automatische opslagaccount.

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 met alle parameters handmatig.

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

Naam van werkruimte.

Optionele parameters

--afs-mount-path

Relatief koppelingspad voor Azure-bestandsshare. De bestandsshare is beschikbaar in $AZ_BATCHAI_MOUNT_ROOT/<relative_mount_path> map.

standaardwaarde: afs
--afs-name

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

--bfs-mount-path

Relatief koppelingspad voor Azure Storage-container. De container is beschikbaar in $AZ_BATCHAI_MOUNT_ROOT/<relative_mount_path> map.

standaardwaarde: bfs
--bfs-name

De naam van de Azure Storage-container die moet worden gekoppeld op elk clusterknooppunt. Moet worden gebruikt in combinatie met --storage-account-name. Meerdere containers kunnen worden gekoppeld 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 installatiekopie van een virtuele machine die moet worden gebruikt voor het maken van knooppunten. Opmerking: u moet --image met informatie over de basisinstallatiekopie opgeven die wordt gebruikt voor het maken van deze installatiekopie.

--generate-ssh-keys

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

--image -i

Installatiekopieën van het besturingssysteem voor clusterknooppunten. De waarde kan een alias (UbuntuLTS, UbuntuDSVM) bevatten of afbeeldingsdetails opgeven in het formulier 'publisher:offer:sku:version'. Als de installatiekopieconfiguratie niet wordt opgegeven via een opdrachtregel of configuratiebestand, kiest Batch AI de standaardinstallatiekopie van het besturingssysteem.

--max

Maximumaantal knooppunten voor het cluster voor automatisch schalen.

--min

Minimumaantal knooppunten voor het cluster voor automatisch schalen.

--nfs

Naam of ARM-id van een bestandsserver die moet worden gekoppeld op elk clusterknooppunt. U moet een volledige ARM-id opgeven als de bestandsserver deel uitmaakt van een andere werkruimte. Er kunnen meerdere NFS worden gekoppeld met behulp van een configuratiebestand (zie de optie --config-file).

--nfs-mount-path

Relatief koppelpad voor NFS. De NFS is beschikbaar in $AZ_BATCHAI_MOUNT_ROOT/<relative_mount_path> map.

standaardwaarde: nfs
--password -p

Optioneel wachtwoord voor het gebruikersaccount voor beheerders dat op elk rekenknooppunt moet worden gemaakt.

--setup-task

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

--setup-task-output

Mappad om op te slaan waar de logboeken van de installatietaak zich bevinden. Batch AI maakt verschillende helpermappen onder dit pad. De gemaakte mappen worden gerapporteerd als stdOutErrPathSuffix door de opdracht az cluster show.

--ssh-key -k

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

--storage-account-key

Sleutel van opslagaccount. Vereist als het opslagaccount deel uitmaakt van een ander abonnement. Kan worden opgegeven met behulp van AZURE_BATCHAI_STORAGE_KEY omgevingsvariabele.

--storage-account-name

De naam van het opslagaccount voor Azure-bestandsshares en/of Azure Storage-containers die op elk clusterknooppunt moeten worden gekoppeld. Kan worden opgegeven met behulp van AZURE_BATCHAI_STORAGE_ACCOUNT omgevingsvariabele.

--subnet

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

--target -t

Het aantal knooppunten dat onmiddellijk na het maken van het cluster moet worden toegewezen. Als het cluster zich in de modus voor automatisch schalen bevindt, kan BatchAI het aantal knooppunten later wijzigen op basis van het aantal actieve en in de wachtrij geplaatste taken.

--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 gemaakt met de naam 'batchaishare', Azure Blob-container met de naam 'batchaicontainer'. De bestandsshare en blobcontainer worden gekoppeld op elk clusterknooppunt op $AZ_BATCHAI_MOUNT_ROOT/autoafs en $AZ_BATCHAI_MOUNT_ROOT/autobfs. Als de resourcegroep al bestaat en een approapriate-opslagaccount bevat dat deel uitmaakt van dezelfde regio als het cluster, wordt met deze opdracht het bestaande opslagaccount opnieuw gebruikt.

standaardwaarde: False
--user-name -u

De naam van het gebruikersaccount van de beheerder dat moet worden gemaakt op elk rekenknooppunt. 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).

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

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

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az batchai cluster delete

Bewerken
Afgeschaft

Deze opdracht is impliciet afgeschaft omdat de opdrachtgroep 'batchai' is afgeschaft en in een toekomstige release wordt verwijderd.

Een cluster verwijderen.

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

Voorbeelden

Verwijder een cluster en wacht totdat het verwijderen is voltooid.

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

Verzend een verwijderopdracht voor een cluster en wacht niet totdat het verwijderen is voltooid.

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

Cluster verwijderen 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 (met spatie gescheiden). Dit moet een volledige resource-id zijn die alle informatie over de argumenten Resource-id bevat. Geef de argumenten --id's of andere resource-id's op.

--name -n

Naam van cluster.

--no-wait

Wacht niet totdat de langdurige bewerking is voltooid.

standaardwaarde: False
--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 behulp van az account set -s NAME_OR_ID.

--workspace -w

Naam van werkruimte.

--yes -y

Niet vragen om bevestiging.

standaardwaarde: False
Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

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

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az batchai cluster list

Bewerken
Afgeschaft

Deze opdracht is impliciet afgeschaft omdat de opdrachtgroep 'batchai' is afgeschaft en in een toekomstige release wordt verwijderd.

Clusters weergeven.

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

Voorbeelden

Alle clusters in een werkruimte weergeven.

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

Naam van werkruimte.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

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

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az batchai cluster resize

Bewerken
Afgeschaft

Deze opdracht is impliciet afgeschaft omdat de opdrachtgroep 'batchai' is afgeschaft en in een toekomstige release wordt verwijderd.

Het formaat van een cluster wijzigen.

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

Voorbeelden

Wijzig het formaat van een cluster in nul om te stoppen met betalen.

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

Wijzig het formaat van een cluster met 10 knooppunten.

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 (met spatie gescheiden). Dit moet een volledige resource-id zijn die alle informatie over de argumenten Resource-id bevat. Geef de argumenten --id's of andere resource-id's op.

--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 behulp van az account set -s NAME_OR_ID.

--workspace -w

Naam van werkruimte.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

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

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az batchai cluster show

Bewerken
Afgeschaft

Deze opdracht is impliciet afgeschaft omdat de opdrachtgroep 'batchai' is afgeschaft en in een toekomstige release wordt verwijderd.

Informatie over een cluster weergeven.

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

Voorbeelden

Volledige informatie over een cluster weergeven.

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

De samenvatting van het cluster weergeven.

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

Optionele parameters

--ids

Een of meer resource-id's (met spatie gescheiden). Dit moet een volledige resource-id zijn die alle informatie over de argumenten Resource-id bevat. Geef de argumenten --id's of andere resource-id's op.

--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 behulp van az account set -s NAME_OR_ID.

--workspace -w

Naam van werkruimte.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

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

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.