New-AksHciCluster

아티클
05/03/2023

개요

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

구문

New-AksHciCluster -name <String>
                 [-nodePoolName <String>]
                 [-nodeCount <int>]
                 [-osType {linux, windows}]
                 [-kubernetesVersion <String>]
                 [-controlPlaneNodeCount <int>]
                 [-controlPlaneVmSize <VmSize>]
                 [-loadBalancerVmSize <VmSize>]
                 [-loadBalancerSettings <loadBalancer>]
                 [-nodeVmSize <VmSize>]
                 [-taints <Taint>]
                 [-nodeMaxPodCount <int>]
                 [-vnet <Virtual Network>]
                 [-primaryNetworkPlugin <Network Plugin>]   
                 [-enableAdAuth]
                 [-enableMonitoring]
                 [-enableAutoScaler] 
                 [-enableAzureRBAC] 
                 [-autoScalerProfileName]

Description

AKS 하이브리드 클러스터에 새 Azure Kubernetes Service 만듭니다.

예제

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

New-AksHciCluster -name mycluster

참고

클러스터 이름에 하이픈을 포함하지 않거나 클러스터 만들기가 실패할 수 있습니다.

다음은 컨트롤 플레인 노드 하나, 노드 수가 1인 Linux mycluster-linux 노드 풀, 라는 빈 Windows 노드 풀이 있는 클러스터를 배포하는 예제입니다 mycluster-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 -osSku Windows2022

Linux 노드 풀 및 taints가 있는 새 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

매개 변수

-이름

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

-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

배포에 사용할 네트워크 플러그 인입니다. 이 매개 변수는 또는 calico를 flannel 사용합니다. 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

-enableAzureRBAC

클러스터에서 Azure RBAC를 사용하도록 설정합니다.

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 참조