다음을 통해 공유


ManagedClusterAgentPoolProfile interface

컨테이너 서비스 에이전트 풀에 대한 프로필입니다.

Extends

속성

name

Windows 에이전트 풀 이름은 6자 이내여야 합니다.

상속된 속성

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

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

type

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

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

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

속성 세부 정보

name

Windows 에이전트 풀 이름은 6자 이내여야 합니다.

name: string

속성 값

string

상속된 속성 세부 정보

availabilityZones

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

availabilityZones?: string[]

속성 값

string[]

ManagedClusterAgentPoolProfileProperties.availabilityZones 상속된

capacityReservationGroupID

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

capacityReservationGroupID?: string

속성 값

string

ManagedClusterAgentPoolProfileProperties.capacityReservationGroupID 상속된

count

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

count?: number

속성 값

number

ManagedClusterAgentPoolProfileProperties.count 상속된

creationData

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

creationData?: CreationData

속성 값

ManagedClusterAgentPoolProfileProperties.creationData 상속된

currentOrchestratorVersion

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

currentOrchestratorVersion?: string

속성 값

string

ManagedClusterAgentPoolProfileProperties.currentOrchestratorVersion 상속된

enableAutoScaling

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

enableAutoScaling?: boolean

속성 값

boolean

ManagedClusterAgentPoolProfileProperties.enableAutoScaling 상속된

enableEncryptionAtHost

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

enableEncryptionAtHost?: boolean

속성 값

boolean

ManagedClusterAgentPoolProfileProperties.enableEncryptionAtHost 상속된

enableFips

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

enableFips?: boolean

속성 값

boolean

ManagedClusterAgentPoolProfileProperties.enableFips 상속된

enableNodePublicIP

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

enableNodePublicIP?: boolean

속성 값

boolean

ManagedClusterAgentPoolProfileProperties.enableNodePublicIP 상속된

enableUltraSSD

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

enableUltraSSD?: boolean

속성 값

boolean

ManagedClusterAgentPoolProfileProperties.enableUltraSSD 상속된

eTag

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

eTag?: string

속성 값

string

ManagedClusterAgentPoolProfileProperties.eTag 상속된

gpuInstanceProfile

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

gpuInstanceProfile?: string

속성 값

string

ManagedClusterAgentPoolProfileProperties.gpuInstanceProfile 상속된

hostGroupID

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

hostGroupID?: string

속성 값

string

ManagedClusterAgentPoolProfileProperties.hostGroupID 상속된

kubeletConfig

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

kubeletConfig?: KubeletConfig

속성 값

ManagedClusterAgentPoolProfileProperties.kubeletConfig 상속된

kubeletDiskType

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

kubeletDiskType?: string

속성 값

string

ManagedClusterAgentPoolProfileProperties.kubeletDiskType 상속된

linuxOSConfig

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

linuxOSConfig?: LinuxOSConfig

속성 값

ManagedClusterAgentPoolProfileProperties.linuxOSConfig 상속된

maxCount

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

maxCount?: number

속성 값

number

ManagedClusterAgentPoolProfileProperties.maxCount 상속된

maxPods

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

maxPods?: number

속성 값

number

ManagedClusterAgentPoolProfileProperties.maxPods 상속된

minCount

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

minCount?: number

속성 값

number

ManagedClusterAgentPoolProfileProperties.minCount 상속된

mode

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

mode?: string

속성 값

string

ManagedClusterAgentPoolProfileProperties.mode 상속된

networkProfile

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

networkProfile?: AgentPoolNetworkProfile

속성 값

ManagedClusterAgentPoolProfileProperties.networkProfile 상속된

nodeImageVersion

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

nodeImageVersion?: string

속성 값

string

ManagedClusterAgentPoolProfileProperties.nodeImageVersion 상속된

nodeLabels

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

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

속성 값

{[propertyName: string]: string}

ManagedClusterAgentPoolProfileProperties.nodeLabels 상속된

nodePublicIPPrefixID

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

nodePublicIPPrefixID?: string

속성 값

string

ManagedClusterAgentPoolProfileProperties.nodePublicIPPrefixID 상속된

nodeTaints

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

nodeTaints?: string[]

속성 값

string[]

ManagedClusterAgentPoolProfileProperties.nodeTaints 상속된

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

ManagedClusterAgentPoolProfileProperties.orchestratorVersion 상속된

osDiskSizeGB

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

osDiskSizeGB?: number

속성 값

number

ManagedClusterAgentPoolProfileProperties.osDiskSizeGB 상속된

osDiskType

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

osDiskType?: string

속성 값

string

ManagedClusterAgentPoolProfileProperties.osDiskType 상속된

osSKU

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

osSKU?: string

속성 값

string

ManagedClusterAgentPoolProfileProperties.osSKU 상속된

osType

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

osType?: string

속성 값

string

ManagedClusterAgentPoolProfileProperties.osType 상속된

podSubnetID

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

podSubnetID?: string

속성 값

string

ManagedClusterAgentPoolProfileProperties.podSubnetID 상속된

powerState

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

powerState?: PowerState

속성 값

ManagedClusterAgentPoolProfileProperties.powerState 상속된

provisioningState

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

provisioningState?: string

속성 값

string

ManagedClusterAgentPoolProfileProperties.provisioningState 상속된

proximityPlacementGroupID

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

proximityPlacementGroupID?: string

속성 값

string

ManagedClusterAgentPoolProfileProperties.proximityPlacementGroupID 상속된

scaleDownMode

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

scaleDownMode?: string

속성 값

string

ManagedClusterAgentPoolProfileProperties.scaleDownMode 상속된

scaleSetEvictionPolicy

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

scaleSetEvictionPolicy?: string

속성 값

string

ManagedClusterAgentPoolProfileProperties.scaleSetEvictionPolicy 상속된

scaleSetPriority

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

scaleSetPriority?: string

속성 값

string

ManagedClusterAgentPoolProfileProperties.scaleSetPriority 상속된

securityProfile

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

securityProfile?: AgentPoolSecurityProfile

속성 값

ManagedClusterAgentPoolProfileProperties.securityProfile 상속된

spotMaxPrice

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

spotMaxPrice?: number

속성 값

number

ManagedClusterAgentPoolProfileProperties.spotMaxPrice 상속된

tags

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

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

속성 값

{[propertyName: string]: string}

ManagedClusterAgentPoolProfileProperties.tags 상속된

type

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

type?: string

속성 값

string

ManagedClusterAgentPoolProfileProperties.type 상속된

upgradeSettings

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

upgradeSettings?: AgentPoolUpgradeSettings

속성 값

ManagedClusterAgentPoolProfileProperties.upgradeSettings 상속된

vmSize

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

vmSize?: string

속성 값

string

ManagedClusterAgentPoolProfileProperties.vmSize 상속된

vnetSubnetID

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

vnetSubnetID?: string

속성 값

string

ManagedClusterAgentPoolProfileProperties.vnetSubnetID 상속된

windowsProfile

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

windowsProfile?: AgentPoolWindowsProfile

속성 값

ManagedClusterAgentPoolProfileProperties.windowsProfile 상속된

workloadRuntime

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

workloadRuntime?: string

속성 값

string

ManagedClusterAgentPoolProfileProperties.workloadRuntime 상속된