Bereitstellen eines Azure Kubernetes Service Hosts mit vorab bereitgestellten Clusterdienstobjekten und DNS-Einträgen mithilfe von PowerShell

  • Artikel

Gilt für: AKS in Azure Stack HCI 22H2, AKS unter Windows Server

In dieser Anleitung wird beschrieben, wie Sie PowerShell verwenden, um Ihre AKS-Hostbereitstellung zu konfigurieren, wenn Sie über vorab bereitgestellte Clusterdienstobjekte und DNS-Einträge in AKS verfügen, die von Azure Arc aktiviert sind.

Vorbereitung

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, die von Arc aktiviert ist, den generischen Clusternamen des Cloud-Agents in Active Directory und dem DNS-System für die Ermittlung registrieren kann, 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). Sie müssen auch einen zugeordneten DNS-Eintrag erstellen, 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 zu Failoverclustering.

Die AKS-Bereitstellung versucht, den in Active Directory angegebenen clusterRoleName zu suchen, bevor mit der Bereitstellung fortgefahren wird.

Hinweis

Nach der Bereitstellung von AKS können diese Informationen nicht mehr geändert werden.

Schritt 2: Vorbereiten Ihrer Computer für die Bereitstellung

Führen Sie Überprüfungen auf jedem physischen Knoten aus, um festzustellen, ob alle Anforderungen für die Installation von AKS Arc erfüllt sind. Öffnen Sie PowerShell als Administrator, und führen Sie den folgenden Initialize-AksHciNode-Befehl aus:

Initialize-AksHciNode

Schritt 3: Erstellen eines virtuellen Netzwerks

Um ein virtuelles Netzwerk für die Knoten in Ihrer Bereitstellung zu erstellen, erstellen Sie mit dem New-AksHciNetworkSetting PowerShell-Befehl eine Umgebungsvariable. Diese Variable wird später verwendet, um eine Bereitstellung zu konfigurieren, die statische IP-Adresse verwendet. Wenn Sie Ihre AKS-Bereitstellung mit DHCP konfigurieren möchten, finden Sie Unter New-AksHciNetworkSetting finden Sie Beispiele. 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 in diesem Beispielbefehl angegebenen Werte für Ihre Umgebung anpassen.

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 angegebenen Werte für Ihre Umgebung an.

Schritt 5: Anmelden bei Azure und Konfigurieren der Registrierungseinstellungen

Führen Sie den folgenden PowerShell-Befehl Set-AksHciRegistration mit Ihrem Abonnement und ihrem Ressourcengruppennamen aus, um sich bei Azure anzumelden. Sie benötigen ein Azure-Abonnement und eine vorhandene Azure-Ressourcengruppe in den Azure-Regionen "USA, Osten", "Asien, Südosten" oder "Europa, Westen", um fortfahren zu können:

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

Schritt 6: Starten einer neuen Bereitstellung

Nachdem Sie Ihre 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 in der Ressourcengruppe, die während der Registrierung festgelegt wird, ein Ressourcentyp Kubernetes – Azure Arc erstellt. Löschen Sie diese Ressource nicht, da sie Ihren Azure Kubernetes Service-Host darstellt. Sie können die Ressource ermitteln, indem Sie überprüfen, ob das zugehörige Verteilungsfeld den Wert aks_management aufweist. Das Löschen dieser Ressource führt zu einer Bereitstellung außerhalb der Richtlinie.

In dieser Anleitung haben Sie erfahren, wie Sie einen AKS-Host mithilfe von PowerShell einrichten, wenn Sie über vorab bereitgestellte Clusterdienstobjekte und DNS-Einträge verfügen.

Nächste Schritte