AgentPool interface

패키지:

@azure/arm-containerservice

에이전트 풀.

Extends

SubResource

속성

availabilityZones	노드에 사용할 가용성 영역 목록입니다. AgentPoolType 속성이 'VirtualMachineScaleSets'인 경우에만 지정할 수 있습니다.
capacityReservationGroupID	AKS는 지정된 에이전트 풀을 용량 예약 그룹과 연결합니다.
count	Docker 컨테이너를 호스트할 에이전트(VM) 수입니다. 허용되는 값은 사용자 풀의 경우 0에서 1000(포함) 범위여야 하고 시스템 풀의 경우 1~1000(포함) 범위여야 합니다. 기본값은 1입니다.
creationData	노드 풀이 스냅샷을 사용하여 생성/업그레이드될 경우 원본 스냅샷 ID를 지정하는 데 사용할 CreationData입니다.
currentOrchestratorVersion	orchestratorVersion이 major.minor.patch><완전히 지정된 버전인 경우 이 필드는 정확히 동일합니다. orchestratorVersion이 major.minor><경우 이 필드에는 사용 중인 전체 <major.minor.patch> 버전이 포함됩니다. 참고: 이 속성은 serialize되지 않습니다. 서버에서만 채울 수 있습니다.
enableAutoScaling	자동 크기 조정기를 사용하도록 설정할지 여부
enableEncryptionAtHost	이는 특정 VM 크기 및 특정 Azure 지역에서만 지원됩니다. 자세한 내용은 다음을 참조하세요. https://docs.microsoft.com/azure/aks/enable-host-encryption
enableFips	자세한 내용은 FIPS 사용 노드 풀 추가를 참조하세요.
enableNodePublicIP	일부 시나리오에서는 노드 풀의 노드가 자체 전용 공용 IP 주소를 수신해야 할 수 있습니다. 일반적인 시나리오는 홉을 최소화하기 위해 콘솔이 클라우드 가상 머신에 직접 연결해야 하는 게임 워크로드에 대한 것입니다. 자세한 내용은 노드 당 공용 IP를 할당하는참조하세요. 기본값은 false입니다.
enableUltraSSD	UltraSSD를 사용하도록 설정할지 여부
eTag	낙관적 동시성을 구현하는 데 사용되는 고유한 읽기 전용 문자열입니다. eTag 값은 리소스가 업데이트될 때 변경됩니다. 일반 etag 규칙에 따라 낙관적 동시성을 사용하도록 설정하려면 후속 요청에 대한 eTag 값을 사용하여 if-match 또는 if-none-match 헤더를 지정합니다. 참고: 이 속성은 serialize되지 않습니다. 서버에서만 채울 수 있습니다.
gpuInstanceProfile	지원되는 GPU VM SKU에 대한 GPU MIG 인스턴스 프로필을 지정하는 데 사용되는 GPUInstanceProfile입니다.
hostGroupID	/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}의 형식입니다. 자세한 내용은 Azure 전용 호스트 참조하세요.
kubeletConfig	에이전트 풀 노드의 Kubelet 구성입니다.
kubeletDiskType	emptyDir 볼륨, 컨테이너 런타임 데이터 루트 및 Kubelet 임시 스토리지의 배치를 결정합니다.
linuxOSConfig	Linux 에이전트 노드의 OS 구성입니다.
maxCount	자동 크기 조정을 위한 최대 노드 수
maxPods	노드에서 실행할 수 있는 최대 Pod 수입니다.
minCount	자동 크기 조정을 위한 최소 노드 수
mode	클러스터에는 항상 하나 이상의 '시스템' 에이전트 풀이 있어야 합니다. 에이전트 풀 제한 및 모범 사례에 대한 자세한 내용은 다음을 참조하세요. https://docs.microsoft.com/azure/aks/use-system-pools
networkProfile	에이전트 풀의 네트워크 관련 설정입니다.
nodeImageVersion	노드 이미지의 버전 참고: 이 속성은 serialize되지 않습니다. 서버에서만 채울 수 있습니다.
nodeLabels	에이전트 풀의 모든 노드에서 유지할 노드 레이블입니다.
nodePublicIPPrefixID	/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName} 형식입니다.
nodeTaints	노드 풀 만들기 및 크기 조정 중에 새 노드에 추가된 taint입니다. 예를 들어 key=value:NoSchedule입니다.
orchestratorVersion	두 패치 버전 <major.minor.patch>(예: 1.20.13) 및 <major.minor>(예: 1.20)이 지원됩니다. <major.minor> 지정하면 지원되는 최신 GA 패치 버전이 자동으로 선택됩니다. 만든 후 동일한 <major.minor> 사용하여 클러스터를 업데이트합니다(예: 1.14.x -> 1.14). 최신 패치 버전을 사용할 수 있더라도 업그레이드가 트리거되지 않습니다. AKS 클러스터의 모든 노드 풀을 동일한 Kubernetes 버전으로 업그레이드하는 것이 가장 좋습니다. 노드 풀 버전은 컨트롤 플레인과 동일한 주 버전이어야 합니다. 노드 풀 부 버전은 컨트롤 플레인 버전의 두 부 버전 내에 있어야 합니다. 노드 풀 버전은 컨트롤 플레인 버전보다 클 수 없습니다. 자세한 내용은 노드 풀 업그레이드하는참조하세요.
osDiskSizeGB	마스터/에이전트 풀의 모든 컴퓨터에 대한 디스크 크기를 지정하는 데 사용할 OS 디스크 크기(GB)입니다. 0을 지정하면 지정된 vmSize에 따라 기본 osDisk 크기가 적용됩니다.
osDiskType	VM이 지원하며 요청된 OSDiskSizeGB보다 큰 캐시 디스크가 있는 경우 기본값은 'Ephemeral'입니다. 그렇지 않으면 기본값은 'Managed'입니다. 만든 후에는 변경되지 않을 수 있습니다. 자세한 내용은 임시 OS참조하세요.
osSKU	에이전트 풀에서 사용하는 OS SKU를 지정합니다. OSType이 Linux인 경우 기본값은 Ubuntu입니다. 기본값은 Kubernetes가 Windows인 경우 Kubernetes >= 1.25인 경우 Kubernetes <= 1.24 또는 Windows2022인 경우 Windows2019입니다.
osType	운영 체제 유형입니다. 기본값은 Linux입니다.
podSubnetID	생략하면 노드 서브넷에 Pod IP가 정적으로 할당됩니다(자세한 내용은 vnetSubnetID 참조). /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} 형식입니다.
powerState	에이전트 풀이 처음 만들어지면 처음에는 실행 중입니다. 이 필드를 중지됨으로 설정하여 에이전트 풀을 중지할 수 있습니다. 중지된 에이전트 풀은 모든 VM을 중지하고 청구 요금이 발생하지 않습니다. 에이전트 풀이 실행 중이고 프로비저닝 상태가 성공한 경우에만 중지할 수 있습니다.
provisioningState	현재 배포 또는 프로비저닝 상태입니다. 참고: 이 속성은 serialize되지 않습니다. 서버에서만 채울 수 있습니다.
proximityPlacementGroupID	근접 배치 그룹의 ID입니다.
scaleDownMode	클러스터 자동 크기 조정기 동작에도 영향을 줍니다. 지정하지 않으면 기본적으로 Delete로 설정됩니다.
scaleSetEvictionPolicy	scaleSetPriority가 'Spot'이 아니면 지정할 수 없습니다. 지정하지 않으면 기본값은 'Delete'입니다.
scaleSetPriority	Virtual Machine Scale Set 우선 순위입니다. 지정하지 않으면 기본값은 'Regular'입니다.
securityProfile	에이전트 풀의 보안 설정입니다.
spotMaxPrice	가능한 값은 0보다 크거나 -1 값으로, 주문형 가격을 지불하려는 의지를 나타냅니다. 스폿 가격 책정에 대한 자세한 내용은 스폿 VM 가격 책정 참조하세요.
tags	에이전트 풀 가상 머신 확장 집합에 유지할 태그입니다.
typePropertiesType	에이전트 풀의 형식입니다.
upgradeSettings	에이전트 풀 업그레이드 설정
vmSize	VM 크기 가용성은 지역에 따라 다릅니다. 노드에 컴퓨팅 리소스(메모리, cpu 등)가 부족한 경우 Pod가 제대로 실행되지 않을 수 있습니다. 제한된 VM 크기에 대한 자세한 내용은 다음을 참조하세요. https://docs.microsoft.com/azure/aks/quotas-skus-regions
vnetSubnetID	지정하지 않으면 VNET 및 서브넷이 생성되고 사용됩니다. podSubnetID를 지정하지 않으면 노드 및 Pod에 적용되고, 그렇지 않으면 노드에만 적용됩니다. /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} 형식입니다.
windowsProfile	Windows 에이전트 풀의 특정 프로필입니다.
workloadRuntime	노드에서 실행할 수 있는 워크로드 유형을 결정합니다.

상속된 속성

id	리소스 ID입니다. 참고: 이 속성은 serialize되지 않습니다. 서버에서만 채울 수 있습니다.
name	리소스 그룹 내에서 고유한 리소스의 이름입니다. 이 이름은 리소스에 액세스하는 데 사용할 수 있습니다. 참고: 이 속성은 serialize되지 않습니다. 서버에서만 채울 수 있습니다.
type	리소스 종류 참고: 이 속성은 serialize되지 않습니다. 서버에서만 채울 수 있습니다.

속성 세부 정보

availabilityZones

노드에 사용할 가용성 영역 목록입니다. AgentPoolType 속성이 'VirtualMachineScaleSets'인 경우에만 지정할 수 있습니다.

availabilityZones?: string[]

속성 값

string[]

capacityReservationGroupID

AKS는 지정된 에이전트 풀을 용량 예약 그룹과 연결합니다.

capacityReservationGroupID?: string

속성 값

string

count

Docker 컨테이너를 호스트할 에이전트(VM) 수입니다. 허용되는 값은 사용자 풀의 경우 0에서 1000(포함) 범위여야 하고 시스템 풀의 경우 1~1000(포함) 범위여야 합니다. 기본값은 1입니다.

count?: number

속성 값

number

creationData

노드 풀이 스냅샷을 사용하여 생성/업그레이드될 경우 원본 스냅샷 ID를 지정하는 데 사용할 CreationData입니다.

creationData?: CreationData

속성 값

CreationData

currentOrchestratorVersion

orchestratorVersion이 major.minor.patch><완전히 지정된 버전인 경우 이 필드는 정확히 동일합니다. orchestratorVersion이 major.minor><경우 이 필드에는 사용 중인 전체 <major.minor.patch> 버전이 포함됩니다. 참고: 이 속성은 serialize되지 않습니다. 서버에서만 채울 수 있습니다.

currentOrchestratorVersion?: string

속성 값

string

enableAutoScaling

자동 크기 조정기를 사용하도록 설정할지 여부

enableAutoScaling?: boolean

속성 값

boolean

enableEncryptionAtHost

이는 특정 VM 크기 및 특정 Azure 지역에서만 지원됩니다. 자세한 내용은 다음을 참조하세요. https://docs.microsoft.com/azure/aks/enable-host-encryption

enableEncryptionAtHost?: boolean

속성 값

boolean

enableFips

자세한 내용은 FIPS 사용 노드 풀 추가를 참조하세요.

enableFips?: boolean

속성 값

boolean

enableNodePublicIP

일부 시나리오에서는 노드 풀의 노드가 자체 전용 공용 IP 주소를 수신해야 할 수 있습니다. 일반적인 시나리오는 홉을 최소화하기 위해 콘솔이 클라우드 가상 머신에 직접 연결해야 하는 게임 워크로드에 대한 것입니다. 자세한 내용은 노드 당 공용 IP를 할당하는참조하세요. 기본값은 false입니다.

enableNodePublicIP?: boolean

속성 값

boolean

enableUltraSSD

UltraSSD를 사용하도록 설정할지 여부

enableUltraSSD?: boolean

속성 값

boolean

eTag

낙관적 동시성을 구현하는 데 사용되는 고유한 읽기 전용 문자열입니다. eTag 값은 리소스가 업데이트될 때 변경됩니다. 일반 etag 규칙에 따라 낙관적 동시성을 사용하도록 설정하려면 후속 요청에 대한 eTag 값을 사용하여 if-match 또는 if-none-match 헤더를 지정합니다. 참고: 이 속성은 serialize되지 않습니다. 서버에서만 채울 수 있습니다.

eTag?: string

속성 값

string

gpuInstanceProfile

지원되는 GPU VM SKU에 대한 GPU MIG 인스턴스 프로필을 지정하는 데 사용되는 GPUInstanceProfile입니다.

gpuInstanceProfile?: string

속성 값

string

hostGroupID

/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}의 형식입니다. 자세한 내용은 Azure 전용 호스트 참조하세요.

hostGroupID?: string

속성 값

string

kubeletConfig

에이전트 풀 노드의 Kubelet 구성입니다.

kubeletConfig?: KubeletConfig

속성 값

KubeletConfig

kubeletDiskType

emptyDir 볼륨, 컨테이너 런타임 데이터 루트 및 Kubelet 임시 스토리지의 배치를 결정합니다.

kubeletDiskType?: string

속성 값

string

linuxOSConfig

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

linuxOSConfig?: LinuxOSConfig

속성 값

LinuxOSConfig

maxCount

자동 크기 조정을 위한 최대 노드 수

maxCount?: number

속성 값

number

maxPods

노드에서 실행할 수 있는 최대 Pod 수입니다.

maxPods?: number

속성 값

number

minCount

자동 크기 조정을 위한 최소 노드 수

minCount?: number

속성 값

number

mode

클러스터에는 항상 하나 이상의 '시스템' 에이전트 풀이 있어야 합니다. 에이전트 풀 제한 및 모범 사례에 대한 자세한 내용은 다음을 참조하세요. https://docs.microsoft.com/azure/aks/use-system-pools

mode?: string

속성 값

string

networkProfile

에이전트 풀의 네트워크 관련 설정입니다.

networkProfile?: AgentPoolNetworkProfile

속성 값

AgentPoolNetworkProfile

nodeImageVersion

노드 이미지의 버전 참고: 이 속성은 serialize되지 않습니다. 서버에서만 채울 수 있습니다.

nodeImageVersion?: string

속성 값

string

nodeLabels

에이전트 풀의 모든 노드에서 유지할 노드 레이블입니다.

nodeLabels?: {[propertyName: string]: string}

속성 값

{[propertyName: string]: string}

nodePublicIPPrefixID

/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName} 형식입니다.

nodePublicIPPrefixID?: string

속성 값

string

nodeTaints

노드 풀 만들기 및 크기 조정 중에 새 노드에 추가된 taint입니다. 예를 들어 key=value:NoSchedule입니다.

nodeTaints?: string[]

속성 값

string[]

orchestratorVersion

두 패치 버전 <major.minor.patch>(예: 1.20.13) 및 <major.minor>(예: 1.20)이 지원됩니다. <major.minor> 지정하면 지원되는 최신 GA 패치 버전이 자동으로 선택됩니다. 만든 후 동일한 <major.minor> 사용하여 클러스터를 업데이트합니다(예: 1.14.x -> 1.14). 최신 패치 버전을 사용할 수 있더라도 업그레이드가 트리거되지 않습니다. AKS 클러스터의 모든 노드 풀을 동일한 Kubernetes 버전으로 업그레이드하는 것이 가장 좋습니다. 노드 풀 버전은 컨트롤 플레인과 동일한 주 버전이어야 합니다. 노드 풀 부 버전은 컨트롤 플레인 버전의 두 부 버전 내에 있어야 합니다. 노드 풀 버전은 컨트롤 플레인 버전보다 클 수 없습니다. 자세한 내용은 노드 풀 업그레이드하는참조하세요.

orchestratorVersion?: string

속성 값

string

osDiskSizeGB

마스터/에이전트 풀의 모든 컴퓨터에 대한 디스크 크기를 지정하는 데 사용할 OS 디스크 크기(GB)입니다. 0을 지정하면 지정된 vmSize에 따라 기본 osDisk 크기가 적용됩니다.

osDiskSizeGB?: number

속성 값

number

osDiskType

VM이 지원하며 요청된 OSDiskSizeGB보다 큰 캐시 디스크가 있는 경우 기본값은 'Ephemeral'입니다. 그렇지 않으면 기본값은 'Managed'입니다. 만든 후에는 변경되지 않을 수 있습니다. 자세한 내용은 임시 OS참조하세요.

osDiskType?: string

속성 값

string

osSKU

에이전트 풀에서 사용하는 OS SKU를 지정합니다. OSType이 Linux인 경우 기본값은 Ubuntu입니다. 기본값은 Kubernetes가 Windows인 경우 Kubernetes >= 1.25인 경우 Kubernetes <= 1.24 또는 Windows2022인 경우 Windows2019입니다.

osSKU?: string

속성 값

string

osType

운영 체제 유형입니다. 기본값은 Linux입니다.

osType?: string

속성 값

string

podSubnetID

생략하면 노드 서브넷에 Pod IP가 정적으로 할당됩니다(자세한 내용은 vnetSubnetID 참조). /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} 형식입니다.

podSubnetID?: string

속성 값

string

powerState

에이전트 풀이 처음 만들어지면 처음에는 실행 중입니다. 이 필드를 중지됨으로 설정하여 에이전트 풀을 중지할 수 있습니다. 중지된 에이전트 풀은 모든 VM을 중지하고 청구 요금이 발생하지 않습니다. 에이전트 풀이 실행 중이고 프로비저닝 상태가 성공한 경우에만 중지할 수 있습니다.

powerState?: PowerState

속성 값

PowerState

provisioningState

현재 배포 또는 프로비저닝 상태입니다. 참고: 이 속성은 serialize되지 않습니다. 서버에서만 채울 수 있습니다.

provisioningState?: string

속성 값

string

proximityPlacementGroupID

근접 배치 그룹의 ID입니다.

proximityPlacementGroupID?: string

속성 값

string

scaleDownMode

클러스터 자동 크기 조정기 동작에도 영향을 줍니다. 지정하지 않으면 기본적으로 Delete로 설정됩니다.

scaleDownMode?: string

속성 값

string

scaleSetEvictionPolicy

scaleSetPriority가 'Spot'이 아니면 지정할 수 없습니다. 지정하지 않으면 기본값은 'Delete'입니다.

scaleSetEvictionPolicy?: string

속성 값

string

scaleSetPriority

Virtual Machine Scale Set 우선 순위입니다. 지정하지 않으면 기본값은 'Regular'입니다.

scaleSetPriority?: string

속성 값

string

securityProfile

에이전트 풀의 보안 설정입니다.

securityProfile?: AgentPoolSecurityProfile

속성 값

AgentPoolSecurityProfile

spotMaxPrice

가능한 값은 0보다 크거나 -1 값으로, 주문형 가격을 지불하려는 의지를 나타냅니다. 스폿 가격 책정에 대한 자세한 내용은 스폿 VM 가격 책정 참조하세요.

spotMaxPrice?: number

속성 값

number

tags

에이전트 풀 가상 머신 확장 집합에 유지할 태그입니다.

tags?: {[propertyName: string]: string}

속성 값

{[propertyName: string]: string}

typePropertiesType

에이전트 풀의 형식입니다.

typePropertiesType?: string

속성 값

string

upgradeSettings

에이전트 풀 업그레이드 설정

upgradeSettings?: AgentPoolUpgradeSettings

속성 값

AgentPoolUpgradeSettings

vmSize

VM 크기 가용성은 지역에 따라 다릅니다. 노드에 컴퓨팅 리소스(메모리, cpu 등)가 부족한 경우 Pod가 제대로 실행되지 않을 수 있습니다. 제한된 VM 크기에 대한 자세한 내용은 다음을 참조하세요. https://docs.microsoft.com/azure/aks/quotas-skus-regions

vmSize?: string

속성 값

string

vnetSubnetID

지정하지 않으면 VNET 및 서브넷이 생성되고 사용됩니다. podSubnetID를 지정하지 않으면 노드 및 Pod에 적용되고, 그렇지 않으면 노드에만 적용됩니다. /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} 형식입니다.

vnetSubnetID?: string

속성 값

string

windowsProfile

Windows 에이전트 풀의 특정 프로필입니다.

windowsProfile?: AgentPoolWindowsProfile

속성 값

AgentPoolWindowsProfile

workloadRuntime

노드에서 실행할 수 있는 워크로드 유형을 결정합니다.

workloadRuntime?: string

속성 값

string

상속된 속성 세부 정보

id

리소스 ID입니다. 참고: 이 속성은 serialize되지 않습니다. 서버에서만 채울 수 있습니다.

id?: string

속성 값

string

SubResource.id 상속된

name

리소스 그룹 내에서 고유한 리소스의 이름입니다. 이 이름은 리소스에 액세스하는 데 사용할 수 있습니다. 참고: 이 속성은 serialize되지 않습니다. 서버에서만 채울 수 있습니다.

name?: string

속성 값

string

SubResource.name 상속된

type

리소스 종류 참고: 이 속성은 serialize되지 않습니다. 서버에서만 채울 수 있습니다.

type?: string

속성 값

string

SubResource.type 상속된