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

  • Artigo

Aplica-se a: AKS no Azure Stack HCI 22H2, AKS no Windows Server

Este guia de instruções descreve como usar o PowerShell para configurar sua implantação de host do AKS se você tiver objetos de serviço de cluster pré-preparados e registros DNS no AKS habilitados pelo Azure Arc.

Antes de começar

Etapa 1: preparar seu active directory e servidor DNS para implantação

Se você não puder habilitar atualizações DNS dinâmicas em seu ambiente DNS para permitir que o AKS habilitado pelo Arc registre o nome de cluster genérico do agente de nuvem no Active Directory e no sistema DNS para descoberta, você deve pré-criar 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 que não exceda 32 caracteres). Você também deve 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 clustering de failover.

A implantação do AKS tenta localizar o especificado clusterRoleName no Active Directory antes de prosseguir com a implantação.

Observação

Depois que o AKS é implantado, essas informações não podem ser alteradas.

Etapa 2: preparar seus computadores para implantação

Execute verificações em cada nó físico para ver se todos os requisitos estão satisfeitos para instalar o AKS Arc. 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 a serem usados, crie uma variável de ambiente com o comando do New-AksHciNetworkSetting PowerShell. Essa variável é 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 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ê deve 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é-preparados e os registros DNS

Defina as configurações do host aks usando o comando Set-AksHciConfig . Você deve especificar os workingDirparâmetros , cloudServiceCidr, cloudConfigLocatione clusterRoleName . 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

Personalize os valores fornecidos neste comando de exemplo para seu ambiente.

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

Execute o seguinte comando Set-AksHciRegistration do PowerShell 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 dos EUA, Sudeste da Ásia ou Oeste da Europa do Azure para continuar:

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

Etapa 6: Iniciar uma nova implantação

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

Install-AksHci

Aviso

Durante a instalação do host do AKS, 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 resulta em uma implantação fora da política.

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

Próximas etapas