New-AksHciCluster

Riepilogo

Creare un nuovo cluster Kubernetes gestito.

Sintassi

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]

Nota

Il parametro impostato sopra verrà deprecato in una versione futura. Questo set sarà comunque supportato e sarà il comportamento predefinito durante l'esecuzione New-AksHciCluster con il parametro, ovvero l'unico -name parametro obbligatorio. Il servizio Azure Kubernetes in Azure Stack HCI e Windows Server introduce i pool di nodi all'esperienza di distribuzione del cluster e supporta ora il set di parametri seguente. Per altre informazioni sulla nuova esperienza del pool di nodi, vedere Creare e gestire più pool di nodi per un cluster.

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]
Parametri da deprecare Parametri introdotti
linuxNodeCount nodePoolName
windowsNodeCount nodeCount
linuxNodeVmSize nodeVmSize
windowsNodeVmSize osType

Descrizione

Creare una nuova servizio Azure Kubernetes nel cluster azure Stack HCI o Windows Server.

Esempio

Nuovo servizio Azure Kubernetes in Azure Stack HCI e cluster server di Windows con il parametro richiesto

New-AksHciCluster -name mycluster

Nota

Non includere trattini nei nomi del cluster o la creazione del cluster potrebbe non riuscire.

L'esempio precedente distribuisce un cluster con un nodo del piano di controllo, un pool di nodi Linux denominato mycluster-linux con un numero di nodi uno e un pool di nodi Windows vuoto denominato mycluster-windows. È comunque possibile ridimensionare i nodi di lavoro con il comando Set-AksHciCluster oppure è possibile ridimensionare in base al pool di nodi usando il comando Set-AksHciNodePool .

Output

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

Nuovo cluster AKS-HCI con i valori predefiniti del nuovo set di parametri

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

Output

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

Nota

Se si usa il nuovo set di parametri, come illustrato nell'esempio precedente, i WindowsNodeCount campi e LinuxNodeCount nell'output non saranno accurati e sempre visualizzati come 0. Per ottenere un numero di accessi dei nodi Windows o Linux, usare il comando Get-AksHciNodePool.

Il comando precedente distribuisce un cluster con i relativi valori predefiniti. Il cluster distribuito è lo stesso cluster del secondo comando di esempio distribuito.

Nuovo cluster AKS-HCI con un pool di nodi Linux

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

Nuovo cluster AKS-HCI con un pool di nodi Windows

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

Nuovo cluster AKS-HCI con un pool di nodi Linux e taints

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

Nuovo cluster AKS-HCI con un pool di nodi Linux e numero massimo di pod

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

Nuovo cluster AKS-HCI con dimensioni di vm personalizzate

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

Nuovo cluster AKS-HCI con nodi del piano di controllo a disponibilità elevata

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

Nuovo cluster AKS-HCI con monitoraggio abilitato

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

Nuovo cluster del servizio Azure Kubernetes-HCI abilitato con l'autenticazione di Active Directory

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

Nuovo cluster AKS-HCI con una versione specifica di Kubernetes

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

Nuovo cluster AKS-HCI con scalabilità automatica abilitata e profilo di configurazione predefinito per scalabilità automatica

New-AksHciCluster -name mycluster -enableAutoScaler $true

Nuovo cluster AKS-HCI con scalabilità automatica abilitata e un profilo di configurazione di scalabilità automatica denominato

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

Parametri

-name

Nome del cluster Kubernetes. Non includere trattini nei nomi del cluster o la creazione del cluster potrebbe non riuscire.

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

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

-kubernetesVersion

Versione di Kubernetes da distribuire. Il valore predefinito è la versione più recente. Per ottenere un elenco delle versioni disponibili, eseguire 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

Numero di nodi nel piano di controllo. Il valore predefinito è uno.

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

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

-controlPlaneVmSize

Dimensioni della macchina virtuale del piano di controllo. Il valore predefinito è Standard_A4_V2. Per ottenere un elenco delle dimensioni delle macchine virtuali disponibili, eseguire 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

Dimensioni della macchina virtuale del servizio di bilanciamento del carico. Il valore predefinito è Standard_A4_V2. Per ottenere un elenco delle dimensioni delle macchine virtuali disponibili, eseguire 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

Oggetto di impostazione del servizio di bilanciamento del carico creato con 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

Numero di nodi Linux nel cluster Kubernetes. Il valore predefinito è uno. Questo parametro verrà deprecato in una versione futura.

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

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

-windowsNodeCount

Numero di nodi Windows nel cluster Kubernetes. Il valore predefinito è 0. Questo parametro verrà deprecato in una versione futura.

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

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

-linuxNodeVmSize

Dimensioni della macchina virtuale nodo Linux. Il valore predefinito è Standard_K8S3_v1. Per ottenere un elenco delle dimensioni delle macchine virtuali disponibili, eseguire Get-AksHciVmSize. Questo parametro verrà deprecato in una versione futura.

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

Dimensioni della macchina virtuale nodo Windows. Il valore predefinito è Standard_K8S3_v1. Per ottenere un elenco delle dimensioni delle macchine virtuali disponibili, eseguire Get-AksHciVmSize. Questo parametro verrà deprecato in una versione futura.

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

Il nodo viene taints per il pool di nodi. Non è possibile modificare i nodi taints dopo la creazione del pool di nodi.

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

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

-nodeMaxPodCount

Numero massimo di pod distribuibili in un nodo. Questo numero deve essere maggiore di 50.

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

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

-nodePoolName

Nome del pool di nodi. Si tratta di un nuovo parametro come parte della nuova esperienza del pool di nodi.

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

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

-nodeCount

Numero di nodi nel pool di nodi. Se viene usato il parametro -nodePoolName , il valore predefinito è 1. Si tratta di un nuovo parametro come parte della nuova esperienza del pool di nodi.

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

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

-nodeVmSize

Dimensioni dei nodi o delle macchine virtuali nel pool di nodi. Se viene usato il parametro -nodePoolName , il valore predefinito è Standard_K8S3_v1. Si tratta di un nuovo parametro nell'ambito della nuova esperienza del pool di nodi.

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

Tipo di sistema operativo dei nodi nel pool di nodi. Il valore deve essere Linux o Windows. Se il parametro -nodePoolName viene usato, il valore predefinito è Linux. Si tratta di un nuovo parametro nell'ambito della nuova esperienza del pool di nodi.

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

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

-vnet

Nome dell'oggetto AksHciNetworkSetting creato con il comando New-AksHciClusterNetwork .

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

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

-primaryNetworkPlugin

Plug-in di rete da usare per la distribuzione. Questo parametro usa flannel o calico. Calico è disponibile sia per Linux che per i cluster di carico di lavoro Windows.

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

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

-enableADAuth

Usare questo flag per abilitare Active Directory nel cluster Kubernetes.

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

Usare questo flag per abilitare il monitoraggio di 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

Usare questo flag per abilitare il ridimensionamento automatico

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

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

-autoScalerProfileName

Nome del profilo di configurazione dell'utilità di scalabilità automatica

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

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

Passaggi successivi

Informazioni di riferimento su PowerShell per AksHci