다음을 통해 공유

Agent Pools - Get

  • 참조
서비스:
AKS
API 버전:
2024-09-01

지정된 관리형 클러스터 에이전트 풀을 가져옵니다.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/agentPools/{agentPoolName}?api-version=2024-09-01

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
agentPoolName
 path True

string

에이전트 풀의 이름입니다.

regex 패턴: ^[a-z][a-z0-9]{0,11}$
resourceGroupName
 path True

string

리소스 그룹의 이름입니다. 이름은 대/소문자를 구분하지 않습니다.
resourceName
 path True

string

관리되는 클러스터 리소스의 이름입니다.

regex 패턴: ^[a-zA-Z0-9]$|^[a-zA-Z0-9][-_a-zA-Z0-9]{0,61}[a-zA-Z0-9]$
subscriptionId
 path True

string

uuid

대상 구독의 ID입니다. 값은 UUID여야 합니다.
api-version
 query True

string

이 작업에 사용할 API 버전입니다.

응답

Name 형식 Description
200 OK

AgentPool

그래
Other Status Codes

CloudError

작업이 실패한 이유를 설명하는 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 Flow

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name Description
user_impersonation 사용자 계정 가장

예제

Get Agent Pool

샘플 요청

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1?api-version=2024-09-01

샘플 응답

상태 코드:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "Succeeded",
    "count": 3,
    "vmSize": "Standard_DS1_v2",
    "maxPods": 110,
    "osType": "Linux",
    "eTag": "ebwiyfneowv",
    "orchestratorVersion": "1.9.6",
    "currentOrchestratorVersion": "1.9.6",
    "nodeImageVersion": "AKSUbuntu:1604:2020.03.11",
    "upgradeSettings": {
      "maxSurge": "33%"
    }
  }
}

정의

Name Description
AgentPool

에이전트 풀.
AgentPoolMode

에이전트 풀의 모드입니다.
AgentPoolNetworkProfile

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

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

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

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

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

컨테이너 서비스의 오류 응답입니다.
CloudErrorBody

컨테이너 서비스의 오류 응답입니다.
code

클러스터가 실행 중인지 또는 중지되었는지 여부를 알려줍니다.
CreationData

원본 리소스에서 대상 리소스를 만들 때 사용되는 데이터입니다.
GPUInstanceProfile

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

개체와 연결된 IPTag를 포함합니다.
KubeletConfig

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

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

Linux 에이전트 노드의 OS 구성.
OSDiskType

에이전트 풀의 컴퓨터에 사용할 OS 디스크 유형입니다.
OSSKU

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

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

포트 범위입니다.
PowerState

클러스터의 전원 상태를 설명합니다.
Protocol

포트의 네트워크 프로토콜입니다.
ScaleDownMode

VM이 에이전트 풀에 추가되거나 에이전트 풀에서 제거되는 방법을 설명합니다. 청구 상태참조하세요.
ScaleSetEvictionPolicy

Virtual Machine Scale Set 제거 정책입니다.
ScaleSetPriority

Virtual Machine Scale Set 우선 순위입니다.
SysctlConfig

Linux 에이전트 노드에 대한 Sysctl 설정입니다.
WorkloadRuntime

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

AgentPool

에이전트 풀.

Name 형식 Default value Description
id

string

리소스 ID입니다.
name

string

리소스 그룹 내에서 고유한 리소스의 이름입니다. 이 이름은 리소스에 액세스하는 데 사용할 수 있습니다.
properties.availabilityZones

string[]

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

string

예약된 Virtual Machines 그룹의 가상 머신을 제공하기 위한 용량 예약 그룹의 정규화된 리소스 ID입니다.
AKS는 지정된 에이전트 풀을 용량 예약 그룹과 연결합니다.
properties.count

integer

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

CreationData

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

string

에이전트 풀이 실행 중인 Kubernetes의 버전입니다.
orchestratorVersion이 major.minor.patch><완전히 지정된 버전인 경우 이 필드는 정확히 동일합니다. orchestratorVersion이 major.minor><경우 이 필드에는 사용 중인 전체 <major.minor.patch> 버전이 포함됩니다.
properties.eTag

string

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

boolean

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

boolean

호스트 기반 OS 및 데이터 드라이브 암호화를 사용하도록 설정할지 여부입니다.
이는 특정 VM 크기 및 특정 Azure 지역에서만 지원됩니다. 자세한 내용은 다음을 참조하세요. https://docs.microsoft.com/azure/aks/enable-host-encryption
properties.enableFIPS

boolean

FIPS 사용 OS를 사용할지 여부입니다.
자세한 내용은 FIPS 사용 노드 풀 추가를 참조하세요.
properties.enableNodePublicIP

boolean

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

boolean

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

GPUInstanceProfile

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

string

가상 머신을 프로비전할 전용 호스트 그룹의 정규화된 리소스 ID로, 만든 시나리오에서만 사용되며 설정된 후에는 변경할 수 없습니다.
/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}의 형식입니다. 자세한 내용은 Azure 전용 호스트참조하세요.
properties.kubeletConfig

KubeletConfig

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

KubeletDiskType

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

LinuxOSConfig

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

integer

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

integer

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

integer

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

AgentPoolMode

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

AgentPoolNetworkProfile

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

string

노드 이미지의 버전
properties.nodeLabels

object

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

string

VM 노드에서 IP를 사용해야 하는 공용 IP 접두사 ID입니다.
/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName} 형식입니다.
properties.nodeTaints

string[]

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

string

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

integer

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

OSDiskType

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

OSSKU

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

OSType

Linux

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

string

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

PowerState

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

string

현재 배포 또는 프로비저닝 상태입니다.
properties.proximityPlacementGroupID

string

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

ScaleDownMode

에이전트 풀을 스케일링할 때 사용할 스케일 다운 모드입니다.
클러스터 자동 크기 조정기 동작에도 영향을 줍니다. 지정하지 않으면 기본적으로 Delete로 설정됩니다.
properties.scaleSetEvictionPolicy

ScaleSetEvictionPolicy

Delete

사용할 Virtual Machine Scale Set 제거 정책입니다.
scaleSetPriority가 'Spot'이 아니면 지정할 수 없습니다. 지정하지 않으면 기본값은 'Delete'입니다.
properties.scaleSetPriority

ScaleSetPriority

Regular

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

AgentPoolSecurityProfile

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

number

-1

스폿 인스턴스에 대해 지불할 최대 가격(미국 달러)입니다. 가능한 값은 0보다 크거나 -1 10진수 값으로, 기본 가격이 주문형으로 up-to 것을 나타냅니다.
가능한 값은 0보다 크거나 -1 값으로, 주문형 가격을 지불하려는 의지를 나타냅니다. 스폿 가격 책정에 대한 자세한 내용은 스폿 VM 가격 책정 참조하세요.
properties.tags

object

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

AgentPoolType

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

AgentPoolUpgradeSettings

에이전트 풀 업그레이드 설정
properties.vmSize

string

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

string

에이전트 풀 노드 및 선택적으로 Pod가 시작할 때 조인할 서브넷의 ID입니다.
지정하지 않으면 VNET 및 서브넷이 생성되고 사용됩니다. podSubnetID를 지정하지 않으면 노드 및 Pod에 적용되고, 그렇지 않으면 노드에만 적용됩니다. /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} 형식입니다.
properties.windowsProfile

AgentPoolWindowsProfile

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

WorkloadRuntime

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

string

리소스 종류

AgentPoolMode

에이전트 풀의 모드입니다.

Name 형식 Description
System

string

시스템 에이전트 풀은 주로 CoreDNS 및 메트릭 서버와 같은 중요한 시스템 Pod를 호스팅하는 데 사용됩니다. 시스템 에이전트 풀 osType은 Linux여야 합니다. 시스템 에이전트 풀 VM SKU에는 2vCPU 및 4GB 이상의 메모리가 있어야 합니다.
User

string

사용자 에이전트 풀은 주로 애플리케이션 Pod를 호스팅하기 위한 것입니다.

AgentPoolNetworkProfile

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

Name 형식 Description
allowedHostPorts

PortRange[]

액세스할 수 있는 포트 범위입니다. 지정된 범위는 겹칠 수 있습니다.
applicationSecurityGroups

string[]

에이전트 풀을 만들 때 연결할 애플리케이션 보안 그룹의 ID입니다.
nodePublicIPTags

IPTag[]

인스턴스 수준 공용 IP의 IPTag입니다.

AgentPoolSecurityProfile

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

Name 형식 Description
enableSecureBoot

boolean

보안 부팅은 서명된 운영 체제와 드라이버만 부팅할 수 있도록 하는 신뢰할 수 있는 시작의 기능입니다. 자세한 내용은 aka.ms/aks/trustedlaunch 참조하세요. 지정하지 않으면 기본값은 false입니다.
enableVTPM

boolean

vTPM은 노드에서 로컬로 유지되는 키 및 측정값에 대한 전용 보안 자격 증명 모음을 구성하기 위한 신뢰할 수 있는 시작 기능입니다. 자세한 내용은 aka.ms/aks/trustedlaunch 참조하세요. 지정하지 않으면 기본값은 false입니다.

AgentPoolType

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

Name 형식 Description
AvailabilitySet

string

이 사용은 권장되지 않습니다.
VirtualMachineScaleSets

string

Virtual Machine Scale Set에서 지원되는 에이전트 풀을 만듭니다.

AgentPoolUpgradeSettings

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

Name 형식 Description
drainTimeoutInMinutes

integer

노드의 드레이닝 시간 제한
Pod 제거 및 노드당 정상 종료를 대기하는 데 걸리는 시간(분)입니다. 이 제거 대기 시간은 Pod 중단 예산을 기다리는 것을 존중합니다. 이 시간을 초과하면 업그레이드가 실패합니다. 지정하지 않으면 기본값은 30분입니다.
maxSurge

string

업그레이드 중에 급증한 노드의 최대 수 또는 백분율입니다.
정수(예: '5') 또는 백분율(예: '50%')으로 설정할 수 있습니다. 백분율을 지정하면 업그레이드 시 총 에이전트 풀 크기의 백분율입니다. 백분율의 경우 소수 노드가 반올림됩니다. 지정하지 않으면 기본값은 1입니다. 모범 사례를 포함한 자세한 내용은 다음을 참조하세요. https://docs.microsoft.com/azure/aks/upgrade-cluster#customize-node-surge-upgrade
nodeSoakDurationInMinutes

integer

노드에 대한 스며들기 기간
노드를 드레이닝한 후 다시 이미지로 다시 설치하고 다음 노드로 이동하기 전에 대기할 시간(분)입니다. 지정하지 않으면 기본값은 0분입니다.

AgentPoolWindowsProfile

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

Name 형식 Description
disableOutboundNat

boolean

Windows 노드에서 OutboundNAT를 사용하지 않도록 설정할지 여부
기본값은 false입니다. 아웃바운드 NAT는 클러스터 outboundType이 NAT 게이트웨이이고 Windows 에이전트 풀에 노드 공용 IP가 활성화되지 않은 경우에만 사용하지 않도록 설정할 수 있습니다.

CloudError

컨테이너 서비스의 오류 응답입니다.

Name 형식 Description
error

CloudErrorBody

오류에 대한 세부 정보입니다.

CloudErrorBody

컨테이너 서비스의 오류 응답입니다.

Name 형식 Description
code

string

오류의 식별자입니다. 코드는 고정적이며 프로그래밍 방식으로 사용할 수 있습니다.
details

CloudErrorBody[]

오류에 대한 추가 세부 정보 목록입니다.
message

string

사용자 인터페이스에 표시하기에 적합한 오류를 설명하는 메시지입니다.
target

string

특정 오류의 대상입니다. 예를 들어 오류가 발생한 속성의 이름입니다.

code

클러스터가 실행 중인지 또는 중지되었는지 여부를 알려줍니다.

Name 형식 Description
Running

string

클러스터가 실행 중입니다.
Stopped

string

클러스터가 중지되었습니다.

CreationData

원본 리소스에서 대상 리소스를 만들 때 사용되는 데이터입니다.

Name 형식 Description
sourceResourceId

string

대상 개체를 만드는 데 사용할 원본 개체의 ARM ID입니다.

GPUInstanceProfile

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

Name 형식 Description
MIG1g

string

MIG2g

string

MIG3g

string

MIG4g

string

MIG7g

string

IPTag

개체와 연결된 IPTag를 포함합니다.

Name 형식 Description
ipTagType

string

IP 태그 유형입니다. 예: RoutingPreference.
tag

string

공용 IP와 연결된 IP 태그의 값입니다. 예: 인터넷.

KubeletConfig

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

Name 형식 Description
allowedUnsafeSysctls

string[]

안전하지 않은 sysctls 또는 안전하지 않은 sysctl 패턴(*종료)의 허용된 목록입니다.
containerLogMaxFiles

integer

컨테이너에 대해 존재할 수 있는 컨테이너 로그 파일의 최대 수입니다. 숫자는 ≥ 2여야 합니다.
containerLogMaxSizeMB

integer

회전하기 전의 컨테이너 로그 파일의 최대 크기(예: 10Mi)입니다.
cpuCfsQuota

boolean

CPU 제한을 지정하는 컨테이너에 대해 CPU CFS 할당량 적용을 사용하도록 설정한 경우
기본값은 true입니다.
cpuCfsQuotaPeriod

string

CPU CFS 할당량 기간 값입니다.
기본값은 '100ms'입니다. 유효한 값은 선택적 분수와 단위 접미사가 있는 소수 자릿수의 시퀀스입니다. 예: '300ms', '2h45m'. 지원되는 단위는 'ns', 'us', 'ms', 's', 'm' 및 'h'입니다.
cpuManagerPolicy

string

사용할 CPU 관리자 정책입니다.
기본값은 'none'입니다. 자세한 내용은 Kubernetes CPU 관리 정책 참조하세요. 허용되는 값은 'none' 및 'static'입니다.
failSwapOn

boolean

true로 설정하면 노드에서 교환이 활성화된 경우 Kubelet이 시작되지 않습니다.
imageGcHighThreshold

integer

이미지 가비지 수집이 항상 실행되는 후 디스크 사용량의 백분율입니다.
이미지 가비지 수집을 사용하지 않도록 설정하려면 100으로 설정합니다. 기본값은 85%
imageGcLowThreshold

integer

이미지 가비지 수집이 실행되지 않는 이전의 디스크 사용 비율입니다.
imageGcHighThreshold보다 높게 설정할 수 없습니다. 기본값은 80%
podMaxPids

integer

Pod당 최대 프로세스 수입니다.
topologyManagerPolicy

string

사용할 토폴로지 관리자 정책입니다.
자세한 내용은 Kubernetes 토폴로지 관리자참조하세요. 기본값은 'none'입니다. 허용되는 값은 'none', 'best-effort', 'restricted' 및 'single-numa-node'입니다.

KubeletDiskType

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

Name 형식 Description
OS

string

Kubelet은 해당 데이터에 OS 디스크를 사용합니다.
Temporary

string

Kubelet은 해당 데이터에 임시 디스크를 사용합니다.

LinuxOSConfig

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

Name 형식 Description
swapFileSizeMB

integer

각 노드에서 만들 스왑 파일의 크기(MB)입니다.
sysctls

SysctlConfig

Linux 에이전트 노드에 대한 Sysctl 설정입니다.
transparentHugePageDefrag

string

커널이 메모리 압축을 적극적으로 사용하여 더 많은 거대한 페이지를 사용할 수 있도록 해야 하는지 여부입니다.
유효한 값은 'always', 'defer', 'defer+madvise', 'madvise' 및 'never'입니다. 기본값은 'madvise'입니다. 자세한 내용은 Transparent Hugepages참조하세요.
transparentHugePageEnabled

string

투명한 거대한 페이지를 사용할 수 있는지 여부입니다.
유효한 값은 'always', 'madvise' 및 'never'입니다. 기본값은 'always'입니다. 자세한 내용은 Transparent Hugepages참조하세요.

OSDiskType

에이전트 풀의 컴퓨터에 사용할 OS 디스크 유형입니다.

Name 형식 Description
Ephemeral

string

임시 OS 디스크는 임시 디스크처럼 호스트 컴퓨터에만 저장됩니다. 이렇게 하면 더 빠른 노드 크기 조정 및 클러스터 업그레이드와 함께 읽기/쓰기 대기 시간이 줄어듭니다.
Managed

string

Azure는 VM을 다른 호스트로 재배치해야 하는 경우 데이터 손실을 방지하기 위해 가상 머신의 운영 체제 디스크를 Azure Storage에 복제합니다. 컨테이너는 로컬 상태를 유지하도록 설계되지 않았기 때문에 이 동작은 느린 노드 프로비저닝 및 더 높은 읽기/쓰기 대기 시간을 포함하여 몇 가지 단점을 제공하면서 제한된 값을 제공합니다.

OSSKU

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

Name 형식 Description
AzureLinux

string

노드 이미지에 대한 OS로 AzureLinux를 사용합니다. Azure Linux는 Microsoft에서 빌드한 컨테이너 최적화 Linux 배포판으로, 자세한 내용은 https://aka.ms/azurelinux 방문하세요.
CBLMariner

string

사용되지 않는 OSSKU입니다. 대신 새 배포에서 'AzureLinux'를 선택하는 것이 좋습니다.
Ubuntu

string

노드 이미지의 OS로 Ubuntu를 사용합니다.
Windows2019

string

노드 이미지의 OS로 Windows2019를 사용합니다. 시스템 노드 풀에 대해 지원되지 않습니다. Windows2019는 Windows2019 컨테이너만 지원합니다. Windows2022 컨테이너를 실행할 수 없으며 그 반대의 경우도 마찬가지입니다.
Windows2022

string

노드 이미지의 OS로 Windows2022를 사용합니다. 시스템 노드 풀에 대해 지원되지 않습니다. Windows2022는 Windows2022 컨테이너만 지원합니다. Windows2019 컨테이너를 실행할 수 없으며 그 반대의 경우도 마찬가지입니다.

OSType

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

Name 형식 Description
Linux

string

Linux를 사용합니다.
Windows

string

Windows를 사용합니다.

PortRange

포트 범위입니다.

Name 형식 Description
portEnd

integer

범위에 포함된 최대 포트입니다. 범위는 1에서 65535까지여야 하며 portStart보다 크거나 같아야 합니다.
portStart

integer

범위에 포함된 최소 포트입니다. 범위는 1에서 65535까지이고 portEnd보다 작거나 같아야 합니다.
protocol

Protocol

포트의 네트워크 프로토콜입니다.

PowerState

클러스터의 전원 상태를 설명합니다.

Name 형식 Description
code

code

클러스터가 실행 중인지 또는 중지되었는지 여부를 알려줍니다.

Protocol

포트의 네트워크 프로토콜입니다.

Name 형식 Description
TCP

string

TCP 프로토콜입니다.
UDP

string

UDP 프로토콜입니다.

ScaleDownMode

VM이 에이전트 풀에 추가되거나 에이전트 풀에서 제거되는 방법을 설명합니다. 청구 상태참조하세요.

Name 형식 Description
Deallocate

string

스케일 업 중에 할당 취소된 인스턴스(있는 경우)를 시작하고 스케일 다운 중에 인스턴스의 할당을 취소하려고 시도합니다.
Delete

string

스케일 업 중에 새 인스턴스를 만들고 스케일 다운 중에 인스턴스를 제거합니다.

ScaleSetEvictionPolicy

Virtual Machine Scale Set 제거 정책입니다.

Name 형식 Description
Deallocate

string

노드 풀의 기본 확장 집합에 있는 노드는 제거 시 중지된 할당 취소됨 상태로 설정됩니다. 중지된 할당 취소 상태의 노드가 컴퓨팅 할당량에 대해 계산 할당량에 대해 계산되고 클러스터 크기 조정 또는 업그레이드에 문제가 발생할 수 있습니다.
Delete

string

노드 풀의 기본 확장 집합에 있는 노드는 제거될 때 삭제됩니다.

ScaleSetPriority

Virtual Machine Scale Set 우선 순위입니다.

Name 형식 Description
Regular

string

일반 VM이 사용됩니다.
Spot

string

우선 순위가 지정된 VM이 사용됩니다. 스폿 노드에 대한 SLA가 없습니다. 자세한 내용은 AKS 지점을 참조하세요.

SysctlConfig

Linux 에이전트 노드에 대한 Sysctl 설정입니다.

Name 형식 Description
fsAioMaxNr

integer

Sysctl 설정 fs.aio-max-nr.
fsFileMax

integer

Sysctl 설정 fs.file-max.
fsInotifyMaxUserWatches

integer

Sysctl 설정 fs.inotify.max_user_watches.
fsNrOpen

integer

Sysctl 설정 fs.nr_open.
kernelThreadsMax

integer

Sysctl 설정 kernel.threads-max.
netCoreNetdevMaxBacklog

integer

Sysctl 설정 net.core.netdev_max_backlog.
netCoreOptmemMax

integer

Sysctl 설정 net.core.optmem_max.
netCoreRmemDefault

integer

Sysctl 설정 net.core.rmem_default.
netCoreRmemMax

integer

Sysctl 설정 net.core.rmem_max.
netCoreSomaxconn

integer

sysctl setting net.core.somaxconn.
netCoreWmemDefault

integer

Sysctl 설정 net.core.wmem_default.
netCoreWmemMax

integer

Sysctl 설정 net.core.wmem_max.
netIpv4IpLocalPortRange

string

Sysctl 설정 net.ipv4.ip_local_port_range.
netIpv4NeighDefaultGcThresh1

integer

Sysctl 설정 net.ipv4.neigh.default.gc_thresh1.
netIpv4NeighDefaultGcThresh2

integer

Sysctl 설정 net.ipv4.neigh.default.gc_thresh2.
netIpv4NeighDefaultGcThresh3

integer

Sysctl 설정 net.ipv4.neigh.default.gc_thresh3.
netIpv4TcpFinTimeout

integer

Sysctl 설정 net.ipv4.tcp_fin_timeout.
netIpv4TcpKeepaliveProbes

integer

Sysctl 설정 net.ipv4.tcp_keepalive_probes.
netIpv4TcpKeepaliveTime

integer

Sysctl 설정 net.ipv4.tcp_keepalive_time.
netIpv4TcpMaxSynBacklog

integer

Sysctl 설정 net.ipv4.tcp_max_syn_backlog.
netIpv4TcpMaxTwBuckets

integer

Sysctl 설정 net.ipv4.tcp_max_tw_buckets.
netIpv4TcpTwReuse

boolean

Sysctl 설정 net.ipv4.tcp_tw_reuse.
netIpv4TcpkeepaliveIntvl

integer

Sysctl 설정 net.ipv4.tcp_keepalive_intvl.
netNetfilterNfConntrackBuckets

integer

Sysctl 설정 net.netfilter.nf_conntrack_buckets.
netNetfilterNfConntrackMax

integer

Sysctl 설정 net.netfilter.nf_conntrack_max.
vmMaxMapCount

integer

Sysctl 설정 vm.max_map_count.
vmSwappiness

integer

Sysctl 설정 vm.swappiness.
vmVfsCachePressure

integer

Sysctl 설정 vm.vfs_cache_pressure.

WorkloadRuntime

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

Name 형식 Description
OCIContainer

string

노드는 Kubelet을 사용하여 표준 OCI 컨테이너 워크로드를 실행합니다.
WasmWasi

string

노드는 Krustlet을 사용하여 WASI 공급자(미리 보기)를 사용하여 WASM 워크로드를 실행합니다.