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