New-AksHciCluster

Sinopsis

Crea un nuevo clúster de Kubernetes administrado.

Sintaxis

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]

Descripción

Cree una nueva Azure Kubernetes Service en un clúster híbrido de AKS.

Ejemplos

Nuevo clúster de AKS en Azure Stack HCI y Windows Server con el parámetro requerido

New-AksHciCluster -name mycluster

Nota:

No incluya guiones en los nombres de clúster o puede producirse un error en la creación del clúster.

En este ejemplo se implementa un clúster con un nodo de plano de control, un grupo de nodos de Linux denominado mycluster-linux con un número de nodos de 1 y un grupo de nodos de Windows vacío denominado mycluster-windows. Todavía puede escalar los nodos de trabajo con el comando Set-AksHciCluster , o bien puede escalar por grupo de nodos mediante el comando Set-AksHciNodePool .

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

Nuevo clúster de AKS-HCI con los valores predeterminados del nuevo conjunto de parámetros

PS C:\ New-AksHciCluster -name mycluster -nodePoolName nodepool1
ProvisioningState     : provisioned
KubernetesVersion     : v1.20.7
NodePools             : nodepool1
WindowsNodeCount      : 0
LinuxNodeCount        : 0
ControlPlaneNodeCount : 1
Name                  : mycluster

Nota:

Si usa el nuevo conjunto de parámetros como se muestra en el ejemplo anterior, los campos WindowsNodeCount y LinuxNodeCount de la salida no serán precisos y siempre se mostrarán como 0. Para obtener un recuento preciso de los nodos de Windows o Linux, use el comando Get-AksHciNodePool .

Este comando implementa un clúster con sus valores predeterminados. El clúster implementado es el mismo clúster que el segundo comando de ejemplo.

Nuevo clúster de AKS-HCI con un grupo de nodos de Linux

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

Nuevo clúster de AKS-HCI con un grupo de nodos de Windows

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

Nuevo clúster de AKS-HCI con un grupo de nodos de Linux e intolerancias

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

Nuevo clúster de AKS-HCI con un grupo de nodos de Linux y número máximo de pods

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

Nuevo clúster de AKS-HCI con tamaños de máquina virtual personalizados

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

Nuevo clúster de AKS-HCI con nodos de plano de control de alta disponibilidad

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

Nuevo clúster de AKS-HCI con supervisión habilitada

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

Nuevo clúster de AKS-HCI con autenticación de AD habilitada

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

Nuevo clúster de AKS-HCI con una versión específica de Kubernetes

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

Nuevo clúster de AKS-HCI con el escalador automático habilitado y el perfil de configuración del escalador automático predeterminado

New-AksHciCluster -name mycluster -enableAutoScaler $true

Nuevo clúster de AKS-HCI con el escalador automático habilitado y un perfil de configuración del escalador automático con nombre

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

Parámetros

-name

Nombre del clúster de Kubernetes. No incluya guiones en los nombres de clúster o puede producirse un error en la creación del clúster.

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

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

-kubernetesVersion

Especifica la versión de Kubernetes que quiere implementar. El valor predeterminado es la versión más reciente. Para obtener una lista de versiones disponibles, ejecute 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

Número de nodos del plano de control. El valor predeterminado es 1.

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

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

-controlPlaneVmSize

Tamaño de la VM del plano de control. El valor predeterminado es Standard_A4_V2. Para obtener una lista de tamaños de máquina virtual disponibles, ejecute 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

Tamaño de la VM del equilibrador de carga. El valor predeterminado es Standard_A4_V2. Para obtener una lista de tamaños de máquina virtual disponibles, ejecute 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

Objeto de configuración del equilibrador de carga que se crea 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

-taints

Las intolerancias de nodo del grupo de nodos. No se pueden cambiar las intolerancias del nodo una vez creado el grupo de nodos.

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

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

-nodeMaxPodCount

Número máximo de pods que se pueden implementar en un nodo. Este número debe ser mayor que 50.

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

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

-nodePoolName

Nombre del grupo de nodos. Se trata de un nuevo parámetro que forma parte de la nueva experiencia con los grupos de nodos.

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

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

-nodeCount

Número de nodos del grupo de nodos. Si se usa el parámetro -nodePoolName, el valor predeterminado es 1. Se trata de un nuevo parámetro que forma parte de la nueva experiencia con los grupos de nodos.

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

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

-nodeVmSize

Tamaño de los nodos o máquinas virtuales del grupo de nodos. Si se usa el parámetro -nodePoolName, el valor predeterminado es Standard_K8S3_v1. Se trata de un nuevo parámetro que forma parte de la nueva experiencia con los grupos de nodos.

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 de sistema operativo de los nodos del grupo de nodos. El valor debe ser "Linux" o "Windows". Si se usa el parámetro -nodePoolName , el valor predeterminado es "Linux". Se trata de un nuevo parámetro que forma parte de la nueva experiencia con los grupos de nodos.

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

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

-vnet

Nombre del AksHciNetworkSetting objeto creado con 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

Complemento de red que se va a usar para la implementación. Este parámetro usa flannel o calico. Calico está disponible para clústeres de carga de trabajo tanto de Linux como de Windows.

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

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

-enableADAuth

Habilita Active Directory en el clúster de 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

Habilita la supervisión de 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

Habilita el escalador automático.

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

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

-enableAzureRBAC

Habilita RBAC de Azure en el clúster.

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

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

-autoScalerProfileName

Nombre del perfil de configuración del escalador automático.

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

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

Pasos siguientes

Referencia de AksHci para PowerShell