Implantar um host Serviço de Kubernetes do Azure com objetos de serviço de cluster pré-configurados e registros DNS usando o PowerShell

Neste guia de instruções, você aprenderá a usar o PowerShell para configurar sua implantação de host do AKS se tiver pré-configurado objetos de serviço de cluster e registros DNS.

Antes de começar

Etapa 1: Preparar o servidor do Active Directory e do DNS para implantação

Se você não puder habilitar atualizações DNS dinâmicas em seu ambiente DNS para permitir que o AKS no Azure Stack HCI e Windows Server registre o nome genérico do cluster do agente de nuvem no Active Directory e no sistema DNS para descoberta, você precisará criar previamente os respectivos registros no Active Directory e no DNS.

Crie um serviço de cluster genérico no Active Directory com o nome ca-cloudagent (ou um nome de sua escolha), mas não exceda 32 caracteres de comprimento. Você também precisa criar um registro DNS associado apontando para o FQDN do serviço de cluster genérico com o endereço fornecido cloudservicecidr . Mais detalhes sobre as etapas nesse processo podem ser encontrados na documentação do Clustering de Failover.

A implantação do AKS no Azure Stack HCI e no servidor Windows tentará localizar o especificado clusterRoleName no Active Directory antes de prosseguir com a implantação.

Observação

Depois que o AKS no Azure Stack HCI e no servidor Windows for implantado, essas informações não poderão ser alteradas.

Etapa 2: Preparar seus computadores para implantação

Execute verificações em cada nó físico para ver se todos os requisitos são atendidos para instalar Serviço de Kubernetes do Azure no Azure Stack HCI e no servidor Windows. Abra o PowerShell como administrador e execute o seguinte comando Initialize-AksHciNode .

Initialize-AksHciNode

Etapa 3: Criar uma rede virtual

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. Isso será usado posteriormente para configurar uma implantação que usa IP estático. Se você quiser configurar sua implantação do AKS com DHCP, visite New-AksHciNetworkSetting para obter exemplos. Você também pode examinar alguns conceitos de nó de rede.

#static IP
$vnet = New-AksHciNetworkSetting -name mgmt-vnet -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" 

Observação

Você precisa personalizar os valores fornecidos neste comando de exemplo para seu ambiente.

Etapa 4: Configurar sua implantação com os objetos de serviço de cluster pré-configurados e registros DNS

Defina as configurações do host Serviço de Kubernetes do Azure usando o comando Set-AksHciConfig. Você deve especificar os parâmetros, cloudServiceCidrcloudConfigLocatione clusterRoleName os workingDirparâmetros. 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:

Set-AksHciConfig -workingDir c:\ClusterStorage\Volume1\workingDir -cloudConfigLocation c:\clusterstorage\volume1\Config -vnet $vnet -cloudservicecidr "172.16.10.10/16" -clusterRoleName "ca-cloudagent"

Observação

Você precisa personalizar os valores fornecidos neste comando de exemplo para seu ambiente.

Etapa 5: Fazer logon no Azure e definir as configurações de registro

Execute o seguinte comando Set-AksHciRegistration PowerShell com sua assinatura e o nome do grupo de recursos para fazer logon no Azure. Você deve ter uma assinatura do Azure e um grupo de recursos existente do Azure nas regiões Leste dos EUA, Sudeste da Ásia ou Oeste da Europa para continuar.

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

Etapa 5: Iniciar uma nova implantação

Depois de configurar sua implantação, você deve iniciá-la. Iniciar a implantação instala o Serviço de Kubernetes do Azure no Azure Stack HCI e Windows agentes/serviços do Servidor e no host Serviço de Kubernetes do Azure. Para iniciar a implantação, execute o seguinte comando:

Install-AksHci

Aviso

Durante a instalação do host Serviço de Kubernetes do Azure, um tipo de recurso do Kubernetes – Azure Arc é criado no grupo de recursos definido durante o registro. Não exclua esse recurso, pois ele representa o host Serviço de Kubernetes do Azure. Você pode identificar o recurso verificando seu campo de distribuição para obter um valor de aks_management. A exclusão desse recurso resultará em uma implantação fora da política.

Neste guia de instruções, você aprendeu a configurar um host Serviço de Kubernetes do Azure usando o PowerShell se tiver pré-configurado objetos de serviço de cluster e registros DNS.

Próximas etapas