az batchai cluster

클러스터를 관리 하는 명령입니다.

명령

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

클러스터에 대 한 자동 크기 조정 매개 변수를 설정 합니다.

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

하나 이상의 리소스 Id (공백으로 구분)입니다. ' Resource Id ' 인수의 모든 정보를 포함 하는 전체 리소스 ID 여야 합니다. --Id 또는 다른 ' 리소스 Id ' 인수를 제공 해야 합니다.

--name -n

클러스터의 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

--subscription

구독의 이름 또는 ID입니다. 을 사용 하 여 기본 구독을 구성할 수 있습니다 az account set -s NAME_OR_ID .

--workspace -w

작업 영역의 이름입니다.

az batchai cluster create

클러스터 만들기

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]

예제

기본 이미지와 자동 저장소 계정을 사용 하 여 단일 노드 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 파일 공유의 이름입니다. --저장소-계정 이름과 함께 사용 해야 합니다. 구성 파일을 사용 하 여 여러 공유를 탑재할 수 있습니다 (--config-file 옵션 참조).

--bfs-mount-path

Azure Storage 컨테이너에 대 한 상대 탑재 경로입니다. 컨테이너는 $AZ _BATCHAI_MOUNT_ROOT/<relative_mount_path> 폴더에서 사용할 수 있습니다.

기본값: bfs
--bfs-name

각 클러스터 노드에 탑재할 Azure Storage 컨테이너의 이름입니다. --저장소-계정 이름과 함께 사용 해야 합니다. 구성 파일을 사용 하 여 여러 컨테이너를 탑재할 수 있습니다 (--config-file 옵션 참조).

--config-file -f

클러스터 생성 매개 변수를 포함 하는 json 파일에 대 한 경로입니다 (azure.mgmt.batchai의 json 표현).

--custom-image

노드를 만드는 데 사용할 가상 컴퓨터 이미지의 ARM ID입니다. 이 이미지 생성에 사용 되는 기본 이미지에 대 한 정보가 포함 된 이미지를 제공 해야 합니다.

--generate-ssh-keys

에서 SSH 공용 및 개인 키 파일을 생성 합니다 (없는 경우).

--image -i

클러스터 노드에 대 한 운영 체제 이미지입니다. 값에는 별칭 (UbuntuLTS, UbuntuDSVM)이 포함 되거나 "publisher: 제안: sku: 버전" 형식으로 이미지 세부 정보를 지정할 수 있습니다. 이미지 구성이 명령줄 또는 구성 파일을 통해 제공 되지 않는 경우 Batch AI는 기본 OS 이미지를 선택 합니다.

--max

자동 크기 조정 클러스터의 최대 노드 수입니다.

--min

자동 크기 조정 클러스터의 최소 노드 수입니다.

--nfs

각 클러스터 노드에 탑재할 파일 서버의 이름 또는 ARM ID입니다. 파일 서버가 다른 작업 영역에 속하는 경우 전체 ARM ID를 제공 해야 합니다. 구성 파일을 사용 하 여 여러 NFS를 탑재할 수 있습니다 (--config-file 옵션 참조).

--nfs-mount-path

NFS에 대 한 상대 탑재 경로입니다. NFS는 $AZ _BATCHAI_MOUNT_ROOT/<relative_mount_path> 폴더에서 사용할 수 있습니다.

기본값: nfs
--password -p

각 계산 노드에서 만들 관리 사용자 계정의 선택적 암호입니다.

--setup-task

할당 되거나 다시 부팅 될 때 각 계산 노드에서 실행 되어야 하는 명령줄입니다. 작업은 루트 계정 아래의 bash 하위 셸에서 실행 됩니다.

--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 Storage 컨테이너의 계정 이름 Storage 합니다. AZURE_BATCHAI_STORAGE_ACCOUNT 환경 변수를 사용 하 여 지정할 수 있습니다.

--subnet

클러스터를 배치할 가상 네트워크 서브넷의 ARM ID입니다.

--subscription

구독의 이름 또는 ID입니다. 을 사용 하 여 기본 구독을 구성할 수 있습니다 az account set -s NAME_OR_ID .

--target -t

클러스터를 만든 후 즉시 할당 해야 하는 노드 수입니다. 클러스터가 자동 크기 조정 모드인 경우 BatchAI는 실행 중인 작업 및 대기 중인 작업의 수에 따라 나중에 노드 수를 변경할 수 있습니다.

--use-auto-storage

제공 되는 경우이 명령은 "batchaiautostorage" 라는 새 리소스 그룹 또는 기존 리소스 그룹에 저장소 계정을 만듭니다. 또한 이름이 "batchaishare이 고 이름이" batchaicontainer "인 Azure Blob 컨테이너를 사용 하 여 Azure 파일 공유를 만듭니다. 파일 공유 및 Blob 컨테이너는 $AZ _BATCHAI_MOUNT_ROOT/autoafs 및 $AZ _BATCHAI_MOUNT_ROOT/autobfs. 각 클러스터 노드에 탑재 됩니다. 리소스 그룹이 이미 존재 하 고 클러스터와 동일한 지역에 속하는 approapriate 저장소 계정을 포함 하는 경우이 명령은 기존 저장소 계정을 다시 사용 합니다.

--user-name -u

각 계산 노드에 만들 관리 사용자 계정의 이름입니다. 값을 제공 하지 않고 구성 파일에 사용자 구성을 제공 하지 않으면 현재 사용자의 이름이 사용 됩니다.

--vm-priority

VM 우선 순위입니다.

허용되는 값: dedicated, lowpriority
--vm-size -s

클러스터 노드의 VM 크기 (예: 1 GPU 노드에 대 한 Standard_NC6).

az batchai cluster delete

클러스터를 삭제 합니다.

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

하나 이상의 리소스 Id (공백으로 구분)입니다. ' Resource Id ' 인수의 모든 정보를 포함 하는 전체 리소스 ID 여야 합니다. --Id 또는 다른 ' 리소스 Id ' 인수를 제공 해야 합니다.

--name -n

클러스터의 이름입니다.

--no-wait

장기 실행 작업이 완료될 때까지 기다리지 마세요.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

--subscription

구독의 이름 또는 ID입니다. 을 사용 하 여 기본 구독을 구성할 수 있습니다 az account set -s NAME_OR_ID .

--workspace -w

작업 영역의 이름입니다.

--yes -y

확인을 묻는 메시지를 표시하지 마세요.

az batchai cluster list

클러스터를 나열 합니다.

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

예제

작업 영역에 있는 모든 클러스터를 나열 합니다.

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

필수 매개 변수

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

--workspace -w

작업 영역의 이름입니다.

선택적 매개 변수

--query-examples

JMESPath 문자열을 권장 합니다. 쿼리 중 하나를 복사 하 여 결과를 볼 수 있도록 큰따옴표 내에서--query 매개 변수 뒤에 붙여 넣을 수 있습니다. 이러한 주요 단어를 기준으로 제안을 제공할 수 있도록 하나 이상의 위치 키워드를 추가할 수 있습니다.

--subscription

구독의 이름 또는 ID입니다. 을 사용 하 여 기본 구독을 구성할 수 있습니다 az account set -s NAME_OR_ID .

az batchai cluster resize

클러스터의 크기를 조정 합니다.

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

예제

클러스터의 크기를 0으로 조정 하 여 요금을 지불 하지 않도록 합니다.

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

하나 이상의 리소스 ID(공백으로 구분). '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.

--name -n

클러스터의 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 기본 구독을 구성할 수 az account set -s NAME_OR_ID 있습니다.

--workspace -w

작업 영역의 이름입니다.

az batchai cluster show

클러스터에 대한 정보를 표시합니다.

az batchai cluster show [--ids]
                        [--name]
                        [--query-examples]
                        [--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

하나 이상의 리소스 ID(공백으로 구분). '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.

--name -n

클러스터의 이름입니다.

--query-examples

JMESPath 문자열을 권장합니다. 쿼리 중 하나를 복사하여 큰따옴표 안에 --query 매개 변수를 붙여넣어 결과를 확인할 수 있습니다. 이러한 키워드를 기반으로 제안을 제공할 수 있도록 하나 이상의 위치 키워드를 추가할 수 있습니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 기본 구독을 구성할 수 az account set -s NAME_OR_ID 있습니다.

--workspace -w

작업 영역의 이름입니다.