Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Gilt für: Windows Server Datacenter
Dieser Schnellstart führt Sie durch die Einrichtung eines Azure Kubernetes Service (AKS) Hosts. Sie erstellen Kubernetes-Cluster auf Windows Server mithilfe der PowerShell. Falls Sie stattdessen Windows Admin Center verwenden möchten, finden Sie weitere Informationen unter Schnellstart: Einrichten eines Azure Kubernetes Service-Hosts für Azure Stack HCI mit PowerShell.
Hinweis
- Wenn Sie Clusterdienst-Objekte und DNS-Einträge vordefiniert haben, lesen Sie Einrichten eines AKS-Hosts mit vordefinierten Clusterdienst-Objekten und DNS-Einträgen mit PowerShell.
- Wenn Sie einen Proxyserver haben, finden Sie Informationen unter Einrichten eines AKS-Hosts und Bereitstellen eines Workloadclusters mithilfe von PowerShell und eines Proxyservers.
Voraussetzungen
- Stellen Sie sicher, dass Sie alle Voraussetzungen unter Systemvoraussetzungenerfüllen.
- Verwenden Sie ein Azure-Konto zum Registrieren Ihres AKS-Hosts für die Abrechnung. Weitere Informationen finden Sie in den Azure-Anforderungen.
Installieren des PowerShell-Moduls „AksHci“
Führen Sie die folgenden Schritte auf allen Knoten in Ihrem Windows Server-Cluster aus:
Hinweis
Wenn Sie Remote-PowerShell verwenden, müssen Sie CredSSP verwenden.
Schließen Sie alle geöffneten PowerShell-Fenster, öffnen Sie eine neue PowerShell-Sitzung als Administrator, und führen Sie den folgenden Befehl auf allen Knoten in Ihrem Windows Server-Cluster aus:
Install-PackageProvider -Name NuGet -Force Install-Module -Name PowershellGet -Force -Confirm:$falseSie müssen alle vorhandenen PowerShell-Fenster erneut schließen, um sicherzustellen, dass geladene Module aktualisiert werden. Fahren Sie nicht mit dem nächsten Schritt fort, bevor Sie nicht alle geöffneten PowerShell-Fenster geschlossen haben.
Installieren Sie das AksHci PowerShell-Modul, indem Sie den folgenden Befehl auf allen Knoten in Ihrem Windows Server-Cluster ausführen:
Install-Module -Name AksHci -Repository PSGallery -Force -AcceptLicenseSie müssen alle vorhandenen PowerShell-Fenster erneut schließen, um sicherzustellen, dass geladene Module aktualisiert werden. Fahren Sie nicht mit dem nächsten Schritt fort, bevor Sie nicht alle geöffneten PowerShell-Fenster geschlossen haben.
Sie können ein Hilfsskript verwenden, um alte AKS-HCI PowerShell-Modulezu löschen, um Probleme mit PowerShell-Versionen in Ihrem AKS-Einsatz zu vermeiden.
Überprüfen Ihrer Installation
Get-Command -Module AksHci
Die vollständige Liste der AksHci PowerShell-Befehle finden Sie unter AksHci PowerShell.
Registrieren des Ressourcenanbieters bei Ihrem Abonnement
Aktivieren Sie vor dem Registrierungsprozess den entsprechenden Ressourcenanbieter in Azure für die AKS-Registrierung. Führen Sie dazu die folgenden PowerShell-Befehle aus:
Um sich bei Azure anzumelden, führen Sie den PowerShell-Befehl Connect-AzAccount aus:
Connect-AzAccount
Wenn Sie zu einem anderen Abonnement wechseln möchten, führen Sie den PowerShell-Befehl Set-AzContext aus:
Set-AzContext -Subscription "xxxx-xxxx-xxxx-xxxx"
Führen Sie die folgenden Befehle aus, um Ihr Azure-Abonnement für Azure Arc-fähige Kubernetes-Ressourcenanbieter zu registrieren. Dieser Registrierungsvorgang kann bis zu 10 Minuten dauern, muss aber nur einmal für ein bestimmtes Abonnement durchgeführt werden:
Register-AzResourceProvider -ProviderNamespace Microsoft.Kubernetes
Register-AzResourceProvider -ProviderNamespace Microsoft.KubernetesConfiguration
Register-AzResourceProvider -ProviderNamespace Microsoft.ExtendedLocation
Um die Registrierung zu überprüfen, führen Sie die folgenden PowerShell-Befehle aus:
Get-AzResourceProvider -ProviderNamespace Microsoft.Kubernetes
Get-AzResourceProvider -ProviderNamespace Microsoft.KubernetesConfiguration
Get-AzResourceProvider -ProviderNamespace Microsoft.ExtendedLocation
Schritt 1: Bereiten Sie Ihre Maschine(n) für die Bereitstellung vor
Führen Sie auf jedem physischen Knoten Prüfungen durch, um festzustellen, ob alle Voraussetzungen für die Installation von AKS erfüllt sind. Öffnen Sie PowerShell als Administrator und führen Sie den folgenden Befehl Initialize-AksHciNode auf allen Knoten in Ihrem Windows Server-Cluster aus:
Initialize-AksHciNode
Schritt 2: Erstellen Sie ein virtuelles Netzwerk
Führen Sie die folgenden Befehle auf einem beliebigen Knoten in Ihrem Windows Server-Cluster aus.
Führen Sie den folgenden Befehl aus, um die Namen der verfügbaren Switches zu ermitteln. Vergewissern Sie sich, dass der SwitchType Ihres VM-Switches Externist:
Get-VMSwitch
Beispielausgabe:
Name SwitchType NetAdapterInterfaceDescription
---- ---------- ------------------------------
extSwitch External Mellanox ConnectX-3 Pro Ethernet Adapter
Um ein virtuelles Netzwerk zu erstellen, das die Knoten in Ihrer Bereitstellung verwenden sollen, erstellen Sie eine Umgebungsvariable mit dem PowerShell-Befehl New-AksHciNetworkSetting. Dieses virtuelle Netzwerk wird später für die Konfiguration einer Einrichtung mit statischer IP verwendet. Wenn Sie Ihren AKS-Einsatz 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 myvnet -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" -vlanId 9
Hinweis
Sie müssen die in diesem Beispielbefehl gezeigten Werte an Ihre Umgebung anpassen.
Schritt 3: Konfigurieren Sie Ihre Bereitstellung
Führen Sie die folgenden Befehle auf einem beliebigen Knoten in Ihrem Windows Server-Cluster aus.
Verwenden Sie den Befehl Set-AksHciConfig, um die Konfigurationseinstellungen für den AKS-Host zu erstellen. Sie müssen die Parameter imageDir, workingDir und cloudConfigLocation angeben. Um Ihre Konfigurationsdetails zurückzusetzen, führen Sie den Befehl erneut mit neuen Parametern aus.
Konfigurieren Sie Ihre Bereitstellung mit dem folgenden Befehl:
$csvPath = 'C:\clusterstorage\volume01' # Specify your preferred CSV path
Set-AksHciConfig -imageDir $csvPath\Images -workingDir $csvPath\ImageStore -cloudConfigLocation $csvPath\Config -vnet $vnet
Hinweis
Sie müssen die in diesem Beispielbefehl für Ihre Umgebung angezeigten Werte anpassen, aber Sie können den VM-Namen auf dem Host oder im Kubernetes-Cluster nicht ändern.
Schritt 4: Melden Sie sich bei Azure an und konfigurieren Sie die Registrierungseinstellungen
Option 1: Verwenden Sie Ihr Microsoft Entra-Konto, wenn Sie die Berechtigung "Eigentümer" haben.
Führen Sie den folgenden PowerShell-Befehl Set-AksHciRegistration mit dem Namen Ihres Abonnements und Ihrer Ressourcengruppe aus, um sich bei Azure anzumelden. Sie müssen über ein Azure-Abonnement und eine bestehende Azure-Ressourcengruppe in den Azure-Regionen Australia East, East US, Southeast Asia oder West Europe verfügen:
Set-AksHciRegistration -subscriptionId "<subscriptionId>" -resourceGroupName "<resourceGroupName>"
Option 2: Verwenden Sie einen Azure-Dienstprinzipal
Wenn Sie keinen Zugang zu einem Abonnement haben, bei dem Sie ein Ownersind, können Sie Ihren AKS-Host für die Abrechnung über einen Service Principal bei Azure registrieren. Weitere Informationen über die Verwendung eines Dienstprinzipals finden Sie unter AKS auf Windows Server mit einem Dienstprinzip registrieren.
Schritt 5: Starten Sie eine neue Bereitstellung
Führen Sie den folgenden Befehl auf einem beliebigen Knoten in Ihrem Windows Server-Cluster aus.
Nachdem Sie Ihre Bereitstellung konfiguriert haben, müssen Sie sie starten, um die AKS-Agenten und -Dienste sowie den AKS-Host zu installieren. Um mit der Bereitstellung zu beginnen, führen Sie den folgenden Befehl aus:
Tipp
Um zusätzliche Statusdetails während der Installation anzuzeigen, setzen Sie $VerbosePreference = "Continue" , bevor Sie fortfahren.
Install-AksHci
Warnung
Während der Installation Ihres AKS-Hosts wird ein Kubernetes - Azure Arc Ressourcentyp in der Ressourcengruppe erstellt, die bei der Registrierung festgelegt wurde. Löschen Sie diese Ressource nicht, da sie Ihren AKS-Host repräsentiert. Sie können die Ressource ermitteln, indem Sie überprüfen, ob das zugehörige Verteilungsfeld den Wert aks_management aufweist. Wenn Sie diese Ressource löschen, führt dies zu einer Bereitstellung außerhalb der Richtlinie.
Schritt 6: Erstellen eines Kubernetes-Clusters
Nachdem Sie Ihren AKS-Host installiert haben, können Sie einen Kubernetes-Cluster einrichten. Öffnen Sie PowerShell als Administrator, und führen Sie den folgenden New-AksHciCluster-Befehl aus. Dieser Beispielbefehl erstellt einen neuen Kubernetes-Cluster mit einem Linux-Knotenpool namens linuxnodepool mit einer Knotenanzahl von 1.
Weitere Informationen über Knotenpools finden Sie unter Verwendung von Knotenpools in AKS.
New-AksHciCluster -name mycluster -nodePoolName linuxnodepool -nodeCount 1 -osType Linux
Überprüfen Ihrer bereitgestellten Cluster
Um eine Liste Ihrer bereitgestellten Kubernetes-Cluster zu erhalten, führen Sie den folgenden PowerShell-Befehl Get-AksHciCluster aus:
Get-AksHciCluster
ProvisioningState : provisioned
KubernetesVersion : v1.20.7
NodePools : linuxnodepool
WindowsNodeCount : 0
LinuxNodeCount : 0
ControlPlaneNodeCount : 1
Name : mycluster
Um eine Liste der Knotenpools im Cluster zu erhalten, führen Sie den folgenden PowerShell-Befehl Get-AksHciNodePool aus:
Get-AksHciNodePool -clusterName mycluster
ClusterName : mycluster
NodePoolName : linuxnodepool
Version : v1.20.7
OsType : Linux
NodeCount : 1
VmSize : Standard_K8S3_v1
Phase : Deployed
Schritt 7: Verbinden Sie Ihren Cluster mit Arc-aktiviertem Kubernetes
Verbinden Sie Ihren Cluster mit Arc-fähigen Kubernetes, indem Sie den Befehl Enable-AksHciArcConnection ausführen. Das folgende Beispiel verbindet Ihren Kubernetes-Cluster mit Arc unter Verwendung der Abonnement- und Ressourcengruppendetails, die Sie mit dem Befehl Set-AksHciRegistration übergeben haben:
Connect-AzAccount
Enable-AksHciArcConnection -name mycluster
Hinweis
Wenn Sie während des Installationsvorgangs auf Probleme oder Fehlermeldungen stoßen, finden Sie weitere Informationen unter Installation bekannte Probleme und Fehler .
Skalieren eines Kubernetes-Clusters
Wenn Sie Ihren Cluster hoch- oder herunterskalieren müssen, können Sie die Anzahl der Knoten auf Steuerungsebene ändern, indem Sie den Befehl Set-AksHciCluster verwenden. Um die Anzahl der Linux- oder Windows-Workerknoten in Ihrem Knotenpool zu ändern, verwenden Sie den Befehl Set-AksHciNodePool.
Führen Sie zum Skalieren von Knoten auf Steuerungsebene folgenden Befehl aus:
Set-AksHciCluster -name mycluster -controlPlaneNodeCount 3
Führen Sie zum Skalieren der Workerknoten in Ihrem Knotenpool den folgenden Befehl aus:
Set-AksHciNodePool -clusterName mycluster -name linuxnodepool -count 3
Hinweis
In früheren Versionen von AKS auf Windows Server wurde der Befehl Set-AksHciCluster auch zur Skalierung von Worker Nodes verwendet. Da AKS nun Knotenpools in Workload-Clustern einführt, können Sie diesen Befehl nur dann zur Skalierung von Arbeitsknoten verwenden, wenn Ihr Cluster mit dem alten Parameter in New-AksHciClustererstellt wurde.
Um Worker-Knoten in einem Nodepool zu skalieren, verwenden Sie den Befehl Set-AksHciNodePool .
Zugreifen auf Ihre Cluster mit kubectl
Um mit kubectlauf Ihre Kubernetes-Cluster zuzugreifen, führen Sie den PowerShell-Befehl Get-AksHciCredential aus. Dieser Befehl verwendet die Datei kubeconfig des angegebenen Clusters als Standarddatei kubeconfig für kubectl. Sie können auch kubectl verwenden, um mit HelmAnwendungen bereitzustellen:
Get-AksHciCredential -name mycluster
Löschen eines Kubernetes-Clusters
Um einen Kubernetes-Cluster zu löschen, führen Sie den folgenden Befehl aus:
Remove-AksHciCluster -name mycluster
Hinweis
Vergewissern Sie sich, dass Ihr Cluster gelöscht ist, indem Sie sich die vorhandenen VMs im Hyper-V Manager ansehen. Wenn sie nicht gelöscht werden, können Sie die VMs manuell löschen. Führen Sie anschließend den Befehl Restart-Service wssdagent aus. Führen Sie diesen Befehl auf jedem Knoten im Failovercluster aus.
Abrufen von Protokollen
Führen Sie den Get-AksHciLogs-Befehl aus, um die Protokolle Ihrer gesamten Pods zu erhalten. Dieser Befehl erstellt einen gezippten Ausgabeordner namens akshcilogs.zip in Ihrem Arbeitsverzeichnis. Der vollständige Pfad zum Ordner akshcilogs.zip ist die Ausgabe nach Ausführung des folgenden Befehls:
Get-AksHciLogs
In diesem Schnellstart haben Sie gelernt, wie Sie einen AKS-Host einrichten und Kubernetes-Cluster mit PowerShell erstellen. Sie haben auch gelernt, wie Sie PowerShell zum Skalieren eines Kubernetes-Clusters verwenden und mit kubectlauf Cluster zugreifen können.