다음을 통해 공유


az aks nodepool

참고 항목

이 명령 그룹에는 Azure CLI 및 하나 이상의 확장 모두에 정의된 명령이 있습니다. 확장된 기능을 활용하려면 각 확장을 설치합니다. 확장 프로그램에 대해 자세히 알아보세요.

Kubernetes kubernetes 클러스터에서 노드 풀을 관리하는 명령입니다.

명령

Name Description 형식 상태
az aks nodepool add

관리되는 Kubernetes 클러스터에 노드 풀을 추가합니다.

핵심 GA
az aks nodepool add (aks-preview 확장)

관리되는 Kubernetes 클러스터에 노드 풀을 추가합니다.

내선 번호 GA
az aks nodepool delete

관리되는 Kubernetes 클러스터에서 에이전트 풀을 삭제합니다.

핵심 GA
az aks nodepool delete (aks-preview 확장)

관리되는 Kubernetes 클러스터에서 에이전트 풀을 삭제합니다.

내선 번호 GA
az aks nodepool delete-machines

관리되는 클러스터에 대한 에이전트 풀에서 특정 머신을 삭제합니다.

핵심 GA
az aks nodepool delete-machines (aks-preview 확장)

관리되는 클러스터에 대한 에이전트 풀에서 특정 머신을 삭제합니다.

내선 번호 GA
az aks nodepool get-upgrades

관리되는 Kubernetes 클러스터의 에이전트 풀에 사용 가능한 업그레이드 버전을 가져옵니다.

핵심 GA
az aks nodepool get-upgrades (aks-preview 확장)

관리되는 Kubernetes 클러스터의 에이전트 풀에 사용 가능한 업그레이드 버전을 가져옵니다.

내선 번호 GA
az aks nodepool list

관리되는 Kubernetes 클러스터의 노드 풀을 나열합니다. 클러스터 실행 kubectl get nodes 명령에서 노드 목록을 가져옵니다.

핵심 GA
az aks nodepool list (aks-preview 확장)

관리되는 Kubernetes 클러스터의 노드 풀을 나열합니다.

내선 번호 GA
az aks nodepool manual-scale

nodepool virtualMachineProfile.scale.manual을 관리하는 명령입니다.

내선 번호 GA
az aks nodepool manual-scale add

관리되는 Kubernetes 클러스터의 VirtualMachines 에이전트 풀에 새 설명서를 추가합니다.

내선 번호 GA
az aks nodepool manual-scale delete

관리되는 Kubernetes 클러스터의 VirtualMachines 에이전트 풀에 대한 기존 설명서를 삭제합니다.

내선 번호 GA
az aks nodepool manual-scale update

관리되는 Kubernetes 클러스터에서 VirtualMachines 에이전트 풀의 기존 설명서를 업데이트합니다.

내선 번호 GA
az aks nodepool operation-abort

nodepool에서 마지막 실행 작업을 중단합니다.

핵심 GA
az aks nodepool operation-abort (aks-preview 확장)

nodepool에서 마지막 실행 작업을 중단합니다.

내선 번호 GA
az aks nodepool scale

관리되는 Kubernetes 클러스터에서 노드 풀의 크기를 조정합니다.

핵심 GA
az aks nodepool scale (aks-preview 확장)

관리되는 Kubernetes 클러스터에서 노드 풀의 크기를 조정합니다.

내선 번호 GA
az aks nodepool show

관리되는 Kubernetes 클러스터의 노드 풀에 대한 세부 정보를 표시합니다.

핵심 GA
az aks nodepool show (aks-preview 확장)

관리되는 Kubernetes 클러스터의 노드 풀에 대한 세부 정보를 표시합니다.

내선 번호 GA
az aks nodepool snapshot

nodepool 스냅샷을 관리하는 명령입니다.

코어 및 확장 GA
az aks nodepool snapshot create

nodepool 스냅샷을 만듭니다.

핵심 GA
az aks nodepool snapshot create (aks-preview 확장)

nodepool 스냅샷을 만듭니다.

내선 번호 GA
az aks nodepool snapshot delete

nodepool 스냅샷을 삭제합니다.

핵심 GA
az aks nodepool snapshot delete (aks-preview 확장)

nodepool 스냅샷을 삭제합니다.

내선 번호 GA
az aks nodepool snapshot list

nodepool 스냅샷을 나열합니다.

핵심 GA
az aks nodepool snapshot list (aks-preview 확장)

nodepool 스냅샷을 나열합니다.

내선 번호 GA
az aks nodepool snapshot show

nodepool 스냅샷의 세부 정보를 표시합니다.

핵심 GA
az aks nodepool snapshot show (aks-preview 확장)

nodepool 스냅샷의 세부 정보를 표시합니다.

내선 번호 GA
az aks nodepool snapshot update

nodepool의 스냅샷에서 태그를 업데이트합니다.

핵심 GA
az aks nodepool snapshot update (aks-preview 확장)

nodepool의 스냅샷에서 태그를 업데이트합니다.

내선 번호 GA
az aks nodepool snapshot wait

nodepool 스냅샷이 원하는 상태에 도달할 때까지 기다립니다.

핵심 GA
az aks nodepool start

관리되는 Kubernetes 클러스터에서 중지된 에이전트 풀을 시작합니다.

핵심 GA
az aks nodepool start (aks-preview 확장)

관리되는 Kubernetes 클러스터에서 중지된 에이전트 풀을 시작합니다.

내선 번호 GA
az aks nodepool stop

관리되는 Kubernetes 클러스터에서 에이전트 풀 실행을 중지합니다.

핵심 GA
az aks nodepool stop (aks-preview 확장)

관리되는 Kubernetes 클러스터에서 에이전트 풀 실행을 중지합니다.

내선 번호 GA
az aks nodepool update

노드 풀 속성을 업데이트합니다.

핵심 GA
az aks nodepool update (aks-preview 확장)

노드 풀 속성을 업데이트합니다.

내선 번호 GA
az aks nodepool upgrade

관리되는 Kubernetes 클러스터에서 노드 풀을 업그레이드합니다.

핵심 GA
az aks nodepool upgrade (aks-preview 확장)

관리되는 Kubernetes 클러스터에서 노드 풀을 업그레이드합니다.

내선 번호 GA
az aks nodepool wait

노드 풀이 원하는 상태에 도달할 때까지 기다립니다.

핵심 GA

az aks nodepool add

관리되는 Kubernetes 클러스터에 노드 풀을 추가합니다.

az aks nodepool add --cluster-name
                    --name
                    --resource-group
                    [--aks-custom-headers]
                    [--allowed-host-ports]
                    [--asg-ids]
                    [--crg-id]
                    [--disable-windows-outbound-nat]
                    [--drain-timeout]
                    [--enable-cluster-autoscaler]
                    [--enable-encryption-at-host]
                    [--enable-fips-image]
                    [--enable-node-public-ip]
                    [--enable-secure-boot]
                    [--enable-ultra-ssd]
                    [--enable-vtpm]
                    [--eviction-policy {Deallocate, Delete}]
                    [--gpu-instance-profile {MIG1g, MIG2g, MIG3g, MIG4g, MIG7g}]
                    [--host-group-id]
                    [--kubelet-config]
                    [--kubernetes-version]
                    [--labels]
                    [--linux-os-config]
                    [--max-count]
                    [--max-pods]
                    [--max-surge]
                    [--min-count]
                    [--mode {System, User}]
                    [--no-wait]
                    [--node-count]
                    [--node-osdisk-size]
                    [--node-osdisk-type {Ephemeral, Managed}]
                    [--node-public-ip-prefix-id]
                    [--node-public-ip-tags]
                    [--node-soak-duration]
                    [--node-taints]
                    [--node-vm-size]
                    [--os-sku {AzureLinux, CBLMariner, Mariner, Ubuntu, Windows2019, Windows2022}]
                    [--os-type]
                    [--pod-subnet-id]
                    [--ppg]
                    [--priority {Regular, Spot}]
                    [--scale-down-mode {Deallocate, Delete}]
                    [--snapshot-id]
                    [--spot-max-price]
                    [--tags]
                    [--vnet-subnet-id]
                    [--zones]

예제

임시 os를 사용하도록 설정된 기존 AKS 클러스터에서 nodepool을 만듭니다.

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --node-osdisk-type Ephemeral --node-osdisk-size 48

EncryptionAtHost를 사용하도록 설정된 nodepool을 만듭니다.

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --enable-encryption-at-host

UltraSSD를 사용하도록 설정된 nodepool을 만듭니다.

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --enable-ultra-ssd

특정 OS SKU를 사용하여 nodepool 클러스터 만들기

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --os-sku Ubuntu

FIPS 사용 OS를 사용하여 nodepool 만들기

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --enable-fips-image

스냅샷 ID를 사용하여 kubernetes 클러스터를 만듭니다.

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --kubernetes-version 1.20.9 --snapshot-id "/subscriptions/00000/resourceGroups/AnotherResourceGroup/providers/Microsoft.ContainerService/snapshots/mysnapshot1"

호스트 그룹 ID를 사용하여 기존 AKS 클러스터에서 nodepool 만들기

az aks nodepool add -g MyResourceGroup -n MyNodePool --cluster-name MyMC --host-group-id /subscriptions/00000/resourceGroups/AnotherResourceGroup/providers/Microsoft.ContainerService/hostGroups/myHostGroup --node-vm-size VMSize

CRG(용량 예약 그룹) ID를 사용하여 nodepool을 만듭니다.

az aks nodepool add -g MyResourceGroup -n MyNodePool --cluster-name MyMC --node-vm-size VMSize --crg-id "/subscriptions/SubID/resourceGroups/ResourceGroupName/providers/Microsoft.ContainerService/CapacityReservationGroups/MyCRGID"

필수 매개 변수

--cluster-name

클러스터 이름입니다.

--name --nodepool-name -n

노드 풀 이름입니다.

--resource-group -g

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

선택적 매개 변수

--aks-custom-headers

사용자 지정 헤더를 지정하는 쉼표로 구분된 키-값 쌍입니다.

--allowed-host-ports

노드 풀에 호스트 포트를 노출합니다. 지정한 경우 형식은 프로토콜이 있는 공백으로 구분된 범위 목록이어야 합니다. 예를 들면 다음과 같습니다. 80/TCP 443/TCP 4000-5000/TCP.

--asg-ids

노드 풀의 네트워크 인터페이스가 속해야 하는 애플리케이션 보안 그룹의 ID입니다. 지정된 경우 형식은 공백으로 구분된 ID 목록이어야 합니다.

--crg-id

새 nodepool을 기존 용량 예약 그룹 리소스와 연결하는 데 사용되는 crg ID입니다.

--disable-windows-outbound-nat

Windows 에이전트 노드 풀에서 Windows OutboundNAT를 사용하지 않도록 설정합니다.

Default value: False
--drain-timeout

노드가 모든 Pod가 제거될 때까지 대기하는 시간(분)을 드레이닝하는 경우

--enable-cluster-autoscaler -e

클러스터 자동 크기 조정기를 사용하도록 설정합니다.

Default value: False
--enable-encryption-at-host

EncryptionAtHost를 사용하도록 설정합니다. 기본값은 false입니다.

Default value: False
--enable-fips-image

에이전트 노드에서 FIPS 사용 OS를 사용합니다.

Default value: False
--enable-node-public-ip

VMSS 노드 공용 IP를 사용하도록 설정합니다.

Default value: False
--enable-secure-boot

에이전트 노드 풀에서 보안 부팅을 사용하도록 설정합니다. VMSS 에이전트 풀 유형을 사용해야 합니다.

Default value: False
--enable-ultra-ssd

UltraSSD를 사용하도록 설정하면 기본값이 false입니다.

Default value: False
--enable-vtpm

에이전트 노드 풀에서 vTPM을 사용하도록 설정합니다. VMSS 에이전트 풀 유형을 사용해야 합니다.

Default value: False
--eviction-policy

스폿 노드 풀의 제거 정책입니다. --priority가 Spot인 경우에만 설정할 수 있습니다.

허용되는 값: Deallocate, Delete
Default value: Delete
--gpu-instance-profile

다중 gpu Nvidia GPU를 분할하는 GPU 인스턴스 프로필입니다.

허용되는 값: MIG1g, MIG2g, MIG3g, MIG4g, MIG7g
--host-group-id

에이전트 노드 풀을 프로비전하는 데 사용되는 정규화된 전용 호스트 그룹 ID입니다.

--kubelet-config

에이전트 노드에 대한 Kubelet 구성을 포함하는 JSON 파일의 경로입니다. https://aka.ms/aks/custom-node-config.

--kubernetes-version -k

클러스터를 만드는 데 사용할 Kubernetes 버전(예: "1.16.9")입니다.

다음의 값: `az aks get-versions`
--labels

노드 풀에 대한 노드 레이블입니다. 레이블 구문을 참조 https://aka.ms/node-labels 하세요.

--linux-os-config

Linux 에이전트 노드에 대한 OS 구성을 포함하는 JSON 파일의 경로입니다. https://aka.ms/aks/custom-node-config.

--max-count

"--enable-cluster-autoscaler"가 지정된 경우 자동 크기 조정기에서 사용되는 최대 노드 수입니다. 사용자 노드 풀의 경우 [0, 1000] 범위의 값을 지정하고 시스템 노드 풀의 경우 [1,1000]을 지정하세요.

--max-pods -m

노드에 배포할 수 있는 최대 Pod 수입니다.

지정하지 않으면 기본적으로 네트워크 플러그 인을 기반으로 합니다. "azure"의 경우 30, "kubenet"의 경우 110, "none"의 경우 250입니다.

--max-surge

업그레이드 속도를 높이기 위해 사용되는 추가 노드입니다. 지정하면 사용된 수 또는 백분율을 나타냅니다. 예를 들면 다음과 같습니다. 5 또는 33%.

--min-count

"--enable-cluster-autoscaler"가 지정된 경우 자동 크기 조정기에서 사용되는 최소 노드 수입니다. 사용자 노드 풀의 경우 [0, 1000] 범위의 값을 지정하고 시스템 노드 풀의 경우 [1,1000]을 지정하세요.

--mode

노드 풀의 기본 함수를 정의하는 노드 풀의 모드입니다. "시스템"으로 설정된 경우 AKS는 모드 System가 있는 노드 풀로 예약하는 시스템 Pod를 선호합니다. https://aka.ms/aks/nodepool/mode에서 자세히 알아보세요.

허용되는 값: System, User
Default value: User
--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

Default value: False
--node-count -c

Kubernetes 에이전트 풀의 노드 수입니다. 클러스터를 만든 후 .를 사용하여 노드 풀 az aks scale의 크기를 변경할 수 있습니다.

Default value: 3
--node-osdisk-size

에이전트 풀의 각 노드에 대한 OS 디스크의 GiB 크기입니다. 최소 30GiB.

--node-osdisk-type

지정된 에이전트 풀의 컴퓨터에 사용할 OS 디스크 유형입니다. VM 크기 및 OS 디스크 크기와 함께 가능하면 기본적으로 '사용 후 삭제'로 설정됩니다. 만든 후 이 풀에 대해 변경할 수 없습니다. ('임시' 또는 '관리됨').

허용되는 값: Ephemeral, Managed
--node-public-ip-prefix-id

공용 IP를 VMSS 노드에 할당하는 데 사용되는 공용 IP 접두사 ID입니다.

--node-public-ip-tags

노드 공용 IP의 ipTags입니다.

--node-soak-duration

노드를 드레이닝한 후 다시 이미지로 다시 설치하고 다음 노드로 이동하기 전에 대기할 시간(분)입니다.

--node-taints

노드 풀에 대한 노드가 오염됩니다.

--node-vm-size -s

Kubernetes 노드로 만들 Virtual Machines의 크기입니다.

--os-sku

에이전트 노드 풀의 OS SKU입니다. Linux용 Ubuntu 또는 CBLMariner. Windows 2019 또는 Windows2022.

허용되는 값: AzureLinux, CBLMariner, Mariner, Ubuntu, Windows2019, Windows2022
--os-type

OS 유형입니다. Linux 또는 Windows.

--pod-subnet-id

클러스터에서 Pod를 할당할 기존 VNet에 있는 서브넷의 리소스 ID입니다(Azure 네트워크 플러그 인 필요).

--ppg

PPG의 ID입니다.

--priority

노드 풀의 우선 순위입니다.

허용되는 값: Regular, Spot
Default value: Regular
--scale-down-mode

노드 풀에 VM을 추가하거나 제거하는 방법을 설명합니다.

허용되는 값: Deallocate, Delete
Default value: Delete
--snapshot-id

이 nodepool을 만드는 데 사용되는 원본 스냅샷 ID입니다.

--spot-max-price

--priority가 Spot인 경우에만 설정할 수 있습니다. 미국 달러로 지불할 최대 가격을 지정합니다. 가능한 값은 기본 가격이 주문형으로 설정됨을 나타내는 0 또는 -1보다 큰 소수 값입니다. 최대 5개의 소수 자릿수만 포함할 수 있습니다.

Default value: nan
--tags

공백으로 구분된 태그: key[=value] [key[=value] ...]. ""를 사용하여 기존 태그를 지웁니다.

--vnet-subnet-id

클러스터를 배포할 기존 VNet에 있는 서브넷의 리소스 ID입니다.

--zones -z

에이전트 노드가 배치될 가용성 영역입니다. 또한 둘 이상의 영역에 에이전트 노드를 설치하려면 공백으로 구분된 영역 번호를 전달해야 합니다. 예를 들어 3개의 영역이 모두 있으면 입력 --zones 1 2 3해야 합니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az aks nodepool add (aks-preview 확장)

관리되는 Kubernetes 클러스터에 노드 풀을 추가합니다.

az aks nodepool add --cluster-name
                    --name
                    --resource-group
                    [--aks-custom-headers]
                    [--allowed-host-ports]
                    [--asg-ids]
                    [--crg-id]
                    [--disable-windows-outbound-nat]
                    [--drain-timeout]
                    [--driver-type {CUDA, GRID}]
                    [--enable-artifact-streaming]
                    [--enable-cluster-autoscaler]
                    [--enable-custom-ca-trust]
                    [--enable-encryption-at-host]
                    [--enable-fips-image]
                    [--enable-node-public-ip]
                    [--enable-secure-boot]
                    [--enable-ultra-ssd]
                    [--enable-vtpm]
                    [--eviction-policy {Deallocate, Delete}]
                    [--gateway-prefix-size]
                    [--gpu-instance-profile {MIG1g, MIG2g, MIG3g, MIG4g, MIG7g}]
                    [--host-group-id]
                    [--if-match]
                    [--if-none-match]
                    [--kubelet-config]
                    [--kubernetes-version]
                    [--labels]
                    [--linux-os-config]
                    [--max-count]
                    [--max-pods]
                    [--max-surge]
                    [--message-of-the-day]
                    [--min-count]
                    [--mode {Gateway, System, User}]
                    [--no-wait]
                    [--node-count]
                    [--node-osdisk-size]
                    [--node-osdisk-type {Ephemeral, Managed}]
                    [--node-public-ip-prefix-id]
                    [--node-public-ip-tags]
                    [--node-soak-duration]
                    [--node-taints]
                    [--node-vm-size]
                    [--os-sku {AzureLinux, CBLMariner, Mariner, Ubuntu, Windows2019, Windows2022, WindowsAnnual}]
                    [--os-type]
                    [--pod-ip-allocation-mode {DynamicIndividual, StaticBlock}]
                    [--pod-subnet-id]
                    [--ppg]
                    [--priority {Regular, Spot}]
                    [--scale-down-mode {Deallocate, Delete}]
                    [--skip-gpu-driver-install]
                    [--snapshot-id]
                    [--spot-max-price]
                    [--ssh-access {disabled, localuser}]
                    [--tags]
                    [--undrainable-node-behavior]
                    [--vm-set-type]
                    [--vm-sizes]
                    [--vnet-subnet-id]
                    [--workload-runtime {KataCcIsolation, KataMshvVmIsolation, OCIContainer, WasmWasi}]
                    [--zones]

예제

임시 os를 사용하도록 설정된 기존 AKS 클러스터에서 nodepool을 만듭니다.

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --node-osdisk-type Ephemeral --node-osdisk-size 48

EncryptionAtHost를 사용하도록 설정된 nodepool을 만듭니다.

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --enable-encryption-at-host

특정 os-sku를 사용하여 nodepool 만들기

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster  --os-sku Ubuntu

wasm 워크로드를 실행할 수 있는 nodepool을 만듭니다.

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster  --workload-runtime WasmWasi

스냅샷 ID를 사용하여 kubernetes 클러스터를 만듭니다.

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --kubernetes-version 1.20.9 --snapshot-id "/subscriptions/00000/resourceGroups/AnotherResourceGroup/providers/Microsoft.ContainerService/snapshots/mysnapshot1"

CRG(용량 예약 그룹) ID를 사용하여 nodepool을 만듭니다.

az aks nodepool add -g MyResourceGroup -n MyNodePool --cluster-name MyMC --node-vm-size VMSize --crg-id "/subscriptions/SubID/resourceGroups/ResourceGroupName/providers/Microsoft.ContainerService/CapacityReservationGroups/MyCRGID"

호스트 그룹 ID를 사용하여 기존 AKS 클러스터에서 nodepool 만들기

az aks nodepool add -g MyResourceGroup -n MyNodePool --cluster-name MyMC --host-group-id /subscriptions/00000/resourceGroups/AnotherResourceGroup/providers/Microsoft.ContainerService/hostGroups/myHostGroup --node-vm-size VMSize

IP 할당 모드가 "StaticBlock"으로 설정되고 Pod 서브넷 ID를 사용하여 nodepool 만들기

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster  --os-sku Ubuntu --pod-subnet-id /subscriptions/00000/resourceGroups/AnotherResourceGroup/providers/Microsoft.Network/virtualNetworks/MyVnet/subnets/MySubnet --pod-ip-allocation-mode StaticBlock

VirtualMachines 형식의 nodepool 만들기

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --vm-set-type VirtualMachines --vm-sizes "Standard_D4s_v3,Standard_D8s_v3" --node-count 3

필수 매개 변수

--cluster-name

클러스터 이름입니다.

--name --nodepool-name -n

노드 풀 이름입니다.

--resource-group -g

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

선택적 매개 변수

--aks-custom-headers

사용자 지정 헤더를 보냅니다. 지정된 경우 형식은 Key1=Value1,Key2=Value2여야 합니다.

--allowed-host-ports
미리 보기

노드 풀에 호스트 포트를 노출합니다. 지정된 경우 형식은 프로토콜이 있는 범위의 쉼표로 구분된 목록이어야 합니다. 예를 들면 다음과 같습니다. 80/TCP,443/TCP,4000-5000/TCP. VMSS 에이전트 풀 유형을 사용해야 합니다.

--asg-ids
미리 보기

노드 풀의 네트워크 인터페이스가 속해야 하는 애플리케이션 보안 그룹의 ID입니다. 지정된 경우 형식은 쉼표로 구분된 ID 목록이어야 합니다. VMSS 에이전트 풀 유형을 사용해야 합니다.

--crg-id
미리 보기

새 nodepool을 기존 용량 예약 그룹 리소스와 연결하는 데 사용되는 crg-id입니다. VMSS 에이전트 풀 유형을 사용해야 합니다.

--disable-windows-outbound-nat

Windows 에이전트 노드 풀에서 Windows OutboundNAT를 사용하지 않도록 설정합니다. VMSS 에이전트 풀 유형을 사용해야 합니다.

Default value: False
--drain-timeout

노드가 모든 Pod가 제거될 때까지 대기하는 시간(분)을 드레이닝하는 경우

--driver-type
미리 보기

Windows 에이전트 풀을 만들 때 설치할 GPU 드라이버 유형을 지정합니다. 유효한 값은 "GRID" 및 "CUDA"입니다. 제공되지 않은 경우 AKS는 시스템 호환성에 따라 드라이버를 선택합니다. AgentPool을 만든 후에는 이 옵션을 변경할 수 없습니다. 기본값은 시스템이 선택된 것입니다.

허용되는 값: CUDA, GRID
--enable-artifact-streaming
미리 보기

노드 풀에서 관리하는 VirtualMachineScaleSets에 아티팩트 스트리밍을 사용하도록 설정하여 주문형 이미지 로드를 통해 노드에서 컨테이너의 콜드 시작 속도를 향상합니다. 이 기능을 사용하려면 컨테이너 이미지도 ACR에서 아티팩트 스트리밍을 사용하도록 설정해야 합니다. 지정하지 않으면 기본값은 false입니다.

Default value: False
--enable-cluster-autoscaler -e

클러스터 자동 크기 조정기를 사용하도록 설정합니다. VMSS 에이전트 풀 유형을 사용해야 합니다.

Default value: False
--enable-custom-ca-trust

에이전트 노드 풀에서 사용자 지정 CA 트러스트를 사용하도록 설정합니다.

Default value: False
--enable-encryption-at-host

에이전트 노드 풀에서 EncryptionAtHost를 사용하도록 설정합니다.

Default value: False
--enable-fips-image

에이전트 노드에서 FIPS 사용 OS를 사용합니다.

Default value: False
--enable-node-public-ip

VMSS 노드 공용 IP를 사용하도록 설정합니다. VMSS 에이전트 풀 유형을 사용해야 합니다.

Default value: False
--enable-secure-boot
미리 보기

에이전트 노드 풀에서 보안 부팅을 사용하도록 설정합니다. VMSS 에이전트 풀 유형을 사용해야 합니다.

Default value: False
--enable-ultra-ssd

에이전트 노드 풀에서 UltraSSD를 사용하도록 설정합니다. VMSS 에이전트 풀 유형을 사용해야 합니다.

Default value: False
--enable-vtpm
미리 보기

에이전트 노드 풀에서 vTPM을 사용하도록 설정합니다. VMSS 에이전트 풀 유형을 사용해야 합니다.

Default value: False
--eviction-policy

스폿 노드 풀의 제거 정책입니다. --priority가 Spot인 경우에만 설정할 수 있습니다.

허용되는 값: Deallocate, Delete
Default value: Delete
--gateway-prefix-size
미리 보기

게이트웨이 모드 노드 풀에 연결된 공용 IPPrefix의 크기입니다. 노드 풀은 게이트웨이 모드여야 합니다.

--gpu-instance-profile

다중 gpu Nvidia GPU를 분할하는 GPU 인스턴스 프로필입니다.

허용되는 값: MIG1g, MIG2g, MIG3g, MIG4g, MIG7g
--host-group-id

(미리 보기) 에이전트 노드 풀을 프로비전하는 데 사용되는 정규화된 전용 호스트 그룹 ID입니다. VMSS 에이전트 풀 유형을 사용해야 합니다.

--if-match

제공된 값은 에이전트 풀의 ETag와 비교됩니다. 일치하는 경우 작업이 진행됩니다. 일치하지 않으면 실수로 덮어쓰기를 방지하기 위해 요청이 거부됩니다. 새 에이전트 풀을 만들 때 지정해서는 안 됩니다.

--if-none-match

새 에이전트 풀을 만들 수 있지만 기존 에이전트 풀을 업데이트하지 않도록 하려면 '*'로 설정합니다. 다른 값은 무시됩니다.

--kubelet-config

에이전트 노드에 대한 Kubelet 구성입니다.

--kubernetes-version -k

클러스터를 만드는 데 사용할 Kubernetes 버전(예: "1.7.12" 또는 "1.8.7")입니다.

다음의 값: `az aks get-versions`
--labels

노드 풀에 대한 노드 레이블입니다. 레이블 구문을 참조 https://aka.ms/node-labels 하세요.

--linux-os-config

Linux 에이전트 노드에 대한 OS 구성입니다.

--max-count

"--enable-cluster-autoscaler"가 지정된 경우 자동 크기 조정기에서 사용되는 최대 노드 수입니다. 사용자 노드 풀의 경우 [0, 1000] 범위의 값을 지정하고 시스템 노드 풀의 경우 [1,1000]을 지정하세요.

--max-pods -m

노드에 배포할 수 있는 최대 Pod 수입니다.

지정하지 않으면 기본적으로 네트워크 플러그 인을 기반으로 합니다. "azure"의 경우 30, "kubenet"의 경우 110, "none"의 경우 250입니다.

Default value: 0
--max-surge

업그레이드 속도를 높이기 위해 사용되는 추가 노드입니다. 지정하면 사용된 수 또는 백분율을 나타냅니다. 예를 들면 다음과 같습니다. 5 또는 33%.

--message-of-the-day

원하는 날짜 메시지가 포함된 파일의 경로입니다. Linux 노드에만 유효합니다. /etc/motd에 기록됩니다.

--min-count

"--enable-cluster-autoscaler"가 지정된 경우 자동 크기 조정기에서 사용되는 미니문 노드 수입니다. 사용자 노드 풀의 경우 [0, 1000] 범위의 값을 지정하고 시스템 노드 풀의 경우 [1,1000]을 지정하세요.

--mode

노드 풀의 기본 함수를 정의하는 노드 풀의 모드입니다. "시스템"으로 설정된 경우 AKS는 모드 System가 있는 노드 풀로 예약하는 시스템 Pod를 선호합니다. https://aka.ms/aks/nodepool/mode에서 자세히 알아보세요.

허용되는 값: Gateway, System, User
Default value: User
--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

Default value: False
--node-count -c

Kubernetes 에이전트 풀의 노드 수입니다. 클러스터를 만든 후 .를 사용하여 노드 풀 az aks scale의 크기를 변경할 수 있습니다.

Default value: 3
--node-osdisk-size

에이전트 풀의 각 노드에 대한 OS 디스크의 GiB 크기입니다. 최소 30GiB.

Default value: 0
--node-osdisk-type

지정된 에이전트 풀의 컴퓨터에 사용할 OS 디스크 유형입니다. VM 크기 및 OS 디스크 크기와 함께 가능하면 기본적으로 '사용 후 삭제'로 설정됩니다. 만든 후 이 풀에 대해 변경할 수 없습니다. ('임시' 또는 '관리됨').

허용되는 값: Ephemeral, Managed
--node-public-ip-prefix-id

공용 IP를 VMSS 노드에 할당하는 데 사용되는 공용 IP 접두사 ID입니다. VMSS 에이전트 풀 유형을 사용해야 합니다.

--node-public-ip-tags

노드 공용 IP의 ipTags입니다. VMSS 에이전트 풀 유형을 사용해야 합니다.

--node-soak-duration

노드를 드레이닝한 후 다시 이미지로 다시 설치하고 다음 노드로 이동하기 전에 대기할 시간(분)입니다.

--node-taints

노드 풀에 대한 노드가 오염됩니다.

--node-vm-size -s

Kubernetes 노드로 만들 Virtual Machines의 크기입니다.

--os-sku

에이전트 노드 풀의 os-sku입니다. os-type이 Linux인 경우 Ubuntu 또는 CBLMariner, 설정되지 않은 경우 기본값은 Ubuntu입니다. Os 유형이 Windows인 경우 Windows2019, Windows2022 또는 WindowsAnnual, 현재 기본값은 설정되지 않은 경우 Windows2022입니다.

허용되는 값: AzureLinux, CBLMariner, Mariner, Ubuntu, Windows2019, Windows2022, WindowsAnnual
--os-type

OS 유형입니다. Linux 또는 Windows. Windows는 "VirtualMachines" VM 집합 형식에 대해 아직 지원되지 않습니다.

--pod-ip-allocation-mode

Azure Pod 서브넷의 Pod IP가 AKS 클러스터의 노드에 할당되는 방식에 대한 IP 할당 모드를 설정합니다. 개별 IP의 동적 일괄 처리 또는 CIDR 블록 집합의 정적 할당 중에서 선택할 수 있습니다. 허용되는 값은 "DynamicIndividual" 또는 "StaticBlock"입니다.

"azure" 네트워크 플러그 인과 함께 사용됩니다. --pod-subnet-id가 필요합니다.

허용되는 값: DynamicIndividual, StaticBlock
--pod-subnet-id

클러스터에서 Pod를 할당할 기존 VNet의 서브넷 ID입니다(Azure 네트워크 플러그 인 필요).

--ppg

PPG의 ID입니다. VMSS 에이전트 풀 유형을 사용해야 합니다.

--priority

노드 풀의 우선 순위입니다.

허용되는 값: Regular, Spot
Default value: Regular
--scale-down-mode

노드 풀에 VM을 추가하거나 제거하는 방법을 설명합니다.

허용되는 값: Deallocate, Delete
Default value: Delete
--skip-gpu-driver-install
미리 보기

고객이 GPU 드라이버 설치를 직접 관리하려는 경우 GPU vm 크기를 사용하여 노드 풀에서 AKS에서 GPU 드라이버 자동 설치를 건너뛰려면 지정하지 않으면 기본값은 false입니다.

Default value: False
--snapshot-id

이 nodepool을 만드는 데 사용되는 원본 스냅샷 ID입니다. VMSS 에이전트 풀 유형을 사용해야 합니다.

--spot-max-price

--priority가 Spot인 경우에만 설정할 수 있습니다. 미국 달러로 지불할 최대 가격을 지정합니다. 가능한 값은 기본 가격이 주문형으로 설정됨을 나타내는 0 또는 -1보다 큰 소수 값입니다. 최대 5개의 소수 자릿수만 포함할 수 있습니다.

Default value: nan
--ssh-access
미리 보기

노드 풀에 대한 SSH 설정을 구성합니다. "disabled"를 사용하여 SSH 액세스를 사용하지 않도록 설정합니다. "localuser"는 프라이빗 키를 사용하여 SSH 액세스를 사용하도록 설정합니다.

허용되는 값: disabled, localuser
Default value: localuser
--tags

공백으로 구분된 태그: key[=value] [key[=value] ...]. ""를 사용하여 기존 태그를 지웁니다.

--undrainable-node-behavior

업그레이드하는 동안 표시할 수 없는 노드에 대한 동작을 정의합니다. 값은 "Cordon" 또는 "Schedule"이어야 합니다. 기본값은 "Schedule"입니다.

--vm-set-type

에이전트 풀 vm 집합 유형입니다. VirtualMachineScaleSets, AvailabilitySet 또는 VirtualMachines(미리 보기).

--vm-sizes
미리 보기

쉼표로 구분된 크기 목록입니다. VirtualMachines 에이전트 풀 유형을 사용해야 합니다.

--vnet-subnet-id

클러스터를 배포하는 기존 VNet의 서브넷 ID입니다.

--workload-runtime

노드에서 실행할 수 있는 워크로드 유형을 결정합니다. 기본값은 OCIContainer입니다.

허용되는 값: KataCcIsolation, KataMshvVmIsolation, OCIContainer, WasmWasi
Default value: OCIContainer
--zones -z

에이전트 노드가 배치될 가용성 영역의 공간으로 구분된 목록입니다. VMSS 에이전트 풀 유형을 사용해야 합니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az aks nodepool delete

관리되는 Kubernetes 클러스터에서 에이전트 풀을 삭제합니다.

az aks nodepool delete --cluster-name
                       --name
                       --resource-group
                       [--no-wait]

필수 매개 변수

--cluster-name

클러스터 이름입니다.

--name --nodepool-name -n

노드 풀 이름입니다.

--resource-group -g

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

선택적 매개 변수

--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

Default value: False
전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az aks nodepool delete (aks-preview 확장)

관리되는 Kubernetes 클러스터에서 에이전트 풀을 삭제합니다.

az aks nodepool delete --cluster-name
                       --name
                       --resource-group
                       [--if-match]
                       [--ignore-pod-disruption-budget]
                       [--no-wait]

예제

ignore-pod-disruption-budget을 사용하여 에이전트 풀 삭제

az aks nodepool delete --resource-group MyResourceGroup --cluster-name MyManagedCluster --name nodepool1 --ignore-pod-disruption-budget=true

필수 매개 변수

--cluster-name

클러스터 이름입니다.

--name --nodepool-name -n

노드 풀 이름입니다.

--resource-group -g

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

선택적 매개 변수

--if-match

제공된 값은 노드 풀의 ETag와 비교되며, 일치하는 경우 작업이 진행됩니다. 일치하지 않으면 실수로 덮어쓰기를 방지하기 위해 요청이 거부됩니다. 새 에이전트 풀을 만들 때 지정해서는 안 됩니다.

--ignore-pod-disruption-budget -i
미리 보기

(미리 보기) ignore-pod-disruption-budget은 Pod 중단 예산을 고려하지 않고 기존 노드 풀을 삭제합니다.

--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

Default value: False
전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az aks nodepool delete-machines

관리되는 클러스터에 대한 에이전트 풀에서 특정 머신을 삭제합니다.

az aks nodepool delete-machines --cluster-name
                                --machine-names
                                --name
                                --resource-group
                                [--no-wait]

예제

에이전트 풀에서 특정 컴퓨터 삭제

az aks nodepool delete-machines -g myResourceGroup --nodepool-name nodepool1 --cluster-name myAKSCluster --machine-names machine1

필수 매개 변수

--cluster-name

클러스터 이름입니다.

--machine-names

삭제할 에이전트 풀에서 컴퓨터 이름의 공백으로 구분된 목록입니다.

--name --nodepool-name -n

노드 풀 이름입니다.

--resource-group -g

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

선택적 매개 변수

--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

Default value: False
전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az aks nodepool delete-machines (aks-preview 확장)

관리되는 클러스터에 대한 에이전트 풀에서 특정 머신을 삭제합니다.

az aks nodepool delete-machines --cluster-name
                                --machine-names
                                --name
                                --resource-group
                                [--no-wait]

예제

에이전트 풀에서 특정 컴퓨터 삭제

az aks nodepool delete-machines -g myResourceGroup --nodepool-name nodepool1 --cluster-name myAKSCluster --machine-names machine1

필수 매개 변수

--cluster-name

클러스터 이름입니다.

--machine-names

삭제할 에이전트 풀에서 컴퓨터 이름의 공백으로 구분된 목록입니다.

--name --nodepool-name -n

노드 풀 이름입니다.

--resource-group -g

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

선택적 매개 변수

--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

Default value: False
전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az aks nodepool get-upgrades

관리되는 Kubernetes 클러스터의 에이전트 풀에 사용 가능한 업그레이드 버전을 가져옵니다.

az aks nodepool get-upgrades --cluster-name
                             --name
                             --resource-group

예제

관리되는 Kubernetes 클러스터의 에이전트 풀에 사용 가능한 업그레이드 버전을 가져옵니다.

az aks nodepool get-upgrades --resource-group MyResourceGroup --cluster-name MyManagedCluster --nodepool-name MyNodePool

필수 매개 변수

--cluster-name

클러스터 이름입니다.

--name --nodepool-name -n

노드 풀 이름입니다.

--resource-group -g

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

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az aks nodepool get-upgrades (aks-preview 확장)

관리되는 Kubernetes 클러스터의 에이전트 풀에 사용 가능한 업그레이드 버전을 가져옵니다.

az aks nodepool get-upgrades --cluster-name
                             --name
                             --resource-group

예제

관리되는 Kubernetes 클러스터의 에이전트 풀에 사용 가능한 업그레이드 버전을 가져옵니다.

az aks nodepool get-upgrades --resource-group MyResourceGroup --cluster-name MyManagedCluster --nodepool-name MyNodePool

필수 매개 변수

--cluster-name

클러스터 이름입니다.

--name --nodepool-name -n

노드 풀 이름입니다.

--resource-group -g

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

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az aks nodepool list

관리되는 Kubernetes 클러스터의 노드 풀을 나열합니다. 클러스터 실행 kubectl get nodes 명령에서 노드 목록을 가져옵니다.

az aks nodepool list --cluster-name
                     --resource-group

필수 매개 변수

--cluster-name

클러스터 이름입니다.

--resource-group -g

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

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az aks nodepool list (aks-preview 확장)

관리되는 Kubernetes 클러스터의 노드 풀을 나열합니다.

az aks nodepool list --cluster-name
                     --resource-group

필수 매개 변수

--cluster-name

클러스터 이름입니다.

--resource-group -g

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

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az aks nodepool operation-abort

nodepool에서 마지막 실행 작업을 중단합니다.

az aks nodepool operation-abort --cluster-name
                                --name
                                --resource-group
                                [--no-wait]

예제

에이전트 풀에서 작업 중단

az aks nodepool operation-abort -g myResourceGroup --nodepool-name nodepool1 --cluster-name myAKSCluster

필수 매개 변수

--cluster-name

클러스터 이름입니다.

--name --nodepool-name -n

노드 풀 이름입니다.

--resource-group -g

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

선택적 매개 변수

--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

Default value: False
전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az aks nodepool operation-abort (aks-preview 확장)

nodepool에서 마지막 실행 작업을 중단합니다.

az aks nodepool operation-abort --cluster-name
                                --name
                                --resource-group
                                [--aks-custom-headers]
                                [--no-wait]

예제

에이전트 풀에서 작업 중단

az aks nodepool operation-abort -g myResourceGroup --nodepool-name nodepool1 --cluster-name myAKSCluster

필수 매개 변수

--cluster-name

클러스터 이름입니다.

--name --nodepool-name -n

노드 풀 이름입니다.

--resource-group -g

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

선택적 매개 변수

--aks-custom-headers

사용자 지정 헤더를 보냅니다. 지정된 경우 형식은 Key1=Value1,Key2=Value2여야 합니다.

--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

Default value: False
전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az aks nodepool scale

관리되는 Kubernetes 클러스터에서 노드 풀의 크기를 조정합니다.

az aks nodepool scale --cluster-name
                      --name
                      --resource-group
                      [--no-wait]
                      [--node-count]

필수 매개 변수

--cluster-name

클러스터 이름입니다.

--name --nodepool-name -n

노드 풀 이름입니다.

--resource-group -g

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

선택적 매개 변수

--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

Default value: False
--node-count -c

Kubernetes 노드 풀의 노드 수입니다.

Default value: 3
전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az aks nodepool scale (aks-preview 확장)

관리되는 Kubernetes 클러스터에서 노드 풀의 크기를 조정합니다.

az aks nodepool scale --cluster-name
                      --name
                      --resource-group
                      [--aks-custom-headers]
                      [--no-wait]
                      [--node-count]

필수 매개 변수

--cluster-name

클러스터 이름입니다.

--name --nodepool-name -n

노드 풀 이름입니다.

--resource-group -g

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

선택적 매개 변수

--aks-custom-headers

사용자 지정 헤더를 보냅니다. 지정된 경우 형식은 Key1=Value1,Key2=Value2여야 합니다.

--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

Default value: False
--node-count -c

Kubernetes 노드 풀의 노드 수입니다.

Default value: 3
전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az aks nodepool show

관리되는 Kubernetes 클러스터의 노드 풀에 대한 세부 정보를 표시합니다.

az aks nodepool show --cluster-name
                     --name
                     --resource-group

필수 매개 변수

--cluster-name

클러스터 이름입니다.

--name --nodepool-name -n

노드 풀 이름입니다.

--resource-group -g

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

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az aks nodepool show (aks-preview 확장)

관리되는 Kubernetes 클러스터의 노드 풀에 대한 세부 정보를 표시합니다.

az aks nodepool show --cluster-name
                     --name
                     --resource-group

필수 매개 변수

--cluster-name

클러스터 이름입니다.

--name --nodepool-name -n

노드 풀 이름입니다.

--resource-group -g

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

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az aks nodepool start

관리되는 Kubernetes 클러스터에서 중지된 에이전트 풀을 시작합니다.

az aks nodepool start --cluster-name
                      --name
                      --resource-group
                      [--aks-custom-headers]
                      [--no-wait]

예제

관리되는 클러스터에서 에이전트 풀 시작

az aks nodepool start --nodepool-name nodepool1 -g MyResourceGroup --cluster-name MyManagedCluster

필수 매개 변수

--cluster-name

클러스터 이름입니다.

--name --nodepool-name -n

노드 풀 이름입니다.

--resource-group -g

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

선택적 매개 변수

--aks-custom-headers

사용자 지정 헤더를 보냅니다. 지정된 경우 형식은 Key1=Value1,Key2=Value2여야 합니다.

--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

Default value: False
전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az aks nodepool start (aks-preview 확장)

관리되는 Kubernetes 클러스터에서 중지된 에이전트 풀을 시작합니다.

az aks nodepool start --cluster-name
                      --name
                      --resource-group
                      [--aks-custom-headers]
                      [--no-wait]

예제

관리되는 클러스터에서 에이전트 풀 시작

az aks nodepool start --nodepool-name nodepool1 -g MyResourceGroup --cluster-name MyManagedCluster

필수 매개 변수

--cluster-name

클러스터 이름입니다.

--name --nodepool-name -n

노드 풀 이름입니다.

--resource-group -g

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

선택적 매개 변수

--aks-custom-headers

사용자 지정 헤더를 보냅니다. 지정된 경우 형식은 Key1=Value1,Key2=Value2여야 합니다.

--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

Default value: False
전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az aks nodepool stop

관리되는 Kubernetes 클러스터에서 에이전트 풀 실행을 중지합니다.

az aks nodepool stop --cluster-name
                     --name
                     --resource-group
                     [--aks-custom-headers]
                     [--no-wait]

예제

관리되는 클러스터에서 에이전트 풀 중지

az aks nodepool stop --nodepool-name nodepool1 -g MyResourceGroup --cluster-name MyManagedCluster

필수 매개 변수

--cluster-name

클러스터 이름입니다.

--name --nodepool-name -n

노드 풀 이름입니다.

--resource-group -g

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

선택적 매개 변수

--aks-custom-headers

사용자 지정 헤더를 보냅니다. 지정된 경우 형식은 Key1=Value1,Key2=Value2여야 합니다.

--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

Default value: False
전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az aks nodepool stop (aks-preview 확장)

관리되는 Kubernetes 클러스터에서 에이전트 풀 실행을 중지합니다.

az aks nodepool stop --cluster-name
                     --name
                     --resource-group
                     [--aks-custom-headers]
                     [--no-wait]

예제

관리되는 클러스터에서 에이전트 풀 중지

az aks nodepool stop --nodepool-name nodepool1 -g MyResourceGroup --cluster-name MyManagedCluster

필수 매개 변수

--cluster-name

클러스터 이름입니다.

--name --nodepool-name -n

노드 풀 이름입니다.

--resource-group -g

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

선택적 매개 변수

--aks-custom-headers

사용자 지정 헤더를 보냅니다. 지정된 경우 형식은 Key1=Value1,Key2=Value2여야 합니다.

--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

Default value: False
전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az aks nodepool update

노드 풀 속성을 업데이트합니다.

클러스터 자동 크기 조정기를 사용/사용하지 않도록 설정하거나 최소 개수 또는 최대 개수를 변경하도록 노드 풀을 업데이트합니다. 선택적 인수 없이 호출되는 경우 현재 노드 풀 구성을 변경하지 않고 노드 풀을 목표 상태로 이동하려고 시도합니다. 성공하지 못한 상태에서 이동하는 데 사용할 수 있습니다.

az aks nodepool update --cluster-name
                       --name
                       --resource-group
                       [--aks-custom-headers]
                       [--allowed-host-ports]
                       [--asg-ids]
                       [--disable-cluster-autoscaler]
                       [--disable-fips-image]
                       [--disable-secure-boot]
                       [--disable-vtpm]
                       [--drain-timeout]
                       [--enable-cluster-autoscaler]
                       [--enable-fips-image]
                       [--enable-secure-boot]
                       [--enable-vtpm]
                       [--labels]
                       [--max-count]
                       [--max-surge]
                       [--min-count]
                       [--mode {System, User}]
                       [--no-wait]
                       [--node-soak-duration]
                       [--node-taints]
                       [--os-sku {AzureLinux, CBLMariner, Mariner}]
                       [--scale-down-mode {Deallocate, Delete}]
                       [--tags]
                       [--update-cluster-autoscaler]

예제

nodepool을 현재 상태로 다시 조정합니다.

az aks nodepool update -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster

노드 수 범위 내에서 클러스터 자동 크기 조정기 사용 [1,5]

az aks nodepool update --enable-cluster-autoscaler --min-count 1 --max-count 5 -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster

기존 클러스터에 대해 클러스터 자동 크기 조정기 사용 안 함

az aks nodepool update --disable-cluster-autoscaler -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster

클러스터 자동 크기 조정기에서 최소 개수 또는 최대 개수를 업데이트합니다.

az aks nodepool update --update-cluster-autoscaler --min-count 1 --max-count 10 -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster

필수 매개 변수

--cluster-name

클러스터 이름입니다.

--name --nodepool-name -n

노드 풀 이름입니다.

--resource-group -g

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

선택적 매개 변수

--aks-custom-headers

사용자 지정 헤더를 지정하는 쉼표로 구분된 키-값 쌍입니다.

--allowed-host-ports

노드 풀에 호스트 포트를 노출합니다. 지정한 경우 형식은 프로토콜이 있는 공백으로 구분된 범위 목록이어야 합니다. 예를 들면 다음과 같습니다. 80/TCP 443/TCP 4000-5000/TCP.

--asg-ids

노드 풀의 네트워크 인터페이스가 속해야 하는 애플리케이션 보안 그룹의 ID입니다. 지정된 경우 형식은 공백으로 구분된 ID 목록이어야 합니다.

--disable-cluster-autoscaler -d

클러스터 자동 크기 조정기를 사용하지 않도록 설정합니다.

Default value: False
--disable-fips-image

에이전트 노드에서 FIPS 사용이 아닌 OS를 사용하도록 전환합니다.

Default value: False
--disable-secure-boot

기존 신뢰할 수 있는 시작이 설정된 에이전트 노드 풀에서 보안 부팅을 사용하지 않도록 설정합니다.

Default value: False
--disable-vtpm

기존 신뢰할 수 있는 시작이 설정된 에이전트 노드 풀에서 vTPM을 사용하지 않도록 설정합니다.

Default value: False
--drain-timeout

노드가 모든 Pod가 제거될 때까지 대기하는 시간(분)을 드레이닝하는 경우

--enable-cluster-autoscaler -e

클러스터 자동 크기 조정기를 사용하도록 설정합니다.

Default value: False
--enable-fips-image

에이전트 노드에서 FIPS 사용 OS를 사용하도록 전환합니다.

Default value: False
--enable-secure-boot

기존 신뢰할 수 있는 시작이 설정된 에이전트 노드 풀에서 보안 부팅을 사용하도록 설정합니다. VMSS 에이전트 풀 유형을 사용해야 합니다.

Default value: False
--enable-vtpm

기존 신뢰할 수 있는 시작이 설정된 에이전트 노드 풀에서 vTPM을 사용하도록 설정합니다. VMSS 에이전트 풀 유형을 사용해야 합니다.

Default value: False
--labels

노드 풀에 대한 노드 레이블입니다. 레이블 구문을 참조 https://aka.ms/node-labels 하세요.

--max-count

"--enable-cluster-autoscaler"가 지정된 경우 자동 크기 조정기에서 사용되는 최대 노드 수입니다. 사용자 노드 풀의 경우 [0, 1000] 범위의 값을 지정하고 시스템 노드 풀의 경우 [1,1000]을 지정하세요.

--max-surge

업그레이드 속도를 높이기 위해 사용되는 추가 노드입니다. 지정하면 사용된 수 또는 백분율을 나타냅니다. 예를 들면 다음과 같습니다. 5 또는 33%.

--min-count

"--enable-cluster-autoscaler"가 지정된 경우 자동 크기 조정기에서 사용되는 최소 노드 수입니다. 사용자 노드 풀의 경우 [0, 1000] 범위의 값을 지정하고 시스템 노드 풀의 경우 [1,1000]을 지정하세요.

--mode

노드 풀의 기본 함수를 정의하는 노드 풀의 모드입니다. "시스템"으로 설정된 경우 AKS는 모드 System가 있는 노드 풀로 예약하는 시스템 Pod를 선호합니다. https://aka.ms/aks/nodepool/mode에서 자세히 알아보세요.

허용되는 값: System, User
--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

Default value: False
--node-soak-duration

노드를 드레이닝한 후 다시 이미지로 다시 설치하고 다음 노드로 이동하기 전에 대기할 시간(분)입니다.

--node-taints

노드 풀에 대한 노드가 오염됩니다. nodepool의 기존 노드 taint를 업데이트하거나 nodepool에 대한 새 노드 taint를 만들 수 있습니다. 빈 문자열 "" 을 전달하여 모든 taint를 제거합니다.

--os-sku

에이전트 노드 풀의 os-sku입니다.

허용되는 값: AzureLinux, CBLMariner, Mariner
--scale-down-mode

노드 풀에 VM을 추가하거나 제거하는 방법을 설명합니다.

허용되는 값: Deallocate, Delete
--tags

공백으로 구분된 태그: key[=value] [key[=value] ...]. ""를 사용하여 기존 태그를 지웁니다.

--update-cluster-autoscaler -u

클러스터 자동 크기 조정기에서 최소 개수 또는 최대 개수를 업데이트합니다.

Default value: False
전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az aks nodepool update (aks-preview 확장)

노드 풀 속성을 업데이트합니다.

클러스터 자동 크기 조정기를 사용/사용하지 않도록 설정하거나 최소 개수 또는 최대 개수를 변경하도록 노드 풀을 업데이트합니다. 선택적 인수 없이 호출되는 경우 현재 노드 풀 구성을 변경하지 않고 노드 풀을 목표 상태로 이동하려고 시도합니다. 성공하지 못한 상태에서 이동하는 데 사용할 수 있습니다.

az aks nodepool update --cluster-name
                       --name
                       --resource-group
                       [--aks-custom-headers]
                       [--allowed-host-ports]
                       [--asg-ids]
                       [--dcat]
                       [--disable-cluster-autoscaler]
                       [--disable-fips-image]
                       [--disable-secure-boot]
                       [--disable-vtpm]
                       [--drain-timeout]
                       [--enable-artifact-streaming]
                       [--enable-cluster-autoscaler]
                       [--enable-custom-ca-trust]
                       [--enable-fips-image]
                       [--enable-secure-boot]
                       [--enable-vtpm]
                       [--if-match]
                       [--if-none-match]
                       [--labels]
                       [--max-count]
                       [--max-surge]
                       [--min-count]
                       [--mode {Gateway, System, User}]
                       [--no-wait]
                       [--node-soak-duration]
                       [--node-taints]
                       [--os-sku {AzureLinux, Ubuntu}]
                       [--scale-down-mode {Deallocate, Delete}]
                       [--ssh-access {disabled, localuser}]
                       [--tags]
                       [--undrainable-node-behavior]
                       [--update-cluster-autoscaler]
                       [--yes]

예제

nodepool을 현재 상태로 다시 조정합니다.

az aks nodepool update -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster

노드 수 범위 내에서 클러스터 자동 크기 조정기 사용 [1,5]

az aks nodepool update --enable-cluster-autoscaler --min-count 1 --max-count 5 -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster

기존 클러스터에 대해 클러스터 자동 크기 조정기 사용 안 함

az aks nodepool update --disable-cluster-autoscaler -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster

클러스터 자동 크기 조정기에서 최소 개수 또는 최대 개수를 업데이트합니다.

az aks nodepool update --update-cluster-autoscaler --min-count 1 --max-count 10 -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster

노드 풀을 시스템 모드로 변경

az aks nodepool update --mode System -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster

필수 매개 변수

--cluster-name

클러스터 이름입니다.

--name --nodepool-name -n

노드 풀 이름입니다.

--resource-group -g

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

선택적 매개 변수

--aks-custom-headers

사용자 지정 헤더를 보냅니다. 지정된 경우 형식은 Key1=Value1,Key2=Value2여야 합니다.

--allowed-host-ports
미리 보기

노드 풀에 호스트 포트를 노출합니다. 지정된 경우 형식은 프로토콜이 있는 범위의 쉼표로 구분된 목록이어야 합니다. 예를 들면 다음과 같습니다. 80/TCP,443/TCP,4000-5000/TCP. VMSS 에이전트 풀 유형을 사용해야 합니다.

--asg-ids
미리 보기

노드 풀의 네트워크 인터페이스가 속해야 하는 애플리케이션 보안 그룹의 ID입니다. 지정된 경우 형식은 쉼표로 구분된 ID 목록이어야 합니다. VMSS 에이전트 풀 유형을 사용해야 합니다.

--dcat --disable-custom-ca-trust

에이전트 노드 풀에서 사용자 지정 CA 트러스트를 사용하지 않도록 설정합니다.

Default value: False
--disable-cluster-autoscaler -d

클러스터 자동 크기 조정기를 사용하지 않도록 설정합니다.

Default value: False
--disable-fips-image

에이전트 노드에서 FIPS 사용이 아닌 OS를 사용하도록 전환합니다.

Default value: False
--disable-secure-boot
미리 보기

기존 신뢰할 수 있는 시작이 설정된 에이전트 노드 풀에서 보안 부팅을 사용하지 않도록 설정합니다.

Default value: False
--disable-vtpm
미리 보기

기존 신뢰할 수 있는 시작이 설정된 에이전트 노드 풀에서 vTPM을 사용하지 않도록 설정합니다.

Default value: False
--drain-timeout

노드가 모든 Pod가 제거될 때까지 대기하는 시간(분)을 드레이닝하는 경우

--enable-artifact-streaming
미리 보기

노드 풀에서 관리하는 VirtualMachineScaleSets에 아티팩트 스트리밍을 사용하도록 설정하여 주문형 이미지 로드를 통해 노드에서 컨테이너의 콜드 시작 속도를 향상합니다. 이 기능을 사용하려면 컨테이너 이미지도 ACR에서 아티팩트 스트리밍을 사용하도록 설정해야 합니다. 지정하지 않으면 기본값은 false입니다.

Default value: False
--enable-cluster-autoscaler -e

클러스터 자동 크기 조정기를 사용하도록 설정합니다. VMSS 에이전트 풀 유형을 사용해야 합니다.

Default value: False
--enable-custom-ca-trust

에이전트 노드 풀에서 사용자 지정 CA 트러스트를 사용하도록 설정합니다.

Default value: False
--enable-fips-image

에이전트 노드에서 FIPS 사용 OS를 사용하도록 전환합니다.

Default value: False
--enable-secure-boot
미리 보기

기존 신뢰할 수 있는 시작이 설정된 에이전트 노드 풀에서 보안 부팅을 사용하도록 설정합니다. VMSS 에이전트 풀 유형을 사용해야 합니다.

Default value: False
--enable-vtpm
미리 보기

기존 신뢰할 수 있는 시작이 설정된 에이전트 노드 풀에서 vTPM을 사용하도록 설정합니다. VMSS 에이전트 풀 유형을 사용해야 합니다.

Default value: False
--if-match

제공된 값은 노드 풀의 ETag와 비교되며, 일치하는 경우 작업이 진행됩니다. 일치하지 않으면 실수로 덮어쓰기를 방지하기 위해 요청이 거부됩니다. 새 에이전트 풀을 만들 때 지정해서는 안 됩니다.

--if-none-match

새 노드 풀을 만들 수 있지만 기존 노드 풀을 업데이트하지 않도록 하려면 '*'로 설정합니다. 다른 값은 무시됩니다.

--labels

노드 풀에 대한 노드 레이블입니다. 레이블 구문을 참조 https://aka.ms/node-labels 하세요.

--max-count

"--enable-cluster-autoscaler"가 지정된 경우 자동 크기 조정기에서 사용되는 최대 노드 수입니다. 사용자 노드 풀의 경우 [0, 1000] 범위의 값을 지정하고 시스템 노드 풀의 경우 [1,1000]을 지정하세요.

--max-surge

업그레이드 속도를 높이기 위해 사용되는 추가 노드입니다. 지정하면 사용된 수 또는 백분율을 나타냅니다. 예를 들면 다음과 같습니다. 5 또는 33%.

--min-count

"--enable-cluster-autoscaler"가 지정된 경우 자동 크기 조정기에서 사용되는 미니문 노드 수입니다. 사용자 노드 풀의 경우 [0, 1000] 범위의 값을 지정하고 시스템 노드 풀의 경우 [1,1000]을 지정하세요.

--mode

노드 풀의 기본 함수를 정의하는 노드 풀의 모드입니다. "시스템"으로 설정된 경우 AKS는 모드 System가 있는 노드 풀로 예약하는 시스템 Pod를 선호합니다. https://aka.ms/aks/nodepool/mode에서 자세히 알아보세요.

허용되는 값: Gateway, System, User
--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

Default value: False
--node-soak-duration

노드를 드레이닝한 후 다시 이미지로 다시 설치하고 다음 노드로 이동하기 전에 대기할 시간(분)입니다.

--node-taints

노드 풀에 대한 노드가 오염됩니다.

--os-sku

에이전트 노드 풀의 os-sku입니다.

허용되는 값: AzureLinux, Ubuntu
--scale-down-mode

노드 풀에 VM을 추가하거나 제거하는 방법을 설명합니다.

허용되는 값: Deallocate, Delete
--ssh-access
미리 보기

노드 풀에 대한 SSH 설정을 업데이트합니다. "disabled"를 사용하여 SSH 액세스를 사용하지 않도록 설정합니다. "localuser"는 프라이빗 키를 사용하여 SSH 액세스를 사용하도록 설정합니다.

허용되는 값: disabled, localuser
--tags

공백으로 구분된 태그: key[=value] [key[=value] ...]. ""를 사용하여 기존 태그를 지웁니다.

--undrainable-node-behavior

업그레이드하는 동안 표시할 수 없는 노드에 대한 동작을 정의합니다. 값은 "Cordon" 또는 "Schedule"이어야 합니다. 기본값은 "Schedule"입니다.

--update-cluster-autoscaler -u

클러스터 자동 크기 조정기에서 최소 개수 또는 최대 개수를 업데이트합니다.

Default value: False
--yes -y

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

Default value: False
전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az aks nodepool upgrade

관리되는 Kubernetes 클러스터에서 노드 풀을 업그레이드합니다.

az aks nodepool upgrade --cluster-name
                        --name
                        --resource-group
                        [--aks-custom-headers]
                        [--drain-timeout]
                        [--kubernetes-version]
                        [--max-surge]
                        [--no-wait]
                        [--node-image-only]
                        [--node-soak-duration]
                        [--snapshot-id]
                        [--yes]

필수 매개 변수

--cluster-name

클러스터 이름입니다.

--name --nodepool-name -n

노드 풀 이름입니다.

--resource-group -g

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

선택적 매개 변수

--aks-custom-headers

사용자 지정 헤더를 지정하는 쉼표로 구분된 키-값 쌍입니다.

--drain-timeout

노드가 모든 Pod가 제거될 때까지 대기하는 시간을 드레이닝하는 경우.

--kubernetes-version -k

노드 풀을 업그레이드할 Kubernetes 버전(예: "1.16.9").

--max-surge

업그레이드 속도를 높이기 위해 사용되는 추가 노드입니다. 지정하면 사용된 수 또는 백분율을 나타냅니다. 예를 들면 다음과 같습니다. 5 또는 33%("--node-image-only"와 함께 사용할 수 없습니다. "--node-image-only"로 업그레이드하기 전에 최대 서지를 업데이트하려면 "az aks nodepool update --max-surge"를 참조하세요.

--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

Default value: False
--node-image-only

에이전트 풀의 노드 이미지만 업그레이드합니다.

Default value: False
--node-soak-duration

노드를 드레이닝한 후 다시 이미지로 다시 설치하고 다음 노드로 이동하기 전에 대기할 시간(분)입니다.

--snapshot-id

이 nodepool을 업그레이드하는 데 사용되는 원본 스냅샷 ID입니다.

--yes -y

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

Default value: False
전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az aks nodepool upgrade (aks-preview 확장)

관리되는 Kubernetes 클러스터에서 노드 풀을 업그레이드합니다.

az aks nodepool upgrade --cluster-name
                        --name
                        --resource-group
                        [--aks-custom-headers]
                        [--drain-timeout]
                        [--if-match]
                        [--if-none-match]
                        [--kubernetes-version]
                        [--max-surge]
                        [--no-wait]
                        [--node-image-only]
                        [--node-soak-duration]
                        [--snapshot-id]
                        [--undrainable-node-behavior]
                        [--yes]

필수 매개 변수

--cluster-name

클러스터 이름입니다.

--name --nodepool-name -n

노드 풀 이름입니다.

--resource-group -g

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

선택적 매개 변수

--aks-custom-headers

사용자 지정 헤더를 보냅니다. 지정된 경우 형식은 Key1=Value1,Key2=Value2여야 합니다.

--drain-timeout

노드가 모든 Pod가 제거될 때까지 대기하는 시간(분)을 드레이닝하는 경우

--if-match

제공된 값은 노드 풀의 ETag와 비교되며, 일치하는 경우 작업이 진행됩니다. 일치하지 않으면 실수로 덮어쓰기를 방지하기 위해 요청이 거부됩니다. 새 에이전트 풀을 만들 때 지정해서는 안 됩니다. 업그레이드 노드 이미지 버전 요청의 경우 무시됩니다.

--if-none-match

새 노드 풀을 만들 수 있지만 기존 노드 풀을 업데이트하지 않도록 하려면 '*'로 설정합니다. 다른 값은 무시됩니다.

--kubernetes-version -k

노드 풀을 업그레이드할 Kubernetes 버전(예: "1.11.12").

--max-surge

업그레이드 속도를 높이기 위해 사용되는 추가 노드입니다. 지정하면 사용된 수 또는 백분율을 나타냅니다. 예를 들면 다음과 같습니다. 5 또는 33%.

--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

Default value: False
--node-image-only

에이전트 풀의 노드 이미지만 업그레이드합니다.

Default value: False
--node-soak-duration

노드를 드레이닝한 후 다시 이미지로 다시 설치하고 다음 노드로 이동하기 전에 대기할 시간(분)입니다.

--snapshot-id

이 nodepool을 업그레이드하는 데 사용되는 원본 스냅샷 ID입니다. VMSS 에이전트 풀 유형을 사용해야 합니다.

--undrainable-node-behavior

업그레이드하는 동안 표시할 수 없는 노드에 대한 동작을 정의합니다. 값은 "Cordon" 또는 "Schedule"이어야 합니다. 기본값은 "Schedule"입니다.

--yes -y

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

Default value: False
전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az aks nodepool wait

노드 풀이 원하는 상태에 도달할 때까지 기다립니다.

노드 풀에 대한 작업이 중단되었거나 시작된 --no-wait경우 이 명령을 사용하여 작업이 완료될 때까지 기다립니다.

az aks nodepool wait --cluster-name
                     --name
                     --resource-group
                     [--created]
                     [--custom]
                     [--deleted]
                     [--exists]
                     [--interval]
                     [--timeout]
                     [--updated]

예제

노드 풀이 원하는 상태에 도달할 때까지 기다렸다가 1분마다 최대 30분 동안 폴링합니다.

az aks nodepool wait --created --interval 60 --cluster-name MyManagedCluster --resource-group MyResourceGroup --nodepool-name MyNodePool --timeout 1800

필수 매개 변수

--cluster-name

클러스터 이름입니다.

--name --nodepool-name -n

노드 풀 이름입니다.

--resource-group -g

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

선택적 매개 변수

--created

'Succeeded'에서 'provisioningState'를 사용하여 생성될 때까지 기다립니다.

Default value: False
--custom

조건이 사용자 지정 JMESPath 쿼리를 충족할 때까지 기다립니다. 예: provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

삭제될 때까지 기다립니다.

Default value: False
--exists

리소스가 존재할 때까지 기다립니다.

Default value: False
--interval

폴링 간격(초)입니다.

Default value: 30
--timeout

최대 대기 시간(초)입니다.

Default value: 3600
--updated

'Succeeded'에서 provisioningState로 업데이트될 때까지 기다립니다.

Default value: False
전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.