ManagedClusterAgentPoolProfile interface
컨테이너 서비스 에이전트 풀에 대한 프로필입니다.
- Extends
속성
name | Windows 에이전트 풀 이름은 6자 이내여야 합니다. |
상속된 속성
availability |
노드에 사용할 가용성 영역 목록입니다. AgentPoolType 속성이 'VirtualMachineScaleSets'인 경우에만 지정할 수 있습니다. |
capacity |
AKS는 지정된 에이전트 풀을 용량 예약 그룹과 연결합니다. |
count | Docker 컨테이너를 호스트할 에이전트(VM) 수입니다. 허용되는 값은 사용자 풀의 경우 0에서 1000(포함) 범위여야 하고 시스템 풀의 경우 1~1000(포함) 범위여야 합니다. 기본값은 1입니다. |
creation |
노드 풀이 스냅샷을 사용하여 생성/업그레이드될 경우 원본 스냅샷 ID를 지정하는 데 사용할 CreationData입니다. |
current |
orchestratorVersion이 major.minor.patch><완전히 지정된 버전인 경우 이 필드는 정확히 동일합니다. orchestratorVersion이 major.minor><경우 이 필드에는 사용 중인 전체 <major.minor.patch> 버전이 포함됩니다. 참고: 이 속성은 serialize되지 않습니다. 서버에서만 채울 수 있습니다. |
enable |
자동 크기 조정기를 사용하도록 설정할지 여부 |
enable |
이는 특정 VM 크기 및 특정 Azure 지역에서만 지원됩니다. 자세한 내용은 다음을 참조하세요. https://docs.microsoft.com/azure/aks/enable-host-encryption |
enable |
자세한 내용은 FIPS 사용 노드 풀 추가를 참조하세요. |
enable |
일부 시나리오에서는 노드 풀의 노드가 자체 전용 공용 IP 주소를 수신해야 할 수 있습니다. 일반적인 시나리오는 홉을 최소화하기 위해 콘솔이 클라우드 가상 머신에 직접 연결해야 하는 게임 워크로드에 대한 것입니다. 자세한 내용은 노드당 공용 IP를 할당하는 |
enable |
UltraSSD를 사용하도록 설정할지 여부 |
e |
낙관적 동시성을 구현하는 데 사용되는 고유한 읽기 전용 문자열입니다. eTag 값은 리소스가 업데이트될 때 변경됩니다. 일반 etag 규칙에 따라 낙관적 동시성을 사용하도록 설정하려면 후속 요청에 대한 eTag 값을 사용하여 if-match 또는 if-none-match 헤더를 지정합니다. 참고: 이 속성은 serialize되지 않습니다. 서버에서만 채울 수 있습니다. |
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 수입니다. |
min |
자동 크기 조정을 위한 최소 노드 수 |
mode | 클러스터에는 항상 하나 이상의 '시스템' 에이전트 풀이 있어야 합니다. 에이전트 풀 제한 및 모범 사례에 대한 자세한 내용은 다음을 참조하세요. https://docs.microsoft.com/azure/aks/use-system-pools |
network |
에이전트 풀의 네트워크 관련 설정입니다. |
node |
노드 이미지의 버전 참고: 이 속성은 serialize되지 않습니다. 서버에서만 채울 수 있습니다. |
node |
에이전트 풀의 모든 노드에서 유지할 노드 레이블입니다. |
node |
/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName} 형식입니다. |
node |
노드 풀 만들기 및 크기 조정 중에 새 노드에 추가된 taint입니다. 예를 들어 key=value:NoSchedule입니다. |
orchestrator |
두 패치 버전 <major.minor.patch>(예: 1.20.13) 및 <major.minor>(예: 1.20)이 지원됩니다.
<major.minor> 지정하면 지원되는 최신 GA 패치 버전이 자동으로 선택됩니다. 만든 후 동일한 <major.minor> 사용하여 클러스터를 업데이트합니다(예: 1.14.x -> 1.14). 최신 패치 버전을 사용할 수 있더라도 업그레이드가 트리거되지 않습니다. AKS 클러스터의 모든 노드 풀을 동일한 Kubernetes 버전으로 업그레이드하는 것이 가장 좋습니다. 노드 풀 버전은 컨트롤 플레인과 동일한 주 버전이어야 합니다. 노드 풀 부 버전은 컨트롤 플레인 버전의 두 부 버전 내에 있어야 합니다. 노드 풀 버전은 컨트롤 플레인 버전보다 클 수 없습니다. 자세한 내용은 노드 풀업그레이드하는 |
os |
마스터/에이전트 풀의 모든 컴퓨터에 대한 디스크 크기를 지정하는 데 사용할 OS 디스크 크기(GB)입니다. 0을 지정하면 지정된 vmSize에 따라 기본 osDisk 크기가 적용됩니다. |
os |
VM이 지원하며 요청된 OSDiskSizeGB보다 큰 캐시 디스크가 있는 경우 기본값은 'Ephemeral'입니다. 그렇지 않으면 기본값은 'Managed'입니다. 만든 후에는 변경되지 않을 수 있습니다. 자세한 내용은 임시 OS참조하세요. |
osSKU | 에이전트 풀에서 사용하는 OS SKU를 지정합니다. OSType이 Linux인 경우 기본값은 Ubuntu입니다. 기본값은 Kubernetes가 Windows인 경우 Kubernetes >= 1.25인 경우 Kubernetes <= 1.24 또는 Windows2022인 경우 Windows2019입니다. |
os |
운영 체제 유형입니다. 기본값은 Linux입니다. |
pod |
생략하면 노드 서브넷에 Pod IP가 정적으로 할당됩니다(자세한 내용은 vnetSubnetID 참조). /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} 형식입니다. |
power |
에이전트 풀이 처음 만들어지면 처음에는 실행 중입니다. 이 필드를 중지됨으로 설정하여 에이전트 풀을 중지할 수 있습니다. 중지된 에이전트 풀은 모든 VM을 중지하고 청구 요금이 발생하지 않습니다. 에이전트 풀이 실행 중이고 프로비저닝 상태가 성공한 경우에만 중지할 수 있습니다. |
provisioning |
현재 배포 또는 프로비저닝 상태입니다. 참고: 이 속성은 serialize되지 않습니다. 서버에서만 채울 수 있습니다. |
proximity |
근접 배치 그룹의 ID입니다. |
scale |
클러스터 자동 크기 조정기 동작에도 영향을 줍니다. 지정하지 않으면 기본적으로 Delete로 설정됩니다. |
scale |
scaleSetPriority가 'Spot'이 아니면 지정할 수 없습니다. 지정하지 않으면 기본값은 'Delete'입니다. |
scale |
Virtual Machine Scale Set 우선 순위입니다. 지정하지 않으면 기본값은 'Regular'입니다. |
security |
에이전트 풀의 보안 설정입니다. |
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} 형식입니다. |
windows |
Windows 에이전트 풀의 특정 프로필입니다. |
workload |
노드에서 실행할 수 있는 워크로드 유형을 결정합니다. |
속성 세부 정보
name
Windows 에이전트 풀 이름은 6자 이내여야 합니다.
name: string
속성 값
string
상속된 속성 세부 정보
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
속성 값
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를 할당하는
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
속성 값
kubeletDiskType
emptyDir 볼륨, 컨테이너 런타임 데이터 루트 및 Kubelet 임시 스토리지의 배치를 결정합니다.
kubeletDiskType?: string
속성 값
string
linuxOSConfig
Linux 에이전트 노드의 OS 구성입니다.
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
속성 값
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
속성 값
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
속성 값
spotMaxPrice
가능한 값은 0보다 크거나 -1 값으로, 주문형 가격을 지불하려는 의지를 나타냅니다. 스폿 가격 책정에 대한 자세한 내용은 스폿 VM 가격 책정 참조하세요.
spotMaxPrice?: number
속성 값
number
tags
에이전트 풀 가상 머신 확장 집합에 유지할 태그입니다.
tags?: {[propertyName: string]: string}
속성 값
{[propertyName: string]: string}
type
에이전트 풀의 형식입니다.
type?: string
속성 값
string
upgradeSettings
에이전트 풀 업그레이드 설정
upgradeSettings?: 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
속성 값
workloadRuntime
노드에서 실행할 수 있는 워크로드 유형을 결정합니다.
workloadRuntime?: string
속성 값
string