az batchai cluster

此命令群組已隱含取代,因為命令群組 'batchai' 已被取代,且將在未來的版本中移除。

管理叢集的命令。

命令

名稱 Description 類型 狀態
az batchai cluster auto-scale

設定叢集的自動調整參數。

核心 已取代
az batchai cluster create

建立叢集。

核心 已取代
az batchai cluster delete

刪除叢集。

核心 已取代
az batchai cluster file

使用節點安裝工作所產生的檔案的命令。

核心 已取代
az batchai cluster file list

列出叢集節點設定工作所產生的檔案。

核心 已取代
az batchai cluster list

列出叢集。

核心 已取代
az batchai cluster node

使用叢集節點的命令。

核心 已取代
az batchai cluster node exec

在具有選擇性埠轉送的叢集節點上執行命令列。

核心 已取代
az batchai cluster node list

列出叢集節點的遠端登入資訊。

核心 已取代
az batchai cluster resize

調整叢集的大小。

核心 已取代
az batchai cluster show

顯示叢集的相關資訊。

核心 已取代

az batchai cluster auto-scale

已被取代

此命令已隱含取代,因為命令群組 'batchai' 已被取代,且將在未來的版本中移除。

設定叢集的自動調整參數。

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

範例

根據佇列和執行中作業的數目,讓叢集自動調整 0 到 10 個節點。

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

必要參數

--max

節點數目上限。

--min

節點數目下限。

選擇性參數

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源識別碼」引數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」引數。

--name -n

叢集的名稱。

--resource-group -g

資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name>

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--workspace -w

工作區的名稱。

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az batchai cluster create

已被取代

此命令已隱含取代,因為命令群組 'batchai' 已被取代,且將在未來的版本中移除。

建立叢集。

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]

範例

建立具有預設映射和自動儲存體帳戶的單一節點 GPU 叢集。

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

使用安裝命令建立叢集,以在每個節點上安裝解壓縮,命令輸出會儲存在自動儲存體帳戶 Azure 檔案共用上。

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'

手動建立提供所有參數的叢集。

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

使用組態檔建立叢集。

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

必要參數

--name -n

叢集的名稱。

--resource-group -g

資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name>

--workspace -w

工作區的名稱。

選擇性參數

--afs-mount-path

Azure 檔案共用的相對掛接路徑。 檔案共用將在 $AZ_BATCHAI_MOUNT_ROOT/ < relative_mount_path > 資料夾取得。

預設值: afs
--afs-name

要掛接在每個叢集節點上的 Azure 檔案共用名稱稱。 必須與 --storage-account-name 搭配使用。 您可以使用組態檔掛接多個共用(請參閱 --config-file 選項)。

--bfs-mount-path

Azure 儲存體容器的相對掛接路徑。 容器將在 $AZ_BATCHAI_MOUNT_ROOT/ < relative_mount_path > 資料夾使用。

預設值: bfs
--bfs-name

要掛接在每個叢集節點上Azure 儲存體容器的名稱。 必須與 --storage-account-name 搭配使用。 您可以使用組態檔掛接多個容器(請參閱 --config-file 選項)。

--config-file -f

JSON 檔案的路徑,其中包含叢集建立參數(azure.mgmt.batchai.models.ClusterCreateParameters 的 json 標記法)。

--custom-image

要用於建立節點之虛擬機器映射的 ARM 識別碼。 請注意,您必須提供 --image,其中包含用於建立此映射之基底映射的資訊。

--generate-ssh-keys

在 ~/.ssh 目錄中產生 SSH 公開和私密金鑰檔案(如果遺失)。

--image -i

叢集節點的作業系統映射。 此值可能包含別名(UbuntuLTS、UbuntuDSVM),或以 「publisher:offer:sku:version」 格式指定映射詳細資料。 如果未透過命令列或組態檔提供映射組態,Batch AI 會選擇預設的 OS 映射。

--max

自動調整叢集的最大節點計數。

--min

自動調整叢集的最小節點計數。

--nfs

要掛接在每個叢集節點上的檔案伺服器名稱或 ARM 識別碼。 如果檔案伺服器屬於不同的工作區,您必須提供完整的 ARM 識別碼。 您可以使用組態檔掛接多個 NFS(請參閱 --config-file 選項)。

--nfs-mount-path

NFS 的相對掛接路徑。 NFS 將在 $AZ_BATCHAI_MOUNT_ROOT/ < relative_mount_path > 資料夾取得。

預設值: nfs
--password -p

要在每個計算節點上建立之系統管理員使用者帳戶的選擇性密碼。

--setup-task

在配置或重新開機時,應該在每個計算節點上執行的命令列。 工作會在根帳號下的 bash 子Shell 中執行。

--setup-task-output

儲存安裝工作記錄位置的目錄路徑。 請注意,Batch AI 會在此路徑下建立數個協助程式目錄。 建立的目錄會依 'az cluster show' 命令回報為 stdOutErrPathSuffix。

--ssh-key -k

選擇性的 SSH 公開金鑰值或路徑。 如果省略且未指定任何密碼,則會使用預設 SSH 金鑰 (~/.ssh/id_rsa.pub)。

--storage-account-key

儲存體帳戶金鑰。 如果儲存體帳戶屬於不同的訂用帳戶,則為必要專案。 您可以使用AZURE_BATCHAI_STORAGE_KEY環境變數來指定。

--storage-account-name

儲存體要掛接在每個叢集節點上的 Azure 檔案共用和/或Azure 儲存體容器的帳戶名稱。 您可以使用 AZURE_BATCHAI_STORAGE_ACCOUNT 環境變數來指定。

--subnet

要放入叢集之虛擬網路子網的 ARM 識別碼。

--target -t

叢集建立後應立即配置的節點數目。 如果叢集處於自動調整模式,BatchAI 可以根據執行中和佇列作業的數目,稍後變更節點數目。

--use-auto-storage

如果提供,此命令會在名為 「batchaiautostorage」 的新或現有資源群組中建立儲存體帳戶。 它也會建立名稱為 「batchaishare」 的 Azure 檔案共用、名稱為 「batchaicontainer」 的 Azure Blob 容器。 檔案共用和 Blob 容器將會掛接在每個叢集節點上,位於 $AZ_BATCHAI_MOUNT_ROOT/autoafs 和 $AZ_BATCHAI_MOUNT_ROOT/autobfs。 如果資源群組已經存在,且包含屬於與叢集相同區域的 approapriate 儲存體帳戶,此命令將會重複使用現有的儲存體帳戶。

預設值: False
--user-name -u

要在每個計算節點上建立的系統管理使用者帳戶名稱。 如果未提供值,而且組態檔中未提供任何使用者設定,則會使用目前使用者的名稱。

--vm-priority

VM 優先順序。

接受的值: dedicated, lowpriority
--vm-size -s

叢集節點的 VM 大小(例如 1 個 GPU 節點Standard_NC6)。

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az batchai cluster delete

已被取代

此命令已隱含取代,因為命令群組 'batchai' 已被取代,且將在未來的版本中移除。

刪除叢集。

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

範例

刪除叢集,並等候刪除完成。

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

傳送叢集的刪除命令,而不要等待刪除完成。

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

刪除叢集而不要求確認 (針對非互動式案例)。

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

選擇性參數

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源識別碼」引數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」引數。

--name -n

叢集的名稱。

--no-wait

請勿等候長時間執行的作業完成。

預設值: False
--resource-group -g

資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name>

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--workspace -w

工作區的名稱。

--yes -y

不提示確認。

預設值: False
全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az batchai cluster list

已被取代

此命令已隱含取代,因為命令群組 'batchai' 已被取代,且將在未來的版本中移除。

列出叢集。

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

範例

列出工作區中的所有叢集。

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

必要參數

--resource-group -g

資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name>

--workspace -w

工作區的名稱。

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az batchai cluster resize

已被取代

此命令已隱含取代,因為命令群組 'batchai' 已被取代,且將在未來的版本中移除。

調整叢集的大小。

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

範例

將叢集大小調整為零,以停止支付費用。

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

將叢集大小調整為有 10 個節點。

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

必要參數

--target -t

計算節點的目標數目。

選擇性參數

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源識別碼」引數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」引數。

--name -n

叢集的名稱。

--resource-group -g

資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name>

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--workspace -w

工作區的名稱。

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az batchai cluster show

已被取代

此命令已隱含取代,因為命令群組 'batchai' 已被取代,且將在未來的版本中移除。

顯示叢集的相關資訊。

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

範例

顯示叢集的完整資訊。

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

顯示叢集的摘要。

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

選擇性參數

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源識別碼」引數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」引數。

--name -n

叢集的名稱。

--resource-group -g

資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name>

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--workspace -w

工作區的名稱。

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。