Configurar um host do Serviço Kubernetes do Azure no Windows Server e implantar um cluster de carga de trabalho usando o PowerShell

Aplica-se a: Windows Server Datacenter

Este guia de início rápido orienta você na configuração de um host do Serviço Kubernetes do Azure (AKS). Você cria clusters Kubernetes no Windows Server usando o PowerShell. Para usar o Windows Admin Center, consulte Configurar com o Windows Admin Center.

Antes de começar

• Certifique-se de satisfazer todos os pré-requisitos nos requisitos do sistema.
• Use uma conta do Azure para registrar seu host AKS para cobrança. Para obter mais informações, consulte Requisitos do Azure.

Instalar o módulo AksHci PowerShell

Siga estas etapas em todos os nós do cluster do Windows Server:

1. Feche todas as janelas abertas do PowerShell, abra uma nova sessão do PowerShell como administrador e execute o seguinte comando em todos os nós do cluster do Windows Server:

   Install-PackageProvider -Name NuGet -Force 
   Install-Module -Name PowershellGet -Force -Confirm:$false
   

   Você deve fechar todas as janelas existentes do PowerShell novamente para garantir que os módulos carregados sejam atualizados. Não continue para a próxima etapa até fechar todas as janelas abertas do PowerShell.

2. Instale o módulo AksHci PowerShell executando o seguinte comando em todos os nós do cluster do Windows Server:

   Install-Module -Name AksHci -Repository PSGallery -Force -AcceptLicense
   

   Você deve fechar todas as janelas existentes do PowerShell novamente para garantir que os módulos carregados sejam atualizados. Não continue para a próxima etapa até fechar todas as janelas abertas do PowerShell.

Você pode usar um script auxiliar para excluir módulos antigos do AKS-HCI PowerShell, para evitar quaisquer problemas relacionados à versão do PowerShell em sua implantação do AKS.

Valide a instalação

Get-Command -Module AksHci

Para obter a lista completa de comandos do AksHci PowerShell, consulte AksHci PowerShell.

Registar o fornecedor de recursos na sua subscrição

Antes do processo de registro, habilite o provedor de recursos apropriado no Azure para o registro AKS. Para fazer isso, execute os seguintes comandos do PowerShell:

Para entrar no Azure, execute o comando Connect-AzAccount PowerShell:

Connect-AzAccount

Se você quiser alternar para uma assinatura diferente, execute o comando Set-AzContext PowerShell:

Set-AzContext -Subscription "xxxx-xxxx-xxxx-xxxx"

Execute os comandos a seguir para registrar sua assinatura do Azure nos provedores de recursos do Kubernetes habilitados para Azure Arc. Este processo de registo pode demorar até 10 minutos, mas só precisa de ser realizado uma vez numa subscrição específica:

Register-AzResourceProvider -ProviderNamespace Microsoft.Kubernetes
Register-AzResourceProvider -ProviderNamespace Microsoft.KubernetesConfiguration
Register-AzResourceProvider -ProviderNamespace Microsoft.ExtendedLocation

Para validar o processo de registro, execute os seguintes comandos do PowerShell:

Get-AzResourceProvider -ProviderNamespace Microsoft.Kubernetes
Get-AzResourceProvider -ProviderNamespace Microsoft.KubernetesConfiguration
Get-AzResourceProvider -ProviderNamespace Microsoft.ExtendedLocation

Etapa 1: preparar sua(s) máquina(s) para implantação

Execute verificações em cada nó físico para ver se todos os requisitos para instalar o AKS estão satisfeitos. Abra o PowerShell como administrador e execute o seguinte comando Initialize-AksHciNode em todos os nós do cluster do Windows Server:

Initialize-AksHciNode

Etapa 2: criar uma rede virtual

Execute os seguintes comandos em qualquer nó do cluster do Windows Server.

Para obter os nomes das opções disponíveis, execute o seguinte comando. Certifique-se de que o comutador SwitchType VM é Externo:

Get-VMSwitch

Saída de exemplo:

Name        SwitchType     NetAdapterInterfaceDescription
----        ----------     ------------------------------
extSwitch   External       Mellanox ConnectX-3 Pro Ethernet Adapter

Para criar uma rede virtual para os nós em sua implantação usarem, crie uma variável de ambiente com o comando New-AksHciNetworkSetting PowerShell. Essa rede virtual é usada posteriormente para configurar uma implantação que usa IP estático. Se você quiser configurar sua implantação do AKS com DHCP, consulte New-AksHciNetworkSetting para obter exemplos. Você também pode revisar alguns conceitos de nós de rede.

# static IP
$vnet = New-AksHciNetworkSetting -name myvnet -vSwitchName "extSwitch" -k8sNodeIpPoolStart "172.16.10.1" -k8sNodeIpPoolEnd "172.16.10.255" -vipPoolStart "172.16.255.0" -vipPoolEnd "172.16.255.254" -ipAddressPrefix "172.16.0.0/16" -gateway "172.16.0.1" -dnsServers "172.16.0.1" -vlanId 9

Etapa 3: configurar sua implantação

Execute os seguintes comandos em qualquer nó do cluster do Windows Server.

Para criar as definições de configuração para o host AKS, use o comando Set-AksHciConfig . Você deve especificar os imageDirparâmetros , workingDire cloudConfigLocation . Se você quiser redefinir os detalhes da configuração, execute o comando novamente com novos parâmetros.

Configure sua implantação com o seguinte comando:

$csvPath = 'C:\clusterstorage\volume01' # Specify your preferred CSV path
Set-AksHciConfig -imageDir $csvPath\Images -workingDir $csvPath\ImageStore -cloudConfigLocation $csvPath\Config -vnet $vnet

Etapa 4: entrar no Azure e definir as configurações de registro

Opção 1: utilize a sua conta Microsoft Entra se tiver permissões de "Proprietário"

Execute o seguinte comando Set-AksHciRegistration PowerShell com seu nome de assinatura e grupo de recursos para entrar no Azure. Você deve ter uma assinatura do Azure e um grupo de recursos do Azure existente nas regiões do Azure Leste da Austrália, Leste dos EUA, Sudeste Asiático ou Europa Ocidental:

Set-AksHciRegistration -subscriptionId "<subscriptionId>" -resourceGroupName "<resourceGroupName>"

Opção 2: usar uma entidade de serviço do Azure

Se não tiver acesso a uma subscrição na qual seja Proprietário, pode registar o seu host AKS no Azure para faturamento utilizando um principal de serviço. Para obter mais informações sobre como usar uma entidade de serviço, consulte registrar o AKS no Windows Server usando uma entidade de serviço.

Etapa 5: iniciar uma nova implantação

Execute o seguinte comando em qualquer nó do cluster do Windows Server.

Depois de configurar sua implantação, você deve iniciá-la para instalar os agentes e serviços AKS e o host AKS. Para iniciar a implantação, execute o seguinte comando:

Install-AksHci

Etapa 6: criar um cluster do Kubernetes

Depois de instalar seu host AKS, você pode implantar um cluster Kubernetes. Abra o PowerShell como administrador e execute o seguinte comando New-AksHciCluster . Este comando de exemplo cria um novo cluster Kubernetes com um pool de nós Linux nomeado linuxnodepool com uma contagem de nós de 1.

Para obter mais informações sobre pools de nós, consulte Usar pools de nós no AKS.

New-AksHciCluster -name mycluster -nodePoolName linuxnodepool -nodeCount 1 -osType Linux

Verifique os clusters implantados

Para obter uma lista de seus clusters Kubernetes implantados, execute o seguinte comando Get-AksHciCluster PowerShell:

Get-AksHciCluster

ProvisioningState     : provisioned
KubernetesVersion     : v1.20.7
NodePools             : linuxnodepool
WindowsNodeCount      : 0
LinuxNodeCount        : 0
ControlPlaneNodeCount : 1
Name                  : mycluster

Para obter uma lista dos pools de nós no cluster, execute o seguinte comando Get-AksHciNodePool PowerShell:

Get-AksHciNodePool -clusterName mycluster

ClusterName  : mycluster
NodePoolName : linuxnodepool
Version      : v1.20.7
OsType       : Linux
NodeCount    : 1
VmSize       : Standard_K8S3_v1
Phase        : Deployed

Etapa 7: conectar o seu cluster ao Kubernetes com Arc habilitado

Conecte o cluster ao Kubernetes habilitado para Arc executando o comando Enable-AksHciArcConnection. O exemplo a seguir conecta seu cluster Kubernetes ao Arc usando os detalhes da assinatura e do grupo de recursos que você passou no Set-AksHciRegistration comando:

Connect-AzAccount
Enable-AksHciArcConnection -name mycluster

Dimensionar um cluster do Kubernetes

Se precisar dimensionar o cluster para cima ou para baixo, você pode alterar o número de nós do plano de controle usando o comando Set-AksHciCluster . Para alterar o número de nós de trabalho do Linux ou do Windows no pool de nós, use o comando Set-AksHciNodePool .

Para dimensionar nós de plano de controle, execute o seguinte comando:

Set-AksHciCluster -name mycluster -controlPlaneNodeCount 3

Para dimensionar os nós de trabalho no pool de nós, execute o seguinte comando:

Set-AksHciNodePool -clusterName mycluster -name linuxnodepool -count 3

Para dimensionar nós de trabalho em um pool de nós, use o comando Set-AksHciNodePool .

Acesse seus clusters usando kubectl

Para acessar seus clusters Kubernetes usando kubectl, execute o comando Get-AksHciCredential PowerShell. Este comando usa o arquivo kubeconfig do cluster especificado como o arquivo kubeconfig padrão para kubectl. Você também pode usar kubectl para implantar aplicativos usando Helm:

Get-AksHciCredential -name mycluster

Excluir um cluster do Kubernetes

Para excluir um cluster Kubernetes, execute o seguinte comando:

Remove-AksHciCluster -name mycluster

Obter registos

Para obter logs de todos os seus pods, basta executar o comando Get-AksHciLogs. Este comando cria uma pasta compactada de saída chamada akshcilogs.zip em seu diretório de trabalho. O caminho completo para a akshcilogs.zip pasta é a saída depois de executar o seguinte comando:

Get-AksHciLogs

Neste início rápido, você aprendeu como configurar um host AKS e criar clusters Kubernetes usando o PowerShell. Você também aprendeu como usar o PowerShell para dimensionar um cluster Kubernetes e acessar clusters com kubectl.

Próximos passos

• Preparar uma candidatura
• Implantar um aplicativo do Windows em seu cluster Kubernetes
• Configurar vários administradores