Configurar um host Serviço de Kubernetes do Azure no Azure Stack HCI e no Windows Server e implantar um cluster de carga de trabalho usando o PowerShell
Aplica-se a: Azure Stack HCI ou Windows Server Datacenter
Este guia de início rápido orienta você pela configuração de um host Serviço de Kubernetes do Azure (AKS). Você cria clusters do Kubernetes no Azure Stack HCI e no Windows Server usando o PowerShell. Para usar Windows Admin Center em vez disso, consulte Configurar com Windows Admin Center.
Observação
- Se você tiver objetos de serviço de cluster pré-preparados e registros DNS, consulte Implantar um host AKS com objetos de serviço de cluster pré-configurados e registros DNS usando o PowerShell.
- Se você tiver um servidor proxy, confira Configurar um host do AKS e implantar um cluster de carga de trabalho usando o PowerShell e um servidor proxy.
- Não há suporte para a instalação do AKS no Azure Stack HCI após a configuração de VMs do Arc. Para obter mais informações, consulte problemas conhecidos com VMs do Arc. Se você quiser instalar o AKS no Azure Stack HCI, desinstale o Arc Resource Bridge e instale o AKS no Azure Stack HCI. Você pode implantar uma nova Ponte de Recursos do Arc novamente depois de limpo e instalar o AKS, mas ela não se lembrará das entidades de VM criadas anteriormente.
Antes de começar
- Verifique se você atendeu a todos os pré-requisitos nos requisitos do sistema.
- Use uma conta do Azure para registrar o host do AKS para cobrança. Para obter mais informações, consulte Requisitos do Azure.
Instalar o módulo do AksHci PowerShell
Siga estas etapas em todos os nós no cluster do Azure Stack HCI ou no cluster do Windows Server:
Observação
Se você estiver usando o PowerShell remoto, deverá usar o CredSSP.
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 no cluster do Azure Stack HCI ou do Windows Server:
Install-PackageProvider -Name NuGet -Force Install-Module -Name PowershellGet -Force -Confirm:$falseVocê deve fechar todas as janelas existentes do PowerShell novamente para garantir que os módulos carregados sejam atualizados. Não prossiga para a próxima etapa até fechar todas as janelas abertas do PowerShell.
Instale o módulo do PowerShell do AKS-HCI executando o seguinte comando em todos os nós no cluster do Azure Stack HCI ou do Windows Server:
Install-Module -Name AksHci -Repository PSGallery -Force -AcceptLicenseVocê deve fechar todas as janelas existentes do PowerShell novamente para garantir que os módulos carregados sejam atualizados. Não prossiga 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 PowerShell do AKS-HCI para evitar problemas relacionados à versão do PowerShell em sua implantação do AKS.
Validar a instalação
Get-Command -Module AksHci
Para exibir a lista completa de comandos do AksHci PowerShell, consulte AksHci PowerShell.
Registrar o provedor de recursos em sua assinatura
Antes do processo de registro, habilite o provedor de recursos apropriado no Azure para AKS habilitado pelo registro do Arc. Para fazer isso, execute os seguintes comandos do PowerShell:
Para entrar no Azure, execute o comando Connect-AzAccount do PowerShell:
Connect-AzAccount
Se você quiser alternar para uma assinatura diferente, execute o comando Set-AzContext do PowerShell:
Set-AzContext -Subscription "xxxx-xxxx-xxxx-xxxx"
Execute os comandos a seguir para registrar sua assinatura do Azure em provedores de recursos do Kubernetes habilitados para Azure Arc. Esse processo de registro pode levar até 10 minutos, mas só precisa ser executado uma vez em uma assinatura 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 seus computadores para implantação
Execute verificações em cada nó físico para ver se todos os requisitos para instalar o AKS habilitado pelo Arc estão satisfeitos. Abra o PowerShell como administrador e execute o seguinte comando Initialize-AksHciNode em todos os nós no cluster do Azure Stack HCI e do Windows Server:
Initialize-AksHciNode
Etapa 2: Criar uma rede virtual
Execute os comandos a seguir em qualquer nó no cluster do Azure Stack HCI e do Windows Server.
Para obter os nomes das opções disponíveis, execute o comando a seguir. Verifique se o SwitchType do comutador de 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 Do PowerShell New-AksHciNetworkSetting . 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 examinar alguns conceitos de nó 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
Observação
Você deve personalizar os valores mostrados neste comando de exemplo para seu ambiente.
Etapa 3: Configurar sua implantação
Execute os comandos a seguir em qualquer nó no cluster do Azure Stack HCI e do Windows Server.
Para criar as definições de configuração para o host do AKS, use o comando Set-AksHciConfig . Você deve especificar os imageDirparâmetros , workingDire cloudConfigLocation . Se você quiser redefinir os detalhes de 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
Observação
Você deve personalizar os valores mostrados neste comando de exemplo para seu ambiente.
Etapa 4: Entrar no Azure e definir as configurações de registro
Opção 1: usar sua conta Microsoft Entra se você tiver permissões de "Proprietário"
Execute o comando do PowerShell Set-AksHciRegistration a seguir com sua assinatura e o nome do 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 Leste da Austrália, Leste dos EUA, Sudeste Asiático ou Oeste da Europa do Azure:
Set-AksHciRegistration -subscriptionId "<subscriptionId>" -resourceGroupName "<resourceGroupName>"
Opção 2: usar uma entidade de serviço do Azure
Se você não tiver acesso a uma assinatura na qual é um "Proprietário", poderá registrar o host do AKS no Azure para cobrança usando uma entidade de serviço. Para obter mais informações sobre como usar uma entidade de serviço, confira Registrar o AKS no Azure Stack HCI e no Windows Server usando uma entidade de serviço.
Etapa 5: Iniciar uma nova implantação
Execute o comando a seguir em qualquer nó no cluster do Azure Stack HCI ou do Windows Server.
Depois de configurar sua implantação, você deve iniciá-la para instalar os agentes/serviços do AKS e o host do AKS. Para iniciar a implantação, execute o seguinte comando:
Dica
Para ver detalhes de status adicionais durante a instalação, defina $VerbosePreference = "Continue" antes de continuar.
Install-AksHci
Aviso
Durante a instalação do host do AKS, um tipo de recurso Kubernetes – Azure Arc é criado no grupo de recursos definido durante o registro. Não exclua esse recurso, pois ele representa o host do AKS. Você pode identificar o recurso verificando seu campo de distribuição quanto a um valor de aks_management. Se você excluir esse recurso, ele resultará em uma implantação fora da política.
Etapa 6: Criar um cluster do Kubernetes
Depois de instalar o host do AKS, você pode implantar um cluster do Kubernetes. Abra o PowerShell como administrador e execute o comando New-AksHciCluster a seguir. Este comando de exemplo cria um novo cluster do Kubernetes com um pool de nós do Linux chamado 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
Verificar seus clusters implantados
Para obter uma lista dos clusters do Kubernetes implantados, execute o seguinte comando Get-AksHciCluster do 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 do 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 seu cluster ao Kubernetes habilitado para Arc
Conecte o cluster ao Kubernetes habilitado para Arc executando o comando Enable-AksHciArcConnection . O exemplo a seguir conecta o cluster do Kubernetes ao Arc usando a assinatura e os detalhes do grupo de recursos que você passou no Set-AksHciRegistration comando:
Connect-AzAccount
Enable-AksHciArcConnection -name mycluster
Observação
Se você encontrar problemas ou mensagens de erro durante o processo de instalação, consulte problemas e erros conhecidos da instalação para obter mais informações.
Dimensionar um cluster do Kubernetes
Se você precisar escalar ou reduzir verticalmente o cluster, poderá alterar o número de nós do painel 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 os nós do painel 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
Observação
Nas versões anteriores do AKS no Azure Stack HCI e no Windows Server, o comando Set-AksHciCluster também era usado para dimensionar nós de trabalho. Agora que o AKS está introduzindo pools de nós em clusters de carga de trabalho, você só poderá usar esse comando para dimensionar nós de trabalho se o cluster tiver sido criado com o parâmetro antigo definido em New-AksHciCluster.
Para dimensionar nós de trabalho em um pool de nós, use o comando Set-AksHciNodePool .
Acessar seus clusters usando kubectl
Para acessar os clusters do Kubernetes usando kubectl, execute o comando Get-AksHciCredential do PowerShell. Isso usará o arquivo kubeconfig do cluster especificado como o arquivo kubeconfig padrão para kubectl. Você também pode usar o kubectl para implantar aplicativos usando o Helm:
Get-AksHciCredential -name mycluster
Excluir um cluster do Kubernetes
Para excluir um cluster do Kubernetes, execute o seguinte comando:
Remove-AksHciCluster -name mycluster
Observação
Verifique se o cluster foi excluído examinando as VMs existentes no Gerenciador do Hyper-V. Se elas não forem excluídas, você poderá excluir manualmente as VMs. Em seguida, execute o comando Restart-Service wssdagent. Execute esse comando em cada nó no cluster de failover.
Obter logs
Para obter logs de todos os pods, execute o comando Get-AksHciLogs . Esse comando cria uma pasta compactada de saída chamada akshcilogs.zip no 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 a configurar um host do AKS e criar clusters do Kubernetes usando o PowerShell. Você também aprendeu a usar o PowerShell para dimensionar um cluster do Kubernetes e acessar clusters com kubectl.