New-AksHciCluster

Sinopse

Cria um novo cluster do Kubernetes gerenciado.

Sintaxe

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]

Descrição

Crie um novo Serviço de Kubernetes do Azure em um cluster híbrido do AKS.

Exemplos

Novo AKS no Azure Stack HCI e cluster do Windows Server com o parâmetro necessário

New-AksHciCluster -name mycluster

Observação

Não inclua hifens em nomes de cluster ou a criação do cluster pode falhar.

Este exemplo implanta um cluster com um nó de painel de controle, um pool de nós do Linux chamado mycluster-linux com uma contagem de nós de 1 e um pool de nós vazio do Windows chamado mycluster-windows. Você ainda pode dimensionar os nós de trabalho com o comando Set-AksHciCluster ou dimensionar por pool de nós usando o comando Set-AksHciNodePool .

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

Novo cluster AKS-HCI com os valores padrão do novo 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

Observação

Se você estiver usando o novo conjunto de parâmetros, conforme mostrado no exemplo acima, os WindowsNodeCount campos e LinuxNodeCount na saída não serão precisos e sempre serão mostrados como 0. Para obter uma contagem precisa dos nós do Windows ou do Linux, use o comando Get-AksHciNodePool .

Esse comando implanta um cluster com seus valores padrão. O cluster implantado é o mesmo cluster que o segundo comando de exemplo.

Novo cluster AKS-HCI com um pool de nós do Linux

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

Novo cluster AKS-HCI com um pool de nós do Windows

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

Novo cluster AKS-HCI com um pool de nós do Linux e taints

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

Novo cluster AKS-HCI com um pool de nós do Linux e contagem máxima de pods

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

Novo cluster AKS-HCI com tamanhos de VM personalizados

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

Novo cluster AKS-HCI com nós de plano de controle altamente disponíveis

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

Novo cluster AKS-HCI com monitoramento habilitado

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

Novo cluster AKS-HCI com autenticação do AD habilitada

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

Novo cluster AKS-HCI com uma versão específica do Kubernetes

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

Novo cluster AKS-HCI com o dimensionador automático habilitado e o perfil de configuração do dimensionador automático padrão

New-AksHciCluster -name mycluster -enableAutoScaler $true

Novo cluster AKS-HCI com o dimensionador automático habilitado e um perfil de configuração de dimensionador automático nomeado

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

Parâmetros

-Nome

O nome do cluster do Kubernetes. Não inclua hifens em nomes de cluster ou a criação do cluster pode falhar.

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

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

-kubernetesVersion

Especifica a versão do Kubernetes que você deseja implantar. O padrão é a última versão. Para obter uma lista das versões disponíveis, execute 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

O número de nós no plano de controle. O padrão é UTF-1.

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

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

-controlPlaneVmSize

O tamanho da VM do painel de controle. O padrão é Standard_A4_V2. Para obter uma lista de tamanhos de VM disponíveis, execute 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

O tamanho da VM do balanceador de carga. O padrão é Standard_A4_V2. Para obter uma lista de tamanhos de VM disponíveis, execute 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

O objeto de configuração do balanceador de carga criado com New-AksHciLoadBalancerSetting.

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

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

-Fere

O nó mancha o pool de nós. Não é possível alterar os taints de nó após a criação do pool de nós.

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

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

-nodeMaxPodCount

O número máximo de pods implantados em um nó. Esse número deve ser maior 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

O nome do pool de nós. Esse é um novo parâmetro como parte da nova experiência de pool de nós.

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

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

-nodeCount

O número de nós no pool de nós. Se o parâmetro -nodePoolName for usado, o valor padrão será 1. Esse é um novo parâmetro como parte da nova experiência de pool de nós.

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

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

-nodeVmSize

O tamanho dos nós ou VMs no pool de nós. Se o parâmetro -nodePoolName for usado, o valor padrão será Standard_K8S3_v1. Esse é um novo parâmetro como parte da nova experiência de pool de nós.

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

O tipo de sistema operacional dos nós no pool de nós. O valor deve ser "Linux" ou "Windows". Se o parâmetro -nodePoolName for usado, o valor padrão será "Linux". Esse é um novo parâmetro como parte da nova experiência de pool de nós.

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

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

-vnet

O nome do AksHciNetworkSetting objeto criado com 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

O plug-in de rede a ser usado para sua implantação. Esse parâmetro usa ou flannelcalico. O Calico está disponível para clusters de carga de trabalho do Linux e do 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 o Active Directory no cluster do 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 o monitoramento do 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 o dimensionador 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 o RBAC do Azure no cluster.

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

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

-autoScalerProfileName

O nome do perfil de configuração do dimensionador automático.

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

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

Próximas etapas

Referência do AksHci PowerShell