Início rápido: Criar clusters kubernetes em Azure Stack HCI usando o Windows PowerShellQuickstart: Create Kubernetes clusters on Azure Stack HCI using Windows PowerShell

Aplica-se a: AKS em Azure Stack HCI, tempo de execução de AKS no Windows Server 2019 datacenterApplies to: AKS on Azure Stack HCI, AKS runtime on Windows Server 2019 Datacenter

Neste guia de início rápido, você aprende a usar o Windows PowerShell para criar um cluster kubernetes em Azure Stack HCI.In this quickstart, you learn how to use Windows PowerShell to create a Kubernetes cluster on Azure Stack HCI. Em seguida, você aprende a dimensionar o cluster kubernetes e a atualizar a versão kubernetes do cluster.You then learn how to scale your Kubernetes cluster and upgrade the Kubernetes version of your cluster. Para usar o centro de administração do Windows, consulte Configurar o serviço kubernetes do Azure em Azure Stack HCI usando o centro de administração do Windows.To instead use Windows Admin Center, see Set up Azure Kubernetes Service on Azure Stack HCI using Windows Admin Center.

Antes de começarBefore you begin

Etapa 1: criar um cluster kubernetesStep 1: Create a Kubernetes cluster

Depois de instalar o host do serviço kubernetes do Azure, você estará pronto para implantar um cluster do kubernetes.After installing your Azure Kubernetes Service host, you are ready to deploy a Kubernetes cluster.

Abra o PowerShell como administrador e execute o comando a seguir.Open PowerShell as an administrator and run the following command.

New-AksHciCluster -clusterName <String>
                 [-kubernetesVersion <String>]
                 [-controlPlaneNodeCount <int>]
                 [-linuxNodeCount <int>]
                 [-windowsNodeCount <int>]
                 [-controlPlaneVmSize <VmSize>]
                 [-loadBalancerVmSize <VmSize>]
                 [-linuxNodeVmSize <VmSize>]
                 [-windowsNodeVmSize <VmSize>]

ExemploExample

New-AksHciCluster -clusterName mynewcluster -kubernetesVersion v1.18.8 -controlPlaneNodeCount 1 -linuxNodeCount 1 -windowsNodeCount 0 

Parâmetros obrigatóriosRequired parameters

-clusterName

O nome alfanumérico do cluster kubernetes.The alphanumeric name of your Kubernetes cluster.

Parâmetros opcionaisOptional parameters

-kubernetesVersion

A versão do kubernetes que você deseja implantar.The version of Kubernetes that you want to deploy. O padrão é v 1.18.8.Default is v1.18.8. Para obter uma lista de versões disponíveis, execute Get-AksHciKubernetesVersion .To get a list of available versions, run Get-AksHciKubernetesVersion.

-controlPlaneNodeCount

O número de nós no plano de controle.The number of nodes in your control plane. O padrão é UTF-1.Default is 1.

-linuxNodeCount

O número de nós do Linux em seu cluster kubernetes.The number of Linux nodes in your Kubernetes cluster. O padrão é UTF-1.Default is 1.

-windowsNodeCount

O número de nós do Windows no cluster kubernetes.The number of Windows nodes in your Kubernetes cluster. O padrão é 0.Default is 0. Você só poderá implantar nós do Windows se estiver executando o kubernetes v 1.18.8.You can only deploy Windows nodes if you are running Kubernetes v1.18.8.

-controlPlaneVmSize

O tamanho da VM do plano de controle.The size of your control plane VM. O padrão é Standard_A2_v2.Default is Standard_A2_v2. Para obter uma lista de tamanhos de VM disponíveis, execute Get-AksHciVmSize .To get a list of available VM sizes, run Get-AksHciVmSize.

-loadBalancerVmSize

O tamanho da VM do balanceador de carga.The size of your load balancer VM. O padrão é Standard_A2_V2.Default is Standard_A2_V2. Para obter uma lista de tamanhos de VM disponíveis, execute Get-AksHciVmSize .To get a list of available VM sizes, run Get-AksHciVmSize.

-linuxNodeVmSize

O tamanho da VM do seu nó Linux.The size of your Linux Node VM. O padrão é Standard_K8S3_v1.Default is Standard_K8S3_v1. Para obter uma lista de tamanhos de VM disponíveis, execute Get-AksHciVmSize .To get a list of available VM sizes, run Get-AksHciVmSize.

-windowsNodeVmSize

O tamanho da VM do nó do Windows.The size of your Windows Node VM. O padrão é Standard_K8S3_v1.Default is Standard_K8S3_v1. Para obter uma lista de tamanhos de VM disponíveis, execute Get-AksHciVmSize .To get a list of available VM sizes, run Get-AksHciVmSize.

Verifique os clusters implantadosCheck your deployed clusters

Para obter uma lista de seus clusters de host e kubernetes do serviço kubernetes do Azure implantados, execute o comando a seguir.To get a list of your deployed Azure Kubernetes Service host and Kubernetes clusters, run the following command.

Get-AksHciCluster

Etapa 2: dimensionar um cluster kubernetesStep 2: Scale a Kubernetes cluster

Se você precisar dimensionar o cluster para cima ou para baixo, poderá alterar o número de nós de plano de controle, nós de trabalho do Linux ou nós de trabalho do Windows.If you need to scale your cluster up or down, you can change the number of control plane nodes, Linux worker nodes, or Windows worker nodes.

Para dimensionar os nós do plano de controle, execute o comando a seguir.To scale control plane nodes, run the following command.

Set-AksHciClusterNodeCount –clusterName <String>
                           -controlPlaneNodeCount <int>

Para dimensionar os nós de trabalho, execute o comando a seguir.To scale the worker nodes, run the following command.

Set-AksHciClusterNodeCount –clusterName <String>
                           -linuxNodeCount <int>
                           -windowsNodeCount <int>

Os nós de plano de controle e os nós de trabalho devem ser dimensionados de forma independente.The control plane nodes and the worker nodes must be scaled independently.

ExemploExample

Set-AksHciClusterNodeCount –clusterName mynewcluster -controlPlaneNodeCount 3
Set-AksHciClusterNodeCount –clusterName mynewcluster -linuxNodeCount 2 -windowsNodeCount 2 

Etapa 3: atualizar a versão do kubernetesStep 3: Upgrade Kubernetes version

Para ver a lista de versões do kubernetes disponíveis, execute o comando a seguir.To see the list of available Kubernetes versions, run the following command.

Get-AksHciKubernetesVersion

Para atualizar para a próxima versão do kubernetes, execute o comando a seguir.To update to the next Kubernetes version, run the following command.

Update-AksHciCluster -clusterName <String>
                     [-patch]

Cada versão do kubernetes tem um lançamento principal, uma versão secundária e uma versão de patch.Every Kubernetes version has a major release, a minor version, and a patch version. Por exemplo, em v 1.18.6, 1 é o lançamento principal, 18 é a versão secundária e 6 é a versão do patch.For example, in v1.18.6, 1 is the major release, 18 is the minor version, and 6 is the patch version. Ao longo do tempo, o AKS-HCI dará suporte a uma versão principal, três versões secundárias e dois patches por versão secundária para um total de 6 versões com suporte.Over time, AKS-HCI will support one major release, three minor releases, and two patches per minor release for a total of 6 supported versions. No entanto, para esta versão de visualização, damos suporte a um total de 4 releases-v 1.16.10, v 1.16.15, v 1.17.11, v 1.18.8.However, for this preview release, we support a total of 4 releases - v1.16.10, v1.16.15, v1.17.11, v1.18.8.

Quando o parâmetro patch é adicionado durante a execução Update-AksHciCluster , o comando é atualizado para a próxima versão do patch (se houver) para a versão secundária.When the parameter patch is added while running Update-AksHciCluster, the command upgrades to the next patch version (if any) for the minor version. Quando o comando é executado sem o parâmetro patch , a experiência de atualização padrão é para a próxima versão secundária.When the command is run without the parameter patch, the default upgrade experience is to the next minor release. Para tornar isso mais fácil, a tabela a seguir contém todas as experiências de atualização possíveis:To make this easier, the following table contains all possible update experiences:

Versão atualCurrent release Versão atualizada do kubernetes sem patchKubernetes updated version without -patch Versão atualizada do kubernetes com-patchKubernetes updated version with -patch
v 1.16.10v1.16.10 v 1.17.11v1.17.11 v 1.16.15v1.16.15
v 1.16.15v1.16.15 v 1.17.11v1.17.11 atualização do complemento in locoin place add-on upgrade
v 1.17.11v1.17.11 v 1.18.8v1.18.8 atualização do complemento in locoin place add-on upgrade
v 1.18.8v1.18.8 atualização do complemento in locoin place add-on upgrade atualização do complemento in locoin place add-on upgrade

A atualização do complemento in loco atualiza todos os complementos kubernetes como o CSI que o AKS-HCI gerencia para você.In place add-on upgrade updates all the Kubernetes add-ons like CSI that AKS-HCI manages for you. Essa atualização não altera a versão do sistema operacional do nó.This upgrade does not change the OS version of the node. Ele também não altera a versão do kubernetes.It also does not change the Kubernetes version.

Exemplo – atualizar a versão do kubernetes para a próxima versão secundáriaExample - Upgrade Kubernetes version to the next minor version

Update-AksHciCluster -clusterName mynewcluster

Exemplo – atualizar a versão do kubernetes para a próxima versão do patchExample - Upgrade Kubernetes version to the next patch version

Update-AksHciCluster -clusterName mynewcluster -patch

Etapa 4: acessar seus clusters usando o kubectlStep 4: Access your clusters using kubectl

Para acessar os clusters do kubernetes usando o kubectl, execute o comando a seguir.To access your Kubernetes clusters using kubectl, run the following command. Isso usará o arquivo kubeconfig do cluster especificado como o arquivo kubeconfig padrão para kubectl.This will use the specified cluster's kubeconfig file as the default kubeconfig file for kubectl.

Get-AksHciCredential -clusterName <String>
                     [-outputLocation <String>]

ExemploExample

Get-AksHciCredential -clusterName mynewcluster

Parâmetros ExigidosRequired Parameters

clusterName

O nome do cluster.The name of the cluster.

Parâmetros OpcionaisOptional Parameters

outputLocation

A localização era que o kubeconfig foi baixado.The location were you want the kubeconfig downloaded. O padrão é %USERPROFILE%\.kube.Default is %USERPROFILE%\.kube.

Excluir um cluster kubernetesDelete a Kubernetes cluster

Se você precisar excluir um cluster kubernetes, execute o comando a seguir.If you need to delete a Kubernetes cluster, run the following command.

Remove-AksHciCluster -clusterName

ExemploExample

Remove-AksHciCluster -clusterName mynewcluster

Obter logsGet logs

Para obter logs de todos os seus pods, execute o comando a seguir.To get logs from your all your pods, run the following command. Esse comando criará uma pasta compactada de saída chamada akshcilogs no caminho C:\wssd\akshcilogs .This command will create an output zipped folder called akshcilogs in the path C:\wssd\akshcilogs.

Get-AksHciLogs

Neste guia de início rápido, você aprendeu a criar, dimensionar e atualizar a versão kubernetes de um cluster usando o PowerShell.In this quickstart, you learned how to create, scale, and upgrade the Kubernetes version of a cluster using PowerShell.

Próximas etapasNext steps