Implantar um host Serviço de 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 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
- Verifique se você atendeu a todos os pré-requisitos nos requisitos do sistema.
- Baixe e instale o módulo do AksHci PowerShell.
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 workingDir
parâmetros , cloudServiceCidr
, cloudConfigLocation
e 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
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de