New-AksHciCluster

Sinopse

Crie um novo cluster do Kubernetes gerenciado.

Sintaxe

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]

Observação

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

Descrição

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

Exemplos

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

New-AksHciCluster -name mycluster

Observação

Não inclua hífens em nomes de cluster ou a criação do cluster pode 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 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 LinuxNodeCount a WindowsNodeCount saída não serão precisos e sempre serão mostrados como 0. Para obter uma contagem de accurage de seus 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

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

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

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

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 de dimensionamento 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 dimensionamento automático nomeado

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

Parâmetros

-name

O nome do cluster do Kubernetes. Não inclua hífens 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

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

-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 nós Windows 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 do nó Windows. 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

O nó mancha o pool de nós. Você não pode 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 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

-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 do 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 do 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 do 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 Calico está disponível para clusters de carga de trabalho linux e Windows.

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

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

-enableAutoScaler

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

-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