New-AksHciCluster

Sinopse

Crie um novo cluster do Kubernetes gerenciado.

Syntax

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]

Observação

O parâmetro definido acima será preterido em uma versão futura. Esse conjunto ainda terá suporte e será o comportamento padrão ao executar com o parâmetro New-AksHciCluster , que é o único parâmetro -name necessário. O AKS no Azure Stack HCI está introduzindo pools de nós à sua experiência de implantação de cluster e agora está dando suporte ao conjunto de parâmetros a seguir. Para obter mais informações sobre a nova experiência de pool de nós, consulte Criar e gerenciar vários pools de nós para um 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]
Parâmetros a serem preterido Parâmetros introduzidos
linuxNodeCount nodePoolName
windowsNodeCount nodeCount
linuxNodeVmSize nodeVmSize
windowsNodeVmSize osType

Description

Crie um novo Serviço de Kubernetes do Azure no Azure Stack HCI cluster.

Exemplos

Novo AKS no Azure Stack HCI cluster com o parâmetro necessário

PS C:\> New-AksHciCluster -name mycluster

Observação

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

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

Saída

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

Saída

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 campos e na saída não serão precisos e WindowsNodeCountLinuxNodeCount sempre aparecerão como 0 . Para obter uma contagem de accurage dos nós Windows ou Linux, use o comando Get-AksHciNodePool.

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

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

PS C:\ New-AksHciCluster -name mycluster -nodePoolName nodepool1 -nodeCount 1 -nodeVmSize Standard_K8S3_v1 -osType linux

Novo cluster AKS-HCI com um pool Windows nó

PS C:\ New-AksHciCluster -name mycluster -nodePoolName nodepool1 -nodeCount 1 -nodeVmSize Standard_K8S3_v1 -osType windows

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

PS C:\ 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

PS C:\ New-AksHciCluster -name mycluster -nodePoolName nodepool1 -nodeCount 1 -osType linux -nodeMaxPodCount 100

Novo cluster AKS-HCI com tamanhos de VM personalizados

PS C:\ 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

PS C:\ New-AksHciCluster -name mycluster -controlPlaneNodeCount 3 -nodePoolName nodepool1 -nodeCount 3

Novo cluster AKS-HCI com monitoramento habilitado

PS C:\ New-AksHciCluster -name mycluster -nodePoolName nodepool1 -nodeCount 3 -enableMonitoring

Novo cluster AKS-HCI com auth do AD habilitada

PS C:\ New-AksHciCluster -name mycluster -nodePoolName nodepool1 -nodeCount 3 -enableAdAuth

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

PS C:\ New-AksHciCluster -name mycluster -nodePoolName nodepool1 -nodeCount 3 -kubernetesVersion v1.21.2

Parâmetros

-name

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

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

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

-kubernetesVersion

A versão do Kubernetes que você deseja implantar. O padrão é a última versão. Para obter uma lista de 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 em seu plano de controle. O padrão é um.

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 plano 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

-linuxNodeCount

O número de nós do Linux no cluster do Kubernetes. O padrão é um. Esse parâmetro será preterido em uma versão futura.

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

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

-windowsNodeCount

O número de Windows nós no cluster do Kubernetes. O padrão é 0. Esse parâmetro será preterido em uma versão futura.

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

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

-linuxNodeVmSize

O tamanho da VM do Nó do Linux. O padrão é Standard_K8S3_v1. Para obter uma lista de tamanhos de VM disponíveis, execute Get-AksHciVmSize . Esse parâmetro será preterido em uma versão 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

O tamanho da VM Windows Node. O padrão é Standard_K8S3_v1. Para obter uma lista de tamanhos de VM disponíveis, execute Get-AksHciVmSize . Esse parâmetro será preterido em uma versão 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

Os taints de nó para o pool de nós. Não é possível alterar os taints de nó depois que o pool de nós é criado.

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 precisa 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á -nodePoolName 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 objeto AksHciNetworkSetting criado com o 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

O plug-in de rede a ser usado para sua implantação. Esse parâmetro usa ou flannelcalico . O Californiaco está disponível para clusters de carga de trabalho linux e Windows dados.

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

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

-enableADAuth

Use esse sinalizador para habilitar o Active Directory em seu 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

Use esse sinalizador para habilitar 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

Próximas etapas

Referência do AksHci PowerShell