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を作成します。

必要なパラメーターを指定した新しい AKS on Azure Stack HCI and Windows Server クラスター

New-AksHciCluster -name mycluster

Note

クラスター名にハイフンを含めないでください。クラスターの作成に失敗する可能性があります。

この例では、1 つのコントロール プレーン ノード、ノード数が 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

Note

上の例に示すように、新しいパラメーター セットを使用している場合、WindowsNodeCountLinuxNodeCount フィールドの出力は正確ではなく、常に 0 と表示されます。 Windows または Linux ノードの正確な数を取得するには、 Get-AksHciNodePool コマンドを使用します。

このコマンドは、既定値を使用してクラスターをデプロイします。 デプロイされたクラスターは、2 番目のコマンド例と同じクラスターです。

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 ノード プールとテイントを含む新しい AKS-HCI クラスター

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

Linux ノード プールと最大ポッド数を含む新しい 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

ノード プールのノード テイント。 ノード プールを作成した後は、ノード テイントを変更することができません。

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

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

-nodeMaxPodCount

ノードに展開できるポッドの最大数。 この数値は 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

-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 リファレンス