Implementar um anfitrião Azure Kubernetes Service com objetos de serviço de cluster pré-faseados e registos DNS com o PowerShell

  • Artigo

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

Este guia de procedimentos descreve como utilizar o PowerShell para configurar a implementação do anfitrião do AKS se tiver objetos de serviço de cluster pré-preparados e registos DNS no AKS ativados pelo Azure Arc.

Antes de começar

Passo 1: Preparar o active directory e o servidor DNS para implementação

Se não conseguir ativar atualizações DNS dinâmicas no seu ambiente DNS para permitir que o AKS ativado pelo Arc registe o nome do cluster genérico do agente da cloud no Active Directory e no sistema DNS para deteção, tem de pré-criar os respetivos registos 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 à sua escolha que não exceda os 32 carateres). Também tem de criar um registo DNS associado que aponte para o FQDN do serviço de cluster genérico com o endereço fornecido cloudservicecidr . Pode encontrar mais detalhes sobre os passos neste processo na documentação Clustering de Ativação Pós-falha.

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

Nota

Assim que o AKS for implementado, estas informações não podem ser alteradas.

Passo 2: Preparar as máquinas para implementação

Execute verificações em todos os nós físicos 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

Passo 3: Criar uma rede virtual

Para criar uma rede virtual para os nós na implementação a utilizar, crie uma variável de ambiente com o comando do New-AksHciNetworkSetting PowerShell. Esta variável é utilizada mais tarde para configurar uma implementação que utiliza IP estático. Se quiser configurar a implementação do AKS com o DHCP, veja New-AksHciNetworkSetting para obter exemplos. Também pode rever 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

Tem de personalizar os valores indicados neste comando de exemplo para o seu ambiente.

Passo 4: Configurar a implementação com os objetos de serviço de cluster pré-faseados e os registos DNS

Defina as definições de configuração para o anfitrião do AKS com o comando Set-AksHciConfig . Tem de especificar os workingDirparâmetros , cloudServiceCidr, cloudConfigLocatione clusterRoleName . Se quiser repor os detalhes de configuração, execute o comando novamente com novos parâmetros.

Configure a implementaçã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 indicados neste comando de exemplo para o seu ambiente.

Passo 5: Iniciar sessão no Azure e configurar as definições de registo

Execute o seguinte comando Set-AksHciRegistration do PowerShell com a sua subscrição e o nome do grupo de recursos para iniciar sessão no Azure. Tem de ter uma subscrição do Azure e um grupo de recursos do Azure existente nas regiões E.U.A. Leste, Sudeste Asiático ou Europa Ocidental do Azure para continuar:

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

Passo 6: Iniciar uma nova implementação

Depois de configurar a implementação, tem de a iniciar. Iniciar a implementação instala os agentes/serviços do AKS e o anfitrião do AKS. Para iniciar a implementação, execute o seguinte comando:

Install-AksHci

Aviso

Durante a instalação do anfitrião do AKS, é criado um tipo de recurso Kubernetes – Azure Arc no grupo de recursos definido durante o registo. Não elimine este recurso, uma vez que representa o seu anfitrião Azure Kubernetes Service. Pode identificar o recurso ao verificar o respetivo campo de distribuição quanto a um valor de aks_management. Eliminar este recurso resulta numa implementação fora da política.

Neste guia de procedimentos, aprendeu a configurar um anfitrião do AKS com o PowerShell se tiver objetos de serviço de cluster pré-faseados e registos DNS.

Passos seguintes