New-AksHciCluster

개요

새 관리되는 Kubernetes 클러스터를 만듭니다.

Syntax

New-AksHciCluster -name <String>
                 [-nodePoolName <String>]
                 [-kubernetesVersion <String>]
                 [-controlPlaneNodeCount <int>]
                 [-linuxNodeCount <int>]
                 [-windowsNodeCount <int>]
                 [-controlPlaneVmSize <VmSize>]
                 [-loadBalancerVmSize <VmSize>]
                 [-loadBalancerSettings <loadBalancer>]
                 [-linuxNodeVmSize <VmSize>]
                 [-windowsNodeVmSize <VmSize>]
                 [-taints <Taint>]
                 [-nodeMaxPodCount <int>]
                 [-vnet <Virtual Network>]
                 [-primaryNetworkPlugin <Network Plugin>]   
                 [-enableAdAuth]
                 [-enableMonitoring]
                 [-enableAutoScaler] 
                 [-autoScalerProfileName]

참고

위의 매개 변수 집합은 향후 릴리스에서 더 이상 사용되지 않을 예정입니다. 이 집합은 여전히 지원되며 매개 변수를 사용하여 실행할 New-AksHciCluster-name 때 기본 동작이 됩니다. 유일한 필수 매개 변수입니다. Azure Stack HCI 및 Windows Server의 AKS는 클러스터 배포 환경에 노드 풀을 도입하고 있으며 이제 다음 매개 변수 집합을 지원합니다. 새 노드 풀 환경에 대한 자세한 내용은 클러스터에 대한 여러 노드 풀 만들기 및 관리를 참조하세요.

New-AksHciCluster -name <String>
                 [-kubernetesVersion <String>]
                 [-controlPlaneNodeCount <int>]
                 [-controlPlaneVmSize <VmSize>]
                 [-loadBalancerVmSize <VmSize>]
                 [-nodePoolName <String>]
                 [-nodeCount <int>]
                 [-nodeVmSize <VmSize>]
                 [-osType {linux, windows}]
                 [-vnet <Virtual Network>]
                 [-primaryNetworkPlugin <Network Plugin>]   
                 [-enableAdAuth]
                 [-enableMonitoring]
                 [-enableAutoScaler] 
                 [-autoScalerProfileName]
더 이상 사용되지 않을 매개 변수 도입된 매개 변수
linuxNodeCount nodePoolName
windowsNodeCount nodeCount
linuxNodeVmSize nodeVmSize
windowsNodeVmSize osType

Description

Azure Stack HCI 또는 Windows Server 클러스터에서 새 Azure Kubernetes Service 만듭니다.

예제

필요한 매개 변수가 있는 Azure Stack HCI 및 Windows Server 클러스터의 새 AKS

New-AksHciCluster -name mycluster

참고

클러스터 이름에 하이픈을 포함하지 마세요. 그렇지 않으면 클러스터 만들기가 실패할 수 있습니다.

위의 예제에서는 하나의 컨트롤 플레인 노드가 있는 클러스터, 노드 수가 1인 mycluster-linux라는 Linux 노드 풀 및 mycluster-windows라는 빈 Windows 노드 풀을 배포합니다. Set-AksHciCluster 명령을 사용하여 작업자 노드의 크기를 조정하거나 Set-AksHciNodePool 명령을 사용하여 노드 풀별로 크기를 조정할 수 있습니다.

출력

ProvisioningState     : provisioned
KubernetesVersion     : v1.20.7
NodePools             : {mycluster-linux, mycluster-windows}
WindowsNodeCount      : 0
LinuxNodeCount        : 1
ControlPlaneNodeCount : 1
Name                  : mycluster

새 매개 변수 집합의 기본값이 있는 새 AKS-HCI 클러스터

PS C:\ New-AksHciCluster -name mycluster -nodePoolName nodepool1

출력

ProvisioningState     : provisioned
KubernetesVersion     : v1.20.7
NodePools             : nodepool1
WindowsNodeCount      : 0
LinuxNodeCount        : 0
ControlPlaneNodeCount : 1
Name                  : mycluster

참고

위의 예제와 같이 새 매개 변수 집합을 사용하는 경우 출력의 WindowsNodeCount 필드 및 LinuxNodeCount 필드가 정확하지 않으며 항상 다음과 같이 0표시됩니다. Windows 또는 Linux 노드의 계산 횟수를 얻으려면 Get-AksHciNodePool 명령을 사용합니다.

위의 명령은 기본값을 사용하여 클러스터를 배포합니다. 배포된 클러스터는 두 번째 예제 명령이 배포하는 것과 동일한 클러스터입니다.

Linux 노드 풀이 있는 새 AKS-HCI 클러스터

New-AksHciCluster -name mycluster -nodePoolName nodepool1 -nodeCount 1 -nodeVmSize Standard_K8S3_v1 -osType linux

Windows 노드 풀이 있는 새 AKS-HCI 클러스터

New-AksHciCluster -name mycluster -nodePoolName nodepool1 -nodeCount 1 -nodeVmSize Standard_K8S3_v1 -osType windows

Linux 노드 풀 및 taint가 있는 새 AKS-HCI 클러스터

New-AksHciCluster -name mycluster -nodePoolName nodepool1 -nodeCount 1 -osType linux -taints sku=gpu:NoSchedule

Linux 노드 풀 및 최대 Pod 수가 있는 새 AKS-HCI 클러스터

New-AksHciCluster -name mycluster -nodePoolName nodepool1 -nodeCount 1 -osType linux -nodeMaxPodCount 100

사용자 지정 VM 크기를 사용하는 새 AKS-HCI 클러스터

New-AksHciCluster -name mycluster -controlPlaneVmSize Standard_D4s_v3 -loadBalancerVmSize Standard_A4_v2 -nodePoolName nodepool1 -nodeCount 3 -nodeVmSize Standard_D8s_v3

고가용성 컨트롤 플레인 노드가 있는 새 AKS-HCI 클러스터

New-AksHciCluster -name mycluster -controlPlaneNodeCount 3 -nodePoolName nodepool1 -nodeCount 3

모니터링을 사용하도록 설정된 새 AKS-HCI 클러스터

New-AksHciCluster -name mycluster -nodePoolName nodepool1 -nodeCount 3 -enableMonitoring

AD 인증을 사용하도록 설정된 새 AKS-HCI 클러스터

New-AksHciCluster -name mycluster -nodePoolName nodepool1 -nodeCount 3 -enableAdAuth

특정 Kubernetes 버전을 사용하는 새 AKS-HCI 클러스터

New-AksHciCluster -name mycluster -nodePoolName nodepool1 -nodeCount 3 -kubernetesVersion v1.21.2

자동 크기 조정기가 사용하도록 설정된 새 AKS-HCI 클러스터 및 기본 자동 크기 조정기 구성 프로필

New-AksHciCluster -name mycluster -enableAutoScaler $true

자동 크기 조정기가 사용하도록 설정된 새 AKS-HCI 클러스터 및 명명된 자동 크기 조정기 구성 프로필

New-AksHciCluster -name mycluster -enableAutoScaler $true -autoScalerProfileName myAutoScalerProfile

매개 변수

-name

Kubernetes 클러스터의 이름입니다. 클러스터 이름에 하이픈을 포함하지 마세요. 그렇지 않으면 클러스터 만들기가 실패할 수 있습니다.

Type: System.String
Parameter Sets: (All)
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-kubernetesVersion

배포하려는 Kubernetes의 버전입니다. 기본값은 최신 버전입니다. 사용 가능한 버전 목록을 얻으려면 Get-AksHciKubernetesVersion을 실행합니다.

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value:  v1.20.7
Accept pipeline input: False
Accept wildcard characters: False

-controlPlaneNodeCount

컨트롤 플레인의 노드 수입니다. 기본값은 1입니다.

Type: System.Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: 1
Accept pipeline input: False
Accept wildcard characters: False

-controlPlaneVmSize

컨트롤 플레인 VM의 크기입니다. 기본값은 Standard_A4_V2. 사용 가능한 VM 크기 목록을 얻으려면 Get-AksHciVmSize를 실행합니다.

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: Standard_A4_V2
Accept pipeline input: False
Accept wildcard characters: False

-loadBalancerVmSize

부하 분산 장치 VM의 크기입니다. 기본값은 Standard_A4_V2. 사용 가능한 VM 크기 목록을 얻으려면 Get-AksHciVmSize를 실행합니다.

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: Standard_A4_V2
Accept pipeline input: False
Accept wildcard characters: False

-loadBalancerSettings

New-AksHciLoadBalancerSetting을 사용하여 만든 부하 분산 장치 설정 개체입니다.

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-linuxNodeCount

Kubernetes 클러스터의 Linux 노드 수입니다. 기본값은 1입니다. 이 매개 변수는 향후 릴리스에서 더 이상 사용되지 않습니다.

Type: System.Int32
Parameter Sets: (All)
Aliases: 

Required: False
Position: Named
Default value: 1
Accept pipeline input: False
Accept wildcard characters: False

-windowsNodeCount

Kubernetes 클러스터의 Windows 노드 수입니다. 기본값은 0입니다. 이 매개 변수는 향후 릴리스에서 더 이상 사용되지 않습니다.

Type: System.Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False

-linuxNodeVmSize

Linux 노드 VM의 크기입니다. 기본값은 Standard_K8S3_v1. 사용 가능한 VM 크기 목록을 얻으려면 다음을 실행 Get-AksHciVmSize합니다. 이 매개 변수는 향후 릴리스에서 더 이상 사용되지 않습니다.

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: Standard_K8S3_v1
Accept pipeline input: False
Accept wildcard characters: False

-windowsNodeVmSize

Windows 노드 VM의 크기입니다. 기본값은 Standard_K8S3_v1. 사용 가능한 VM 크기 목록을 얻으려면 다음을 실행 Get-AksHciVmSize합니다. 이 매개 변수는 향후 릴리스에서 더 이상 사용되지 않습니다.

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: Standard_K8S3_v1
Accept pipeline input: False
Accept wildcard characters: False

-taints

노드가 노드 풀에 대해 오염됩니다. 노드 풀을 만든 후에는 노드 taint를 변경할 수 없습니다.

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-nodeMaxPodCount

노드로 배포할 수 있는 Pod의 최대 수입니다. 이 숫자는 50보다 커야 합니다.

Type: System.Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: 110
Accept pipeline input: False
Accept wildcard characters: False

-nodePoolName

노드 풀의 이름입니다. 새 노드 풀 환경의 일부로 새 매개 변수입니다.

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-nodeCount

노드 풀의 노드 수입니다. 매개 변수 -nodePoolName 를 사용하는 경우 기본값은 1입니다. 새 노드 풀 환경의 일부로 새 매개 변수입니다.

Type: System.Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: 1
Accept pipeline input: False
Accept wildcard characters: False

-nodeVmSize

노드 풀에 있는 노드 또는 VM의 크기입니다. 매개 변수 -nodePoolName 를 사용하는 경우 기본값은 Standard_K8S3_v1. 새 노드 풀 환경의 일부로 새 매개 변수입니다.

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: Standard_K8S3_v1
Accept pipeline input: False
Accept wildcard characters: False

-osType

노드 풀에 있는 노드의 OS 유형입니다. 값은 Linux 또는 Windows 중 하나여야 합니다. 매개 변수 -nodePoolName 가 사용되는 경우 기본값은 Linux입니다. 새 노드 풀 환경의 일부로 새 매개 변수입니다.

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: Linux
Accept pipeline input: False
Accept wildcard characters: False

-vnet

New-AksHciClusterNetwork 명령을 사용하여 만든 AksHciNetworkSetting 개체의 이름입니다.

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-primaryNetworkPlugin

배포에 사용할 네트워크 플러그 인입니다. 이 매개 변수는 둘 중 하나 flannel 또는 calico.를 사용합니다. Calico는 Linux 및 Windows 워크로드 클러스터 모두에서 사용할 수 있습니다.

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: calico
Accept pipeline input: False
Accept wildcard characters: False

-enableADAuth

이 플래그를 사용하여 Kubernetes 클러스터에서 Active Directory를 사용하도록 설정합니다.

Type: System.Management.Automation.SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-enableMonitoring

이 플래그를 사용하여 Prometheus 모니터링을 사용하도록 설정합니다.

Type: System.Management.Automation.SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-enableAutoScaler

이 플래그를 사용하여 자동 크기 조정기 사용

Type: System.Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-autoScalerProfileName

자동 크기 조정기 구성 프로필의 이름

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

다음 단계

AksHci PowerShell 참조