New-AksHciCluster

概要

建立新的受控 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]

描述

在 AKS 混合式叢集上建立新的Azure Kubernetes Service。

範例

新「Azure Stack HCI 和 Windows Server 上的 AKS」叢集與必要參數

New-AksHciCluster -name mycluster

注意

請勿在叢集名稱中包含連字號,否則叢集建立可能會失敗。

此範例會部署具有一個控制平面節點的叢集、名為 mycluster-linux 的 Linux 節點集區,其節點計數為 1,以及名為 的 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

注意

如果您使用的是上述範例所示的新參數集,則輸出中的 WindowsNodeCountLinuxNodeCount 欄位將會不正確,而且一律會顯示為 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 節點集區和污點 (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

-taints

節點集區的節點污點 (taint)。 建立節點集區之後,您就無法變更節點污點 (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

要用於部署的網路外掛程式。 此參數會使用 flannelcalico。 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 參考