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.