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 habilitados 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 Ative Directory e o servidor DNS para implantação
Se não for possível habilitar as atualizações dinâmicas de DNS em seu ambiente DNS para permitir que o AKS habilitado pela Arc registre o nome do cluster genérico do agente de nuvem no Ative Directory e no sistema DNS para descoberta, você deverá pré-criar os respetivos registros no Ative Directory e no DNS.
Crie um serviço de cluster genérico no Ative 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 Ative Directory antes de prosseguir com a implantação.
Nota
Uma vez implantado o AKS, 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 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 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"
Nota
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 workingDir
parâmetros , cloudServiceCidr
, cloudConfigLocation
, e 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"
Nota
Personalize os valores mostrados 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 PowerShell com seu nome de assinatura e 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 do Azure Leste dos EUA, Sudeste Asiático ou Europa Ocidental para prosseguir:
Set-AksHciRegistration -subscriptionId "<subscriptionId>" -resourceGroupName "<resourceGroupName>"
Etapa 6: Iniciar uma nova implantação
Depois de configurar sua 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 seu 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 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.