New-AksHciCluster

Article
05/03/2023

Synopsis

Crée un cluster Kubernetes managé.

Syntaxe

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

Créez un Azure Kubernetes Service sur un cluster hybride AKS.

Exemples

Nouveau cluster AKS sur Azure Stack HCI et Windows Server avec un paramètre obligatoire

New-AksHciCluster -name mycluster

Remarque

N’incluez pas de traits d’union dans les noms de cluster, sinon la création du cluster risque d’échouer.

Cet exemple montre comment déployer un cluster avec un nœud de plan de contrôle, un pool de nœuds Linux appelé mycluster-linux avec un nombre de nœuds de 1 et un pool de nœuds Windows vide appelé mycluster-windows. Vous pouvez toujours mettre à l’échelle les nœuds worker avec la commande Set-AksHciCluster , ou vous pouvez mettre à l’échelle par pool de nœuds à l’aide de la commande Set-AksHciNodePool .

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

Nouveau cluster AKS-HCI avec les nouvelles valeurs par défaut du jeu de paramètres

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

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

Remarque

Si vous utilisez le nouveau jeu de paramètres comme indiqué dans l’exemple ci-dessus, les champs WindowsNodeCount et LinuxNodeCount de la sortie ne sont pas exacts et s’affichent toujours comme 0. Pour obtenir un nombre précis de nœuds Windows ou Linux, utilisez la commande Get-AksHciNodePool .

Cette commande déploie un cluster avec ses valeurs par défaut. Le cluster déployé est le même cluster que le deuxième exemple de commande.

Nouveau cluster AKS-HCI avec un pool de nœuds Linux

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

Nouveau cluster AKS-HCI avec un pool de nœuds Windows

New-AksHciCluster -name mycluster -nodePoolName nodepool1 -nodeCount 1 -nodeVmSize Standard_K8S3_v1 -osType Windows -osSku Windows2022

Nouveau cluster AKS-HCI avec un pool de nœuds Linux et des aversions

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

Nouveau cluster AKS-HCI avec un pool de nœuds Linux et le nombre maximal de pods

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

Nouveau cluster AKS-HCI avec des tailles de machine virtuelle personnalisées

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

Nouveau cluster AKS-HCI avec des nœuds de plan de contrôle à haute disponibilité

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

Nouveau cluster AKS-HCI avec la supervision activée

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

Nouveau cluster AKS-HCI avec l’authentification AD activée

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

Nouveau cluster AKS-HCI avec une version spécifique de Kubernetes

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

Nouveau cluster AKS-HCI avec autoscaler activé et profil de configuration d’autoscaler par défaut

New-AksHciCluster -name mycluster -enableAutoScaler $true

Nouveau cluster AKS-HCI avec autoscaler activé et profil de configuration d’autoscaler nommé

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

Paramètres

-name

Nom du cluster Kubernetes. N’incluez pas de traits d’union dans les noms de cluster, sinon la création du cluster risque d’échouer.

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

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

-kubernetesVersion

Spécifie la version de Kubernetes que vous souhaitez déployer. La version la plus récente est utilisée par défaut. Pour obtenir la liste des versions disponibles, exécutez 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

Nombre de nœuds dans votre plan de contrôle. 1 constitue la valeur par défaut.

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

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

-controlPlaneVmSize

Taille de la machine virtuelle du plan de contrôle. La valeur par défaut est Standard_A4_V2. Pour obtenir la liste des tailles de machines virtuelles disponibles, exécutez 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

Taille de votre machine virtuelle équilibreur de charge. La valeur par défaut est Standard_A4_V2. Pour obtenir la liste des tailles de machines virtuelles disponibles, exécutez 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

Objet de paramètre d’équilibrage de charge créé avec 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

Les aversions de nœud pour le pool de nœuds. Vous ne pouvez pas changer les aversions des nœuds après la création du pool de nœuds.

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

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

-nodeMaxPodCount

Nombre maximal de pods pouvant être déployés sur un nœud. Ce nombre doit être supérieur à 50.

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

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

-nodePoolName

Nom de votre pool de nœuds. Il s’agit d’un nouveau paramètre dans le cadre de la nouvelle expérience du pool de nœuds.

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

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

-nodeCount

Nombre de nœuds de votre pool de nœuds. Si le paramètre -nodePoolName est utilisé, la valeur par défaut est 1. Il s’agit d’un nouveau paramètre dans le cadre de la nouvelle expérience du pool de nœuds.

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

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

-nodeVmSize

La taille des nœuds ou des machines virtuelles dans votre pool de nœuds. Si le paramètre -nodePoolName est utilisé, la valeur par défaut est Standard_K8S3_v1. Il s’agit d’un nouveau paramètre dans le cadre de la nouvelle expérience du pool de nœuds.

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

Type de système d’exploitation des nœuds dans votre pool de nœuds. La valeur doit être « Linux » ou « Windows ». Si le paramètre -nodePoolName est utilisé, la valeur par défaut est « Linux ». Il s’agit d’un nouveau paramètre dans le cadre de la nouvelle expérience du pool de nœuds.

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

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

-vnet

Nom de l’objet AksHciNetworkSetting créé avec 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 réseau à utiliser pour votre déploiement. Ce paramètre utilise flannel ou calico. Calico est disponible pour les clusters de charge de travail Linux et Windows.

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

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

-enableADAuth

Active Active Active Directory dans votre 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

Active la surveillance 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

Active la mise à l’échelle automatique.

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

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

-enableAzureRBAC

Active RBAC Azure sur le cluster.

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

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

-autoScalerProfileName

Nom du profil de configuration autoscaler.

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

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

Étapes suivantes

Références AksHci PowerShell

Partager via