New-AzAksNodePool

구문

defaultParameterSet

New-AzAksNodePool
    -ResourceGroupName <String>
    -ClusterName <String>
    -Name <String>
    [-Count <Int32>]
    [-OsDiskSize <Int32>]
    [-OSDiskType <String>]
    [-VmSize <String>]
    [-VnetSubnetID <String>]
    [-WorkloadRuntime <String>]
    [-MaxPodCount <Int32>]
    [-MessageOfTheDay <String>]
    [-OsType <String>]
    [-PodIPAllocationMode <String>]
    [-OsSKU <String>]
    [-EnableNodePublicIp]
    [-NodePublicIPPrefixID <String>]
    [-ScaleSetPriority <String>]
    [-ScaleSetEvictionPolicy <String>]
    [-VmSetType <String>]
    [-AvailabilityZone <String[]>]
    [-Force]
    [-EnableEncryptionAtHost]
    [-EnableUltraSSD]
    [-GatewayPublicIPPrefixSize <Int32>]
    [-GPUDriver <String>]
    [-LinuxOSConfig <LinuxOSConfig>]
    [-KubeletConfig <KubeletConfig>]
    [-PPG <String>]
    [-SpotMaxPrice <Double>]
    [-EnableFIPS]
    [-GpuInstanceProfile <String>]
    [-HostGroupID <String>]
    [-PodSubnetID <String>]
    [-KubernetesVersion <String>]
    [-MinCount <Int32>]
    [-MaxCount <Int32>]
    [-EnableAutoScaling]
    [-Mode <String>]
    [-NodeLabel <Hashtable>]
    [-Tag <Hashtable>]
    [-NodeTaint <String[]>]
    [-AksCustomHeader <Hashtable>]
    [-IfMatch <String>]
    [-IfNoneMatch <String>]
    [-NetworkProfile <AgentPoolNetworkProfile>]
    [-ScaleDownMode <String>]
    [-EnableSecureBoot]
    [-EnableVtpm]
    [-SshAccess <String>]
    [-MaxSurge <String>]
    [-MaxUnavailable <String>]
    [-DrainTimeoutInMinute <Int32>]
    [-NodeSoakDurationInMinute <Int32>]
    [-UndrainableNodeBehavior <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [-SubscriptionId <String>]
    [<CommonParameters>]

ParentObjectParameterSet

New-AzAksNodePool
    -Name <String>
    -ClusterObject <PSKubernetesCluster>
    [-Count <Int32>]
    [-OsDiskSize <Int32>]
    [-OSDiskType <String>]
    [-VmSize <String>]
    [-VnetSubnetID <String>]
    [-WorkloadRuntime <String>]
    [-MaxPodCount <Int32>]
    [-MessageOfTheDay <String>]
    [-OsType <String>]
    [-PodIPAllocationMode <String>]
    [-OsSKU <String>]
    [-EnableNodePublicIp]
    [-NodePublicIPPrefixID <String>]
    [-ScaleSetPriority <String>]
    [-ScaleSetEvictionPolicy <String>]
    [-VmSetType <String>]
    [-AvailabilityZone <String[]>]
    [-Force]
    [-EnableEncryptionAtHost]
    [-EnableUltraSSD]
    [-GatewayPublicIPPrefixSize <Int32>]
    [-GPUDriver <String>]
    [-LinuxOSConfig <LinuxOSConfig>]
    [-KubeletConfig <KubeletConfig>]
    [-PPG <String>]
    [-SpotMaxPrice <Double>]
    [-EnableFIPS]
    [-GpuInstanceProfile <String>]
    [-HostGroupID <String>]
    [-PodSubnetID <String>]
    [-KubernetesVersion <String>]
    [-MinCount <Int32>]
    [-MaxCount <Int32>]
    [-EnableAutoScaling]
    [-Mode <String>]
    [-NodeLabel <Hashtable>]
    [-Tag <Hashtable>]
    [-NodeTaint <String[]>]
    [-AksCustomHeader <Hashtable>]
    [-IfMatch <String>]
    [-IfNoneMatch <String>]
    [-NetworkProfile <AgentPoolNetworkProfile>]
    [-ScaleDownMode <String>]
    [-EnableSecureBoot]
    [-EnableVtpm]
    [-SshAccess <String>]
    [-MaxSurge <String>]
    [-MaxUnavailable <String>]
    [-DrainTimeoutInMinute <Int32>]
    [-NodeSoakDurationInMinute <Int32>]
    [-UndrainableNodeBehavior <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [-SubscriptionId <String>]
    [<CommonParameters>]

Description

예제

예제 1: 기본 매개 변수를 사용하여 노드 풀 만들기

New-AzAksNodePool -ResourceGroupName myResourceGroup -ClusterName myCluster -Name mydefault

예제 2: AKS에서 Windows Server 컨테이너 만들기

$cred = ConvertTo-SecureString -String "****" -AsPlainText -Force
New-AzAksCluster -ResourceGroupName myResourceGroup -Name myCluster -WindowsProfileAdminUserName azureuser -WindowsProfileAdminUserPassword $cred -NetworkPlugin azure -NodeVmSetType VirtualMachineScaleSets
New-AzAksNodePool -ResourceGroupName myResourceGroup -ClusterName myCluster -Name win1 -OsType Windows -VmSetType VirtualMachineScaleSets

예제 3: LinuxOSConfig 및 KubeletConfig를 사용하여 노드 풀을 만듭니다.

$linuxOsConfigJsonStr = @'
            {
             "transparentHugePageEnabled": "madvise",
             "transparentHugePageDefrag": "defer+madvise",
             "swapFileSizeMB": 1500,
             "sysctls": {
              "netCoreSomaxconn": 163849,
              "netIpv4TcpTwReuse": true,
              "netIpv4IpLocalPortRange": "32000 60000"
             }
            }
'@
$linuxOsConfig = [Microsoft.Azure.Management.ContainerService.Models.LinuxOSConfig] ($linuxOsConfigJsonStr | ConvertFrom-Json)
$kubeletConfigStr = @'
            {
             "failSwapOn": false
            }
'@
$kubeletConfig = [Microsoft.Azure.Management.ContainerService.Models.KubeletConfig] ($kubeletConfigStr | ConvertFrom-Json)

New-AzAksNodePool -ResourceGroupName myResourceGroup -ClusterName myAKSCluster -Name mypool -LinuxOSConfig $linuxOsConfig -KubeletConfig $kubeletConfig

매개 변수

-AksCustomHeader

Aks 사용자 지정 헤더

매개 변수 속성

매개 변수 집합

-AvailabilityZone

노드에 대한 가용성 영역입니다. VirtualMachineScaleSets AgentPoolType을 사용해야 합니다.

매개 변수 속성

매개 변수 집합

-ClusterName

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

매개 변수 속성

매개 변수 집합

-ClusterObject

노드 풀을 만들 클러스터 개체를 지정합니다.

매개 변수 속성

매개 변수 집합

-Confirm

cmdlet을 실행하기 전에 확인 메시지를 표시합니다.

매개 변수 속성

매개 변수 집합

-Count

노드 풀의 기본 노드 수입니다.

매개 변수 속성

매개 변수 집합

-DefaultProfile

Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.

매개 변수 속성

매개 변수 집합

-DrainTimeoutInMinute

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

매개 변수 속성

매개 변수 집합

-EnableAutoScaling

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

매개 변수 속성

매개 변수 집합

-EnableEncryptionAtHost

호스트 기반 OS 및 데이터 드라이브를 사용하도록 설정할지 여부

매개 변수 속성

매개 변수 집합

-EnableFIPS

FIPS 사용 OS 사용 여부

매개 변수 속성

매개 변수 집합

-EnableNodePublicIp

노드에 공용 IP를 사용하도록 설정할지 여부입니다.

매개 변수 속성

매개 변수 집합

-EnableSecureBoot

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

매개 변수 속성

매개 변수 집합

-EnableUltraSSD

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

매개 변수 속성

매개 변수 집합

-EnableVtpm

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

매개 변수 속성

매개 변수 집합

-Force

노드 풀이 이미 있는 경우에도 만들기

매개 변수 속성

매개 변수 집합

-GatewayPublicIPPrefixSize

게이트웨이 에이전트 풀은 각 정적 송신 게이트웨이에 대해 하나의 공용 IPPrefix를 연결하여 공용 송신을 제공합니다. 공용 IPPrefix의 크기는 사용자가 선택해야 합니다. 에이전트 풀의 각 노드는 IPPrefix에서 하나의 IP로 할당됩니다. 따라서 IPPrefix 크기는 게이트웨이 에이전트 풀의 크기에 대한 한도 역할을 합니다. Azure 공용 IPPrefix 크기 제한으로 인해 유효한 값 범위는 [28, 31]입니다(/31 = 노드/IP 2개, /30 = 노드/IP 4개, /29 = 노드/IP 8개, /28 = 노드/IP 16개). 기본값은 31입니다.

매개 변수 속성

매개 변수 집합

-GPUDriver

GPU 드라이버를 설치할지 여부입니다. 지정하지 않으면 기본값은 Install입니다.

매개 변수 속성

매개 변수 집합

-GpuInstanceProfile

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

매개 변수 속성

매개 변수 집합

-HostGroupID

가상 머신을 프로비전할 전용 호스트 그룹의 정규화된 리소스 ID로, 만든 시나리오에서만 사용되며 설정된 후에는 변경할 수 없습니다.

매개 변수 속성

매개 변수 집합

-IfMatch

엔터티가 이 문자열과 일치하는 경우에만 요청을 진행해야 합니다.

매개 변수 속성

매개 변수 집합

-IfNoneMatch

요청은 이 문자열과 일치하는 엔터티가 없는 경우에만 진행해야 합니다.

매개 변수 속성

매개 변수 집합

-KubeletConfig

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

매개 변수 속성

매개 변수 집합

-KubernetesVersion

클러스터를 만드는 데 사용할 Kubernetes 버전입니다.

매개 변수 속성

매개 변수 집합

-LinuxOSConfig

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

매개 변수 속성

매개 변수 집합

-MaxCount

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

매개 변수 속성

매개 변수 집합

-MaxPodCount

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

매개 변수 속성

매개 변수 집합

-MaxSurge

업그레이드 중에 급증한 노드의 최대 수 또는 백분율입니다.

매개 변수 속성

매개 변수 집합

-MaxUnavailable

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

매개 변수 속성

매개 변수 집합

-MessageOfTheDay

Base64로 인코딩된 Linux 노드에 대한 오늘의 메시지입니다. 디코딩 후 /etc/motd에 기록될 base64로 인코딩된 문자열입니다. 이렇게 하면 Linux 노드에 대한 오늘의 메시지를 사용자 지정할 수 있습니다. Windows 노드에 대해 지정해서는 안 됩니다. 정적 문자열이어야 합니다(즉, 원시로 인쇄되고 스크립트로 실행되지 않음).

매개 변수 속성

매개 변수 집합

-MinCount

자동 크기 조정을 위한 최소 노드 수입니다.

매개 변수 속성

매개 변수 집합

-Mode

풀 모드

매개 변수 속성

매개 변수 집합

-Name

노드 풀의 이름입니다.

매개 변수 속성

매개 변수 집합

-NetworkProfile

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

매개 변수 속성

매개 변수 집합

-NodeLabel

Kubernetes 네트워크를 빌드하는 데 사용되는 노드 풀 레이블입니다.

매개 변수 속성

매개 변수 집합

-NodePublicIPPrefixID

노드 풀에 대한 공용 IP 접두사 리소스 ID입니다.

매개 변수 속성

매개 변수 집합

-NodeSoakDurationInMinute

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

매개 변수 속성

매개 변수 집합

-NodeTaint

노드 풀 만들기 및 크기 조정 중에 새 노드에 추가된 노드 taint

매개 변수 속성

매개 변수 집합

-OsDiskSize

노드 풀의 기본 노드 수입니다.

매개 변수 속성

매개 변수 집합

-OSDiskType

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

매개 변수 속성

매개 변수 집합

-OsSKU

OS SKU를 지정하는 데 사용할 OsSKU입니다. OSType이 Linux인 경우 기본값은 Ubuntu입니다. OSType이 Windows인 경우 Kubernetes <= 1.24 또는 Windows2022인 경우 Kubernetes >= 1.25인 경우 기본값은 Windows2019입니다.

매개 변수 속성

매개 변수 집합

-OsType

OsType을 사용하여 os 형식을 지정합니다. Linux 및 Windows에서 선택합니다. 기본값은 Linux입니다.

매개 변수 속성

매개 변수 집합

-PodIPAllocationMode

Pod IP 할당 모드입니다. 에이전트 풀의 Pod에 대한 IP 할당 모드입니다. podSubnetId와 함께 사용해야 합니다. 기본값은 'DynamicIndividual'입니다.

매개 변수 속성

매개 변수 집합

-PodSubnetID

Pod가 시작될 때 조인할 서브넷의 ID입니다.

매개 변수 속성

매개 변수 집합

-PPG

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

매개 변수 속성

매개 변수 집합

-ResourceGroupName

리소스 그룹의 이름입니다.

매개 변수 속성

매개 변수 집합

-ScaleDownMode

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

매개 변수 속성

매개 변수 집합

-ScaleSetEvictionPolicy

우선 순위가 낮은 가상 머신 확장 집합에 대한 제거 정책을 지정하는 데 사용할 ScaleSetEvictionPolicy입니다. 기본값은 Delete입니다.

매개 변수 속성

매개 변수 집합

-ScaleSetPriority

가상 머신 확장 집합 우선 순위를 지정하는 데 사용할 ScaleSetPriority입니다. 기본값은 일반입니다.

매개 변수 속성

매개 변수 집합

-SpotMaxPrice

스폿 인스턴스에 대해 지불할 최대 가격(미국 달러)입니다. 가능한 값은 0보다 크거나 -1 10진수 값으로, 기본 가격이 주문형으로 up-to 것을 나타냅니다.

매개 변수 속성

매개 변수 집합

-SshAccess

에이전트 풀의 sSH 액세스 방법입니다.

매개 변수 속성

매개 변수 집합

-SubscriptionId

구독의 ID입니다. 기본적으로 cmdlet은 현재 컨텍스트에서 설정된 구독에서 실행됩니다. 사용자가 다른 구독을 지정하면 현재 cmdlet이 사용자가 지정한 구독에서 실행됩니다. 구독 재정의는 현재 cmdlet의 수명 주기 동안에만 적용됩니다. 컨텍스트에서 구독을 변경하지 않으며 후속 cmdlet에는 영향을 주지 않습니다.

매개 변수 속성

매개 변수 집합

-Tag

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

매개 변수 속성

매개 변수 집합

-UndrainableNodeBehavior

업그레이드하는 동안 표시할 수 없는 노드에 대한 동작입니다. 그리기 불가능한 노드의 가장 일반적인 원인은 Pod 중단 예산(PDB)이지만, Pod 종료 유예 기간과 같은 다른 문제는 노드당 남은 드레이닝 시간 제한을 초과하거나 Pod가 여전히 실행 중인 상태일 수도 있습니다.

매개 변수 속성

매개 변수 집합

-VmSetType

노드 풀의 형식을 나타냅니다. 가능한 값은 'VirtualMachineScaleSets', 'AvailabilitySet'입니다.

매개 변수 속성

매개 변수 집합

-VmSize

Virtual Machine의 크기입니다. 기본값은 할당량 및 용량에 따라 AKS 리소스 공급자가 동적으로 선택합니다.

매개 변수 속성

매개 변수 집합

-VnetSubnetID

VNet SubnetID는 VNet의 서브넷 식별자를 지정합니다.

매개 변수 속성

매개 변수 집합

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.

매개 변수 속성

매개 변수 집합

-WorkloadRuntime

노드가 실행할 수 있는 워크로드 유형입니다.

매개 변수 속성

매개 변수 집합

CommonParameters

입력

PSKubernetesCluster

출력

PSNodePool