Distribuire un host servizio Azure Kubernetes con oggetti servizio cluster pre-gestione e record DNS con PowerShell

  • Articolo

Si applica a: Servizio Azure Kubernetes in Azure Stack HCI 22H2, servizio Azure Kubernetes in Windows Server

Questa guida pratica descrive come usare PowerShell per configurare la distribuzione dell'host del servizio Azure Kubernetes se si usano oggetti servizio cluster pre-staging e record DNS nel servizio Azure Kubernetes abilitato da Azure Arc.

Operazioni preliminari

  • Assicurarsi di soddisfare tutti i prerequisiti nei requisiti di sistema.
  • Scaricare e installare il modulo Azure KubernetesHci di PowerShell.

Passaggio 1: Preparare Active Directory e il server DNS per la distribuzione

Se non è possibile abilitare gli aggiornamenti DNS dinamici nell'ambiente DNS per consentire al servizio Azure Kubernetes abilitato da Arc di registrare il nome del cluster generico dell'agente cloud in Active Directory e il sistema DNS per l'individuazione, è necessario pre-creare i rispettivi record in Active Directory e DNS.

Creare un servizio cluster generico in Active Directory con il nome (o un nome ca-cloudagent di propria scelta che non superi i 32 caratteri). Creare inoltre un record DNS associato che punti al nome di dominio completo del servizio cluster generico con l'indirizzo specificato cloudservicecidr . Per altre informazioni sui passaggi di questo processo, vedere la documentazione sul clustering di failover.

La distribuzione del servizio Azure Kubernetes tenta di individuare l'oggetto specificato clusterRoleName in Active Directory prima di procedere con la distribuzione.

Nota

Dopo la distribuzione del servizio Azure Kubernetes, queste informazioni non possono essere modificate.

Passaggio 2: Preparare i computer per la distribuzione

Eseguire controlli su ogni nodo fisico per verificare se tutti i requisiti sono soddisfatti per installare Il servizio Azure Kubernetes Arc. Aprire PowerShell come amministratore ed eseguire il comando Initialize-AksHciNode seguente:

Initialize-AksHciNode

Passaggio 3: Creare una rete virtuale

Per creare una rete virtuale per i nodi nella distribuzione da usare, creare una variabile di ambiente con il New-AksHciNetworkSetting comando di PowerShell. Questa variabile viene usata in un secondo momento per configurare una distribuzione che usa l'indirizzo IP statico. Per configurare la distribuzione del servizio Azure Kubernetes con DHCP, vedere New-AksHciNetworkSetting per esempi. È anche possibile esaminare alcuni concetti relativi ai nodi di rete.

# 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

È necessario personalizzare i valori visualizzati in questo comando di esempio per l'ambiente in uso.

Passaggio 4: Configurare la distribuzione con gli oggetti servizio cluster pre-staging e i record DNS

Impostare le impostazioni di configurazione per l'host del servizio Azure Kubernetes usando il comando Set-AksHciConfig . È necessario specificare i workingDirparametri , cloudServiceCidrcloudConfigLocation, e clusterRoleName . Per reimpostare i dettagli di configurazione, eseguire di nuovo il comando con nuovi parametri.

Configurare la distribuzione con il comando seguente:

Set-AksHciConfig -workingDir c:\ClusterStorage\Volume1\workingDir -cloudConfigLocation c:\clusterstorage\volume1\Config -vnet $vnet -cloudservicecidr "172.16.10.10/16" -clusterRoleName "ca-cloudagent"

Nota

Personalizzare i valori visualizzati in questo comando di esempio per l'ambiente in uso.

Passaggio 5: Accedere ad Azure e configurare le impostazioni di registrazione

Eseguire il comando Set-AksHciRegistration di PowerShell seguente con la sottoscrizione e il nome del gruppo di risorse per accedere ad Azure. Per procedere, è necessario avere una sottoscrizione di Azure e un gruppo di risorse di Azure esistente nelle aree Stati Uniti orientali, Asia sud-orientale o Europa occidentale:

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

Passaggio 6: Avviare una nuova distribuzione

Dopo aver configurato la distribuzione, è necessario avviarla. L'avvio della distribuzione installa gli agenti/servizi del servizio Azure Kubernetes e l'host del servizio Azure Kubernetes. Per iniziare la distribuzione, eseguire il comando seguente:

Install-AksHci

Avviso

Durante l'installazione dell'host del servizio Azure Kubernetes, viene creato un tipo di risorsa Kubernetes - Azure Arc nel gruppo di risorse impostato durante la registrazione. Non eliminare questa risorsa, perché rappresenta l'host servizio Azure Kubernetes. È possibile identificare la risorsa controllando il relativo campo di distribuzione per il aks_management valore . L'eliminazione di questa risorsa comporta una distribuzione out-of-policy.

Passaggi successivi