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

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 AKS se você pré-preparou objetos de serviço de cluster e registros DNS no AKS habilitado pelo Azure Arc.

Antes de começar

  • Certifique-se de satisfazer todos os pré-requisitos nos requisitos do sistema.
  • Baixe e instale o módulo AksHci PowerShell.

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

Se você não puder habilitar atualizações de DNS dinâmico em seu ambiente DNS para permitir que o AKS habilitado pelo Arc registre o nome genérico do cluster do agente de nuvem no Active Directory e o sistema DNS para descoberta, você deverá 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). Além disso, crie um registro DNS associado que aponte para o FQDN do serviço de cluster genérico com o endereço fornecido cloudservicecidr . Para obter mais informações sobre as etapas desse processo, consulte a documentação de 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 suas máquinas para implantação

Execute verificações em cada nó físico para ver se todos os requisitos sã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 usarem, crie uma variável de ambiente com o New-AksHciNetworkSetting comando 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 revisar 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 mostrados neste comando de exemplo para seu ambiente.

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

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

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 mostrados neste comando de exemplo para seu ambiente.

Etapa 5: Entre no Azure e defina as configurações de registro

Execute o seguinte comando Set-AksHciRegistration PowerShell com sua assinatura e 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 Asiático ou Europa Ocidental do Azure para prosseguir:

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 AKS e o host AKS. Para iniciar a implantação, execute o seguinte comando:

Install-AksHci

Aviso

Durante a instalação do host 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 seu host do Serviço de Kubernetes do Azure. Você pode identificar o recurso verificando seu campo de distribuição para o aks_management valor. A exclusão desse recurso resulta em uma implantação fora da política.

Próximas etapas