Bereitstellen eines Azure Kubernetes Service Hosts mit vorab bereitgestellten Clusterdienstobjekten und DNS-Einträgen mithilfe von PowerShell
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
- Vergewissern Sie sich, dass Sie alle Voraussetzungen in den Systemanforderungen erfüllt sind.
- 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, 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
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für