ManagedClusterAgentPoolProfile interface
컨테이너 서비스 에이전트 풀에 대한 프로필입니다.
속성
| name | Windows 에이전트 풀 이름은 6자 이내여야 합니다. |
상속된 속성
| availability |
노드에 사용할 가용성 영역 목록입니다. AgentPoolType 속성이 'VirtualMachineScaleSets'인 경우에만 지정할 수 있습니다. |
| capacity |
AKS는 지정된 에이전트 풀을 용량 예약 그룹과 연결합니다. |
| count | Docker 컨테이너를 호스트할 에이전트(VM) 수입니다. 허용되는 값은 사용자 풀의 경우 0에서 1000(포함) 범위여야 하고 시스템 풀의 경우 1~1000(포함) 범위여야 합니다. 기본값은 1입니다. |
| creation |
노드 풀이 스냅샷을 사용하여 생성/업그레이드될 경우 원본 스냅샷 ID를 지정하는 데 사용할 CreationData입니다. |
| enable |
자동 크기 조정기를 사용하도록 설정할지 여부 |
| enable |
true로 설정하면 AKS는 사용자가 제공한 구성 맵에서 노드 신뢰 저장소로 사용자 지정 인증 기관을 동기화하는 데몬셋 및 호스트 서비스를 배포합니다. 기본값은 false입니다. |
| enable |
이는 특정 VM 크기 및 특정 Azure 지역에서만 지원됩니다. 자세한 내용은 다음을 참조하세요. https://docs.microsoft.com/azure/aks/enable-host-encryption |
| enableFIPS | 자세한 내용은 FIPS 사용 노드 풀 추가를 참조하세요. |
| enable |
일부 시나리오에서는 노드 풀의 노드가 자체 전용 공용 IP 주소를 수신해야 할 수 있습니다. 일반적인 시나리오는 홉을 최소화하기 위해 콘솔이 클라우드 가상 머신에 직접 연결해야 하는 게임 워크로드에 대한 것입니다. 자세한 내용은 노드당 공용 IP를 할당하는 |
| enable |
UltraSSD를 사용하도록 설정할지 여부 |
| gpu |
지원되는 GPU VM SKU에 대한 GPU MIG 인스턴스 프로필을 지정하는 데 사용되는 GPUInstanceProfile입니다. |
| host |
/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}의 형식입니다. 자세한 내용은 Azure 전용 호스트 |
| kubelet |
에이전트 풀 노드의 Kubelet 구성입니다. |
| kubelet |
emptyDir 볼륨, 컨테이너 런타임 데이터 루트 및 Kubelet 임시 스토리지의 배치를 결정합니다. |
| linux |
Linux 에이전트 노드의 OS 구성입니다. |
| max |
자동 크기 조정을 위한 최대 노드 수 |
| max |
노드에서 실행할 수 있는 최대 Pod 수입니다. |
| message |
디코딩 후 /etc/motd에 기록될 base64로 인코딩된 문자열입니다. 이렇게 하면 Linux 노드에 대한 오늘의 메시지를 사용자 지정할 수 있습니다. Windows 노드에 대해 지정해서는 안 됩니다. 정적 문자열이어야 합니다(즉, 원시로 인쇄되고 스크립트로 실행되지 않음). |
| min |
자동 크기 조정을 위한 최소 노드 수 |
| mode | 클러스터에는 항상 하나 이상의 '시스템' 에이전트 풀이 있어야 합니다. 에이전트 풀 제한 및 모범 사례에 대한 자세한 내용은 다음을 참조하세요. https://docs.microsoft.com/azure/aks/use-system-pools |
| node |
에이전트 풀의 모든 노드에서 유지할 노드 레이블입니다. |
| node |
/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName} 형식입니다. |
| node |
노드 풀 만들기 및 크기 조정 중에 새 노드에 추가된 taint입니다. 예를 들어 key=value:NoSchedule입니다. |
| orchestrator |
major.minor.patch<>패치 버전과 <major.minor> 모두 지원됩니다.
<major.minor> 지정하면 지원되는 최신 패치 버전이 자동으로 선택됩니다. 만든 후에는 <동일한 <major.minor 사용하여 에이전트 풀을 업데이트해도 최신 패치 버전을 사용할 수 있더라도 업그레이드가 트리거되지 않습니다. AKS 클러스터의 모든 노드 풀을 동일한 Kubernetes 버전으로 업그레이드하는 것이 가장 좋습니다. 노드 풀 버전은 컨트롤 플레인과 동일한 주 버전이어야 합니다. 노드 풀 부 버전은 컨트롤 플레인 버전의 두 부 버전 내에 있어야 합니다. 노드 풀 버전은 컨트롤 플레인 버전보다 클 수 없습니다. 자세한 내용은 노드 풀업그레이드하는 |
| os |
마스터/에이전트 풀의 모든 컴퓨터에 대한 디스크 크기를 지정하는 데 사용할 OS 디스크 크기(GB)입니다. 0을 지정하면 지정된 vmSize에 따라 기본 osDisk 크기가 적용됩니다. |
| os |
VM이 지원하며 요청된 OSDiskSizeGB보다 큰 캐시 디스크가 있는 경우 기본값은 'Ephemeral'입니다. 그렇지 않으면 기본값은 'Managed'입니다. 만든 후에는 변경되지 않을 수 있습니다. 자세한 내용은 임시 OS참조하세요. |
| osSKU | 에이전트 풀에서 사용하는 OS SKU를 지정합니다. 지정하지 않으면 OSType=Linux인 경우 기본값은 Ubuntu이고 OSType=Windows인 경우 Windows2019입니다. 또한 Windows 2019가 사용되지 않는 경우 기본 Windows OSSKU가 Windows2022로 변경됩니다. |
| os |
운영 체제 유형입니다. 기본값은 Linux입니다. |
| pod |
생략하면 노드 서브넷에 Pod IP가 정적으로 할당됩니다(자세한 내용은 vnetSubnetID 참조). /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} 형식입니다. |
| power |
에이전트 풀이 처음 만들어지면 처음에는 실행 중입니다. 이 필드를 중지됨으로 설정하여 에이전트 풀을 중지할 수 있습니다. 중지된 에이전트 풀은 모든 VM을 중지하고 청구 요금이 발생하지 않습니다. 에이전트 풀이 실행 중이고 프로비저닝 상태가 성공한 경우에만 중지할 수 있습니다. |
| proximity |
근접 배치 그룹의 ID입니다. |
| scale |
클러스터 자동 크기 조정기 동작에도 영향을 줍니다. 지정하지 않으면 기본적으로 Delete로 설정됩니다. |
| scale |
scaleSetPriority가 'Spot'이 아니면 지정할 수 없습니다. 지정하지 않으면 기본값은 'Delete'입니다. |
| scale |
Virtual Machine Scale Set 우선 순위입니다. 지정하지 않으면 기본값은 'Regular'입니다. |
| spot |
가능한 값은 0보다 크거나 -1 값으로, 주문형 가격을 지불하려는 의지를 나타냅니다. 스폿 가격 책정에 대한 자세한 내용은 스폿 VM 가격 책정 참조하세요. |
| tags | 에이전트 풀 가상 머신 확장 집합에 유지할 태그입니다. |
| type | 에이전트 풀의 형식입니다. |
| upgrade |
에이전트 풀 업그레이드 설정 |
| vm |
VM 크기 가용성은 지역에 따라 다릅니다. 노드에 컴퓨팅 리소스(메모리, cpu 등)가 부족한 경우 Pod가 제대로 실행되지 않을 수 있습니다. 제한된 VM 크기에 대한 자세한 내용은 다음을 참조하세요. https://docs.microsoft.com/azure/aks/quotas-skus-regions |
| vnet |
지정하지 않으면 VNET 및 서브넷이 생성되고 사용됩니다. podSubnetID를 지정하지 않으면 노드 및 Pod에 적용되고, 그렇지 않으면 노드에만 적용됩니다. /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} 형식입니다. |
| workload |
노드에서 실행할 수 있는 워크로드 유형을 결정합니다. |
속성 세부 정보
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
creationData
노드 풀이 스냅샷을 사용하여 생성/업그레이드될 경우 원본 스냅샷 ID를 지정하는 데 사용할 CreationData입니다.
creationData?: CreationData속성 값
enableAutoScaling
자동 크기 조정기를 사용하도록 설정할지 여부
enableAutoScaling?: boolean속성 값
boolean
ManagedClusterAgentPoolProfileProperties.enableAutoScaling 상속된
enableCustomCATrust
true로 설정하면 AKS는 사용자가 제공한 구성 맵에서 노드 신뢰 저장소로 사용자 지정 인증 기관을 동기화하는 데몬셋 및 호스트 서비스를 배포합니다. 기본값은 false입니다.
enableCustomCATrust?: boolean속성 값
boolean
ManagedClusterAgentPoolProfileProperties.enableCustomCATrust 상속된
enableEncryptionAtHost
이는 특정 VM 크기 및 특정 Azure 지역에서만 지원됩니다. 자세한 내용은 다음을 참조하세요. https://docs.microsoft.com/azure/aks/enable-host-encryption
enableEncryptionAtHost?: boolean속성 값
boolean
ManagedClusterAgentPoolProfileProperties.enableEncryptionAtHost 상속된
enableFIPS
enableNodePublicIP
일부 시나리오에서는 노드 풀의 노드가 자체 전용 공용 IP 주소를 수신해야 할 수 있습니다. 일반적인 시나리오는 홉을 최소화하기 위해 콘솔이 클라우드 가상 머신에 직접 연결해야 하는 게임 워크로드에 대한 것입니다. 자세한 내용은 노드당 공용 IP를 할당하는
enableNodePublicIP?: boolean속성 값
boolean
ManagedClusterAgentPoolProfileProperties.enableNodePublicIP 상속된
enableUltraSSD
UltraSSD를 사용하도록 설정할지 여부
enableUltraSSD?: boolean속성 값
boolean
gpuInstanceProfile
지원되는 GPU VM SKU에 대한 GPU MIG 인스턴스 프로필을 지정하는 데 사용되는 GPUInstanceProfile입니다.
gpuInstanceProfile?: "MIG1g" | "MIG2g" | "MIG3g" | "MIG4g" | "MIG7g"속성 값
"MIG1g" | "MIG2g" | "MIG3g" | "MIG4g" | "MIG7g"
ManagedClusterAgentPoolProfileProperties.gpuInstanceProfile 상속된
hostGroupID
/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}의 형식입니다. 자세한 내용은 Azure 전용 호스트
hostGroupID?: string속성 값
string
kubeletConfig
에이전트 풀 노드의 Kubelet 구성입니다.
kubeletConfig?: KubeletConfig속성 값
kubeletDiskType
emptyDir 볼륨, 컨테이너 런타임 데이터 루트 및 Kubelet 임시 스토리지의 배치를 결정합니다.
kubeletDiskType?: "OS" | "Temporary"속성 값
"OS" | "Temporary"
ManagedClusterAgentPoolProfileProperties.kubeletDiskType 상속된
linuxOSConfig
Linux 에이전트 노드의 OS 구성입니다.
linuxOSConfig?: LinuxOSConfig속성 값
maxCount
자동 크기 조정을 위한 최대 노드 수
maxCount?: number속성 값
number
maxPods
노드에서 실행할 수 있는 최대 Pod 수입니다.
maxPods?: number속성 값
number
messageOfTheDay
디코딩 후 /etc/motd에 기록될 base64로 인코딩된 문자열입니다. 이렇게 하면 Linux 노드에 대한 오늘의 메시지를 사용자 지정할 수 있습니다. Windows 노드에 대해 지정해서는 안 됩니다. 정적 문자열이어야 합니다(즉, 원시로 인쇄되고 스크립트로 실행되지 않음).
messageOfTheDay?: string속성 값
string
ManagedClusterAgentPoolProfileProperties.messageOfTheDay 상속된
minCount
자동 크기 조정을 위한 최소 노드 수
minCount?: number속성 값
number
mode
클러스터에는 항상 하나 이상의 '시스템' 에이전트 풀이 있어야 합니다. 에이전트 풀 제한 및 모범 사례에 대한 자세한 내용은 다음을 참조하세요. https://docs.microsoft.com/azure/aks/use-system-pools
mode?: "System" | "User"속성 값
"System" | "User"
nodeLabels
에이전트 풀의 모든 노드에서 유지할 노드 레이블입니다.
nodeLabels?: Record<string, string>속성 값
Record<string, string>
nodePublicIPPrefixID
/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName} 형식입니다.
nodePublicIPPrefixID?: string속성 값
string
ManagedClusterAgentPoolProfileProperties.nodePublicIPPrefixID 상속된
nodeTaints
노드 풀 만들기 및 크기 조정 중에 새 노드에 추가된 taint입니다. 예를 들어 key=value:NoSchedule입니다.
nodeTaints?: string[]속성 값
string[]
orchestratorVersion
major.minor.patch<>패치 버전과 <major.minor> 모두 지원됩니다.
<major.minor> 지정하면 지원되는 최신 패치 버전이 자동으로 선택됩니다. 만든 후에는 <동일한 <major.minor 사용하여 에이전트 풀을 업데이트해도 최신 패치 버전을 사용할 수 있더라도 업그레이드가 트리거되지 않습니다. AKS 클러스터의 모든 노드 풀을 동일한 Kubernetes 버전으로 업그레이드하는 것이 가장 좋습니다. 노드 풀 버전은 컨트롤 플레인과 동일한 주 버전이어야 합니다. 노드 풀 부 버전은 컨트롤 플레인 버전의 두 부 버전 내에 있어야 합니다. 노드 풀 버전은 컨트롤 플레인 버전보다 클 수 없습니다. 자세한 내용은 노드 풀업그레이드하는
orchestratorVersion?: string속성 값
string
ManagedClusterAgentPoolProfileProperties.orchestratorVersion 상속된
osDiskSizeGB
마스터/에이전트 풀의 모든 컴퓨터에 대한 디스크 크기를 지정하는 데 사용할 OS 디스크 크기(GB)입니다. 0을 지정하면 지정된 vmSize에 따라 기본 osDisk 크기가 적용됩니다.
osDiskSizeGB?: number속성 값
number
osDiskType
VM이 지원하며 요청된 OSDiskSizeGB보다 큰 캐시 디스크가 있는 경우 기본값은 'Ephemeral'입니다. 그렇지 않으면 기본값은 'Managed'입니다. 만든 후에는 변경되지 않을 수 있습니다. 자세한 내용은 임시 OS참조하세요.
osDiskType?: "Managed" | "Ephemeral"속성 값
"Managed" | "Ephemeral"
osSKU
에이전트 풀에서 사용하는 OS SKU를 지정합니다. 지정하지 않으면 OSType=Linux인 경우 기본값은 Ubuntu이고 OSType=Windows인 경우 Windows2019입니다. 또한 Windows 2019가 사용되지 않는 경우 기본 Windows OSSKU가 Windows2022로 변경됩니다.
osSKU?: "Ubuntu" | "CBLMariner" | "Windows2019" | "Windows2022"속성 값
"Ubuntu" | "CBLMariner" | "Windows2019" | "Windows2022"
osType
운영 체제 유형입니다. 기본값은 Linux입니다.
osType?: "Linux" | "Windows"속성 값
"Linux" | "Windows"
podSubnetID
생략하면 노드 서브넷에 Pod IP가 정적으로 할당됩니다(자세한 내용은 vnetSubnetID 참조). /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} 형식입니다.
podSubnetID?: string속성 값
string
powerState
에이전트 풀이 처음 만들어지면 처음에는 실행 중입니다. 이 필드를 중지됨으로 설정하여 에이전트 풀을 중지할 수 있습니다. 중지된 에이전트 풀은 모든 VM을 중지하고 청구 요금이 발생하지 않습니다. 에이전트 풀이 실행 중이고 프로비저닝 상태가 성공한 경우에만 중지할 수 있습니다.
powerState?: PowerState속성 값
proximityPlacementGroupID
근접 배치 그룹의 ID입니다.
proximityPlacementGroupID?: string속성 값
string
ManagedClusterAgentPoolProfileProperties.proximityPlacementGroupID 상속된
scaleDownMode
클러스터 자동 크기 조정기 동작에도 영향을 줍니다. 지정하지 않으면 기본적으로 Delete로 설정됩니다.
scaleDownMode?: "Delete" | "Deallocate"속성 값
"Delete" | "Deallocate"
scaleSetEvictionPolicy
scaleSetPriority가 'Spot'이 아니면 지정할 수 없습니다. 지정하지 않으면 기본값은 'Delete'입니다.
scaleSetEvictionPolicy?: "Delete" | "Deallocate"속성 값
"Delete" | "Deallocate"
ManagedClusterAgentPoolProfileProperties.scaleSetEvictionPolicy 상속된
scaleSetPriority
Virtual Machine Scale Set 우선 순위입니다. 지정하지 않으면 기본값은 'Regular'입니다.
scaleSetPriority?: "Spot" | "Regular"속성 값
"Spot" | "Regular"
ManagedClusterAgentPoolProfileProperties.scaleSetPriority 상속된
spotMaxPrice
가능한 값은 0보다 크거나 -1 값으로, 주문형 가격을 지불하려는 의지를 나타냅니다. 스폿 가격 책정에 대한 자세한 내용은 스폿 VM 가격 책정 참조하세요.
spotMaxPrice?: number속성 값
number
tags
에이전트 풀 가상 머신 확장 집합에 유지할 태그입니다.
tags?: Record<string, string>속성 값
Record<string, string>
type
에이전트 풀의 형식입니다.
type?: "VirtualMachineScaleSets" | "AvailabilitySet"속성 값
"VirtualMachineScaleSets" | "AvailabilitySet"
upgradeSettings
에이전트 풀 업그레이드 설정
upgradeSettings?: AgentPoolUpgradeSettings속성 값
ManagedClusterAgentPoolProfileProperties.upgradeSettings 상속된
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
workloadRuntime
노드에서 실행할 수 있는 워크로드 유형을 결정합니다.
workloadRuntime?: "OCIContainer" | "WasmWasi"속성 값
"OCIContainer" | "WasmWasi"
ManagedClusterAgentPoolProfileProperties.workloadRuntime 상속된
