Bereitstellen eines Azure Kubernetes-Diensthosts mit vorab bereitgestellten Clusterdienstobjekten und DNS-Einträgen mithilfe von PowerShell
Gilt für: AKS auf Azure Stack HCI 22H2, AKS unter Windows Server
In diesem Anleitungshandbuch wird beschrieben, wie Sie Ihre AKS-Hostbereitstellung mithilfe von PowerShell konfigurieren, wenn Sie vorab bereitgestellte Clusterdienstobjekte und DNS-Einträge in AKS konfigurieren, die von Azure Arc aktiviert sind.
Voraussetzungen
- Stellen Sie sicher, dass Sie alle Voraussetzungen in den Systemanforderungen erfüllen.
- Laden Sie das PowerShell-Modul „AksHci“ herunter, und installieren Sie es.
Schritt 1: Vorbereiten von Active Directory und DNS-Server für die Bereitstellung
Wenn Sie dynamische DNS-Updates in Ihrer DNS-Umgebung nicht aktivieren können, damit AKS von Arc aktiviert werden können, um den generischen Clusternamen des Cloud-Agents in Active Directory und das DNS-System für die Ermittlung zu registrieren, müssen Sie die entsprechenden Einträge in Active Directory und DNS vorab erstellen.
Erstellen Sie einen generischen Clusterdienst in Active Directory mit dem Namen ca-cloudagent (oder einem Namen Ihrer Wahl, der 32 Zeichen nicht überschreitet). Erstellen Sie außerdem einen zugeordneten DNS-Eintrag, der auf den FQDN des generischen Clusterdiensts mit der angegebenen cloudservicecidr Adresse verweist. Weitere Informationen zu den Schritten in diesem Prozess finden Sie in der Dokumentation zum Failoverclustering.
Die AKS-Bereitstellung versucht, das in Active Directory angegebene clusterRoleName Verzeichnis zu finden, bevor Sie mit der Bereitstellung fortfahren.
Hinweis
Nachdem AKS bereitgestellt wurde, können diese Informationen nicht mehr geändert werden.
Schritt 2: Vorbereiten der Computer für die Bereitstellung
Führen Sie Überprüfungen für jeden physischen Knoten aus, um festzustellen, ob alle Anforderungen erfüllt sind, um AKS Arc zu installieren. Öffnen Sie PowerShell als Administrator, und führen Sie den folgenden Befehl Initialize-AksHciNode aus:
Initialize-AksHciNode
Schritt 3: Erstellen eines virtuellen Netzwerks
Um ein virtuelles Netzwerk für die Knoten in Ihrer Bereitstellung zu erstellen, erstellen Sie eine Umgebungsvariable mit dem New-AksHciNetworkSetting PowerShell-Befehl. Diese Variable wird später verwendet, um eine Bereitstellung zu konfigurieren, die statische IP verwendet. Wenn Sie Ihre AKS-Bereitstellung mit DHCP konfigurieren möchten, finden Sie beispiele unter New-AksHciNetworkSetting . Sie können auch einige Konzepte für Netzwerkknoten überprüfen.
# 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"
Hinweis
Sie müssen die werte anpassen, die in diesem Beispielbefehl für Ihre Umgebung angezeigt werden.
Schritt 4: Konfigurieren Der Bereitstellung mit den vorab bereitgestellten Clusterdienstobjekten und DNS-Einträgen
Legen Sie die Konfigurationseinstellungen für den AKS-Host mithilfe des Befehls "Set-AksHciConfig " fest. Sie müssen die Parameter workingDir, cloudServiceCidr, cloudConfigLocation und clusterRoleName angeben. Um Ihre Konfigurationsdetails zurückzusetzen, führen Sie den Befehl erneut mit neuen Parametern aus.
Konfigurieren Sie Ihre Bereitstellung mit dem folgenden Befehl:
Set-AksHciConfig -workingDir c:\ClusterStorage\Volume1\workingDir -cloudConfigLocation c:\clusterstorage\volume1\Config -vnet $vnet -cloudservicecidr "172.16.10.10/16" -clusterRoleName "ca-cloudagent"
Hinweis
Passen Sie die in diesem Beispielbefehl angezeigten Werte für Ihre Umgebung an.
Schritt 5: Anmelden bei Azure und Konfigurieren von Registrierungseinstellungen
Führen Sie den folgenden Set-AksHciRegistration PowerShell-Befehl mit Ihrem Abonnement- und Ressourcengruppennamen aus, um sich bei Azure anzumelden. Sie müssen über ein Azure-Abonnement und eine vorhandene Azure-Ressourcengruppe in den Regionen Ost-, Südostasien oder Westeuropa verfügen, um den Vorgang fortzusetzen:
Set-AksHciRegistration -subscriptionId "<subscriptionId>" -resourceGroupName "<resourceGroupName>"
Schritt 6: Starten einer neuen Bereitstellung
Nachdem Sie die Bereitstellung konfiguriert haben, müssen Sie sie starten. Beim Starten der Bereitstellung werden die AKS-Agents/-Dienste und der AKS-Host installiert. Führen Sie den folgenden Befehl aus, um die Bereitstellung zu starten:
Install-AksHci
Warnung
Während der Installation Ihres AKS-Hosts wird ein Kubernetes - Azure Arc-Ressourcentyp in der Ressourcengruppe erstellt, die während der Registrierung festgelegt ist. Löschen Sie diese Ressource nicht, da sie Ihren Azure Kubernetes-Diensthost darstellt. Sie können die Ressource identifizieren, indem Sie das Verteilungsfeld für den aks_management Wert überprüfen. Das Löschen dieser Ressource führt zu einer Out-of-Policy-Bereitstellung.