az batchai cluster

Polecenia do zarządzania klastrami.

Polecenia

az batchai cluster auto-scale

Ustaw parametry skalowania automatycznego dla klastra.

az batchai cluster create

Tworzenie klastra.

az batchai cluster delete

Usuń klaster.

az batchai cluster file

Polecenia do pracy z plikami wygenerowanymi przez zadanie konfiguracji węzła.

az batchai cluster file list

Wyświetl listę plików wygenerowanych przez zadanie konfiguracji węzła klastra.

az batchai cluster list

Wyświetl listę klastrów.

az batchai cluster node

Polecenia do pracy z węzłami klastra.

az batchai cluster node exec

Wykonuje wiersz polecenia w węźle klastra z opcjonalnym przekazywaniem portów.

az batchai cluster node list

Wyświetl listę informacji o zdalnym logowaniu dla węzłów klastra.

az batchai cluster resize

Zmień rozmiar klastra.

az batchai cluster show

Pokaż informacje o klastrze.

az batchai cluster auto-scale

Ustaw parametry skalowania automatycznego dla klastra.

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

Przykłady

Utwórz klaster w celu automatycznego skalowania między 0 i 10 węzłami w zależności od liczby zadań w kolejce i uruchomionych.

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

Parametry wymagane

--max

Maksymalna liczba węzłów.

--min

Minimalna liczba węzłów.

Parametry opcjonalne

--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacją). Powinien to być kompletny identyfikator zasobu zawierający wszystkie informacje o argumentach "Identyfikator zasobu". Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

--name -n

Nazwa klastra.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

--workspace -w

Nazwa obszaru roboczego.

az batchai cluster create

Tworzenie klastra.

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]

Przykłady

Utwórz pojedynczy klaster procesora GPU z domyślnym obrazem i kontem automatycznego magazynu.

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

Utwórz klaster z poleceniem konfiguracji, które instaluje rozpakuj w każdym węźle, dane wyjściowe polecenia będą przechowywane na koncie automatycznego magazynu Azure File Share.

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'

Utwórz klaster, podając wszystkie parametry ręcznie.

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

Utwórz klaster przy użyciu pliku konfiguracji.

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

Parametry wymagane

--name -n

Nazwa klastra.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

--workspace -w

Nazwa obszaru roboczego.

Parametry opcjonalne

--afs-mount-path

Względna ścieżka instalacji udziału plików platformy Azure. Udział plików będzie dostępny w folderze $AZ_BATCHAI_MOUNT_ROOT/<relative_mount_path>.

wartość domyślna: afs
--afs-name

Nazwa udziału plików platformy Azure, który ma zostać zainstalowany w każdym węźle klastra. Należy używać w połączeniu z nazwą --storage-account-name. Wiele udziałów można instalować przy użyciu pliku konfiguracji (zobacz --config-file option).

--bfs-mount-path

Względna ścieżka instalacji kontenera usługi Azure Storage. Kontener będzie dostępny w folderze $AZ_BATCHAI_MOUNT_ROOT/<relative_mount_path>.

wartość domyślna: bfs
--bfs-name

Nazwa kontenera usługi Azure Storage, który ma zostać zainstalowany w każdym węźle klastra. Należy używać w połączeniu z nazwą --storage-account-name. Wiele kontenerów można instalować przy użyciu pliku konfiguracji (zobacz --config-file option).

--config-file -f

Ścieżka do pliku json zawierającego parametry tworzenia klastra (reprezentacja pliku json azure.mgmt.batchai.models.ClusterCreateParameters).

--custom-image

Identyfikator usługi ARM obrazu maszyny wirtualnej, który ma być używany do tworzenia węzłów. Należy podać obraz zawierający informacje o obrazie podstawowym używanym do tworzenia tego obrazu.

--generate-ssh-keys

Wygeneruj pliki kluczy publicznych i prywatnych SSH w katalogu ~/.ssh (jeśli brakuje).

--image -i

Obraz systemu operacyjnego dla węzłów klastra. Wartość może zawierać alias (UbuntuLTS, UbuntuDSVM) lub określić szczegóły obrazu w formularzu "publisher:offer:sku:version". Jeśli konfiguracja obrazu nie jest dostarczana za pośrednictwem wiersza polecenia lub pliku konfiguracji, usługa Batch AI wybierze domyślny obraz systemu operacyjnego.

--max

Maksymalna liczba węzłów dla klastra automatycznego skalowania.

--min

Minimalna liczba węzłów dla klastra automatycznego skalowania.

--nfs

Nazwa lub identyfikator ARM serwera plików, który ma zostać zainstalowany w każdym węźle klastra. Należy podać pełny identyfikator usługi ARM, jeśli serwer plików należy do innego obszaru roboczego. Wiele systemu plików NFS można instalować przy użyciu pliku konfiguracji (zobacz --config-file option).

--nfs-mount-path

Względna ścieżka instalacji systemu plików NFS. System plików NFS będzie dostępny w folderze $AZ_BATCHAI_MOUNT_ROOT/<relative_mount_path>.

wartość domyślna: nfs
--password -p

Opcjonalne hasło dla konta użytkownika administratora, które ma zostać utworzone w każdym węźle obliczeniowym.

--setup-task

Wiersz polecenia, który powinien być wykonywany w każdym węźle obliczeniowym po przydzieleniu lub ponownym uruchomieniu. Zadanie jest wykonywane w subshell powłoki bash w ramach konta głównego.

--setup-task-output

Ścieżka katalogu do przechowywania dzienników zadania instalacji. Uwaga: usługa Batch AI utworzy kilka katalogów pomocników w ramach tej ścieżki. Utworzone katalogi są zgłaszane jako stdOutErrPathSuffix za pomocą polecenia "az cluster show".

--ssh-key -k

Opcjonalna wartość lub ścieżka klucza publicznego SSH. Jeśli pominięto i nie określono hasła, zostanie użyty domyślny klucz SSH (~/.ssh/id_rsa.pub).

--storage-account-key

Storage klucz konta. Wymagane, jeśli konto magazynu należy do innej subskrypcji. Można określić przy użyciu zmiennej środowiskowej AZURE_BATCHAI_STORAGE_KEY.

--storage-account-name

Storage nazwę konta dla udziałów plików platformy Azure i/lub kontenerów usługi Azure Storage, które mają być instalowane w każdym węźle klastra. Można określić przy użyciu zmiennej środowiskowej AZURE_BATCHAI_STORAGE_ACCOUNT.

--subnet

Identyfikator usługi ARM podsieci sieci wirtualnej, w których ma być umieszczony klaster.

--target -t

Liczba węzłów, które powinny być przydzielane natychmiast po utworzeniu klastra. Jeśli klaster jest w trybie automatycznego skalowania, usługa BatchAI może później zmienić liczbę węzłów na podstawie liczby uruchomionych i w kolejce zadań.

--use-auto-storage

Jeśli zostanie podane, polecenie utworzy konto magazynu w nowej lub istniejącej grupie zasobów o nazwie "batchaiautostorage". Spowoduje to również utworzenie udziału plików platformy Azure o nazwie "batchaishare", kontenera obiektów blob platformy Azure o nazwie "batchaicontainer". Udział plików i kontener obiektów blob zostaną zainstalowane w każdym węźle klastra w lokalizacji $AZ_BATCHAI_MOUNT_ROOT/autoafs i $AZ_BATCHAI_MOUNT_ROOT/autobfs. Jeśli grupa zasobów już istnieje i zawiera konto magazynu approapriate należące do tego samego regionu co klaster, to polecenie ponownie użyje istniejącego konta magazynu.

--user-name -u

Nazwa konta użytkownika administratora do utworzenia w każdym węźle obliczeniowym. Jeśli wartość nie zostanie podana i nie zostanie podana żadna konfiguracja użytkownika w pliku konfiguracji, zostanie użyta nazwa bieżącego użytkownika.

--vm-priority

Priorytet maszyny wirtualnej.

akceptowane wartości: dedicated, lowpriority
--vm-size -s

Rozmiar maszyny wirtualnej dla węzłów klastra (np. Standard_NC6 dla 1 węzła procesora GPU).

az batchai cluster delete

Usuń klaster.

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

Przykłady

Usuń klaster i poczekaj na zakończenie usuwania.

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

Wyślij polecenie usuwania dla klastra i nie czekaj na zakończenie usuwania.

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

Usuń klaster bez monitowania o potwierdzenie (w przypadku scenariuszy nieinterakcyjnych).

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

Parametry opcjonalne

--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacją). Powinien to być kompletny identyfikator zasobu zawierający wszystkie informacje o argumentach "Identyfikator zasobu". Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

--name -n

Nazwa klastra.

--no-wait

Nie czekaj na zakończenie długotrwałej operacji.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

--workspace -w

Nazwa obszaru roboczego.

--yes -y

Nie monituj o potwierdzenie.

az batchai cluster list

Wyświetl listę klastrów.

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

Przykłady

Wyświetl listę wszystkich klastrów w obszarze roboczym.

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

Parametry wymagane

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

--workspace -w

Nazwa obszaru roboczego.

az batchai cluster resize

Zmień rozmiar klastra.

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

Przykłady

Zmień rozmiar klastra na zero, aby przestać za nie płacić.

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

Zmień rozmiar klastra na 10 węzłów.

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

Parametry wymagane

--target -t

Docelowa liczba węzłów obliczeniowych.

Parametry opcjonalne

--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacją). Powinien to być kompletny identyfikator zasobu zawierający wszystkie informacje o argumentach "Identyfikator zasobu". Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

--name -n

Nazwa klastra.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

--workspace -w

Nazwa obszaru roboczego.

az batchai cluster show

Pokaż informacje o klastrze.

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

Przykłady

Pokaż pełne informacje o klastrze.

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

Pokaż podsumowanie klastra.

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

Parametry opcjonalne

--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). Powinien on być kompletnym identyfikatorem zasobu zawierającym wszystkie informacje o argumentach "Identyfikator zasobu". Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

--name -n

Nazwa klastra.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

--workspace -w

Nazwa obszaru roboczego.