Grundlegende Behandlung von Problemen bei der Erstellung von AKS-Clustern

  • Artikel

In diesem Artikel werden die grundlegenden Methoden zur Problembehandlung beschrieben, die Verwendet werden sollten, wenn Sie einen Microsoft Azure Kubernetes Service-Cluster (AKS) nicht erfolgreich erstellen oder bereitstellen können.

Voraussetzungen

Anzeigen von Fehlern über die Azure CLI

Wenn Sie Cluster mithilfe der Azure CLI erstellen, werden Fehler als Ausgabe aufgezeichnet, wenn der Vorgang fehlschlägt. Hier sehen Sie, wie ein Befehl, eine Benutzereingabe und eine Vorgangsausgabe in einer Bash-Konsole angezeigt werden können:

$ az aks create --resource-group myResourceGroup \
> --name MyManagedCluster \
> --load-balancer-sku standard \
> --vnet-subnet-id /subscriptions/01234567-89ab-cdef-0123-456789abcdef/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/aks_demo_vnet/subnets/AKS

It is highly recommended to use USER assigned identity (option --assign-identity) when you want to bring you own subnet, which will have no latency for the role assignment to take effect. When you SYSTEM assigned identity, azure-cli will grant Network Contributor role to the system assigned identity after the cluster is created, and the role assignment will take some time to take effect, see https://learn.microsoft.com/azure/aks/use-managed-identity, proceed to create cluster with system assigned identity? (y/N): y

(ControlPlaneAddOnsNotReady) Pods not in Running status: konnectivity-agent-67f7f5554f-nsw2g,konnectivity-agent-8686cb54fd-xlsgk,metrics-server-6bc97b47f7-dfhbr,coredns-845757d86-7xjqb,coredns-autoscaler-5f85dc856b-mxkrj

Code: ControlPlaneAddOnsNotReady

Message: Pods not in Running status: konnectivity-agent-67f7f5554f-nsw2g,konnectivity-agent-8686cb54fd-xlsgk,metrics-server-6bc97b47f7-dfhbr,coredns-845757d86-7xjqb,coredns-autoscaler-5f85dc856b-mxkrj

Diese Fehler enthalten häufig detaillierte Beschreibungen, was bei der Clustererstellung schiefgelaufen ist, und sie enthalten Links zu Artikeln, die weitere Details enthalten. Darüber hinaus können Sie unsere Artikel zur Problembehandlung als Referenz verwenden, die auf dem Fehler basieren, den ein Azure CLI-Vorgang erzeugt.

Anzeigen von Fehlerdetails im Azure-Portal

Um die Details zu Fehlern im Azure-Portal anzuzeigen, überprüfen Sie das Azure-Aktivitätsprotokoll. Um die Liste der Aktivitätsprotokolle im Azure-Portal zu suchen, suchen Sie nach Aktivitätsprotokoll. Oder wählen Sie Benachrichtigungen (glockensymbol) und dann Weitere Ereignisse im Aktivitätsprotokoll aus.

Die Liste der Protokolle auf der Seite Aktivitätsprotokoll enthält einen Zeileneintrag, in dem der Spaltenwert Vorgangsnameden Namen Verwalteten Cluster erstellen oder aktualisieren trägt. Der entsprechende Spaltenwert Vom Ereignis initiiert wird auf den Namen Ihres Geschäfts-, Schul- oder Unikontos festgelegt. Wenn der Vorgang erfolgreich ist, wird im Spaltenwert Statusdie Option Akzeptiert angezeigt. Außerdem werden Unteroperationseinträge für die Erstellung der Clusterkomponenten angezeigt, z. B. die folgenden Vorgangsnamen:

  • Erstellen oder Aktualisieren einer Routingtabelle
  • Erstellen oder Aktualisieren einer Netzwerksicherheitsgruppe
  • Aktualisieren der Erstellung einer benutzerseitig zugewiesenen Identität
  • Erstellen oder Aktualisieren von Load Balancer
  • Erstellen oder Aktualisieren einer öffentlichen IP-Adresse
  • Erstellen einer Rollenzuweisung
  • Ressourcengruppe aktualisieren

In diesen Unteroperationseinträgen lautet der Wert StatusErfolgreich, und das Feld Ereignis initiiert von ist auf AzureContainerService festgelegt.

Was geschieht, wenn stattdessen ein Fehler aufgetreten ist? In diesem Fall wird im Feld Status des Vorgangs "Verwalteten Cluster erstellen oder aktualisieren" die Option Fehler angezeigt. Im Gegensatz zu den Vorgängen zum Erstellen von Clusterkomponenten müssen Sie hier den Eintrag für fehlgeschlagene Vorgänge erweitern, um die Unteroperationseinträge zu überprüfen. Typische Unteroperationsnamen sind Richtlinienaktionen, z. B. die Richtlinienaktion "audit" und die Richtlinienaktion "auditIfNotExists". Einige der Unteroperationen zeigen weiterhin, dass sie erfolgreich waren.

Zur weiteren Untersuchung können Sie einen der fehlgeschlagenen Unteroperationen auswählen. Ein seitenseitiger Bereich wird geöffnet, sodass Sie weitere Informationen zum Untervorgang anzeigen können. Sie können Probleme mit Werten für Felder wie Zusammenfassung, JSON und Änderungsverlauf beheben. Das JSON-Feld enthält den Ausgabetext für den Fehler im JSON-Format und enthält in der Regel die hilfreichsten Informationen.

Anzeigen von Clustererkenntnissen

Wurde der Cluster im Azure-Portal erstellt und ist er dort sichtbar? Wenn dies zutrifft, können Sie Clustererkenntnisse generieren, die Ihnen bei der Problembehandlung helfen. Führen Sie die folgenden Schritte aus, um auf dieses Feature zuzugreifen:

  1. Suchen Sie im Azure-Portal nach Kubernetes-Dienste, und wählen Sie diese Option aus.

  2. Wählen Sie den Namen Ihres AKS-Clusters aus.

  3. Wählen Sie im Navigationsbereich der AKS-Clusterseite Diagnose und Problembehandlung aus.

  4. Wählen Sie auf der Seite Probleme diagnostizieren und lösen den Link Cluster insights aus. Das Clustererkenntnissetool analysiert Ihren Cluster und stellt dann eine Liste der Ergebnisse im Abschnitt Beobachtungen und Lösungen auf der Seite Cluster insights bereit.

  5. Wählen Sie eines der Ergebnisse aus, um weitere Informationen zu einem Problem und seinen möglichen Lösungen anzuzeigen.

Anzeigen von Ressourcen im Azure-Portal

Im Azure-Portal möchten Sie möglicherweise die Ressourcen anzeigen, die beim Erstellen des Clusters erstellt wurden. In der Regel befinden sich diese Ressourcen in einer Ressourcengruppe, die in MC_ beginnt. Die verwaltete Clusterressourcengruppe kann einen Namen wie MC_MyResourceGroup_MyManagedCluster_<location-code> haben. Der Name kann sich jedoch unterscheiden, wenn Sie den Cluster mithilfe einer benutzerdefinierten verwalteten Clusterressourcengruppe erstellt haben.

Um die Ressourcengruppe zu finden, suchen Sie im Azure-Portal nach Ressourcengruppen, und wählen Sie sie aus, und wählen Sie dann die Ressourcengruppe aus, in der der Cluster erstellt wurde. Die Ressourcenliste wird auf der Seite Übersicht der Ressourcengruppe angezeigt.

Warnung

Es wird empfohlen, ressourcen in der ressourcengruppe MC_ nicht zu ändern. Diese Aktion kann zu unerwünschten Auswirkungen auf Ihren AKS-Cluster führen.

Um die status einer VM-Skalierungsgruppe zu überprüfen, können Sie den Namen der Skalierungsgruppe in der Liste der Ressourcen für die Ressourcengruppe auswählen. Es könnte einen Namen haben, der aks-nodepool1-12345678-vmss ähnelt, und er hätte den Wert Typ der VM-Skalierungsgruppe. Die status der Skalierungsgruppe wird oben auf der Seite Übersicht des Knotenpools angezeigt, und weitere Details werden in der Überschrift Essentials angezeigt. Wenn die Bereitstellung nicht erfolgreich war, lautet die angezeigte status Fehler.

Für alle Ressourcen können Sie Details überprüfen, um besser zu verstehen, warum die Bereitstellung fehlgeschlagen ist. Für eine Skalierungsgruppe können Sie den Text Fehler status auswählen, um Details zum Fehler anzuzeigen. Die Details befinden sich in einer Zeile, die die Spalten Status, Level und Code enthält. Das folgende Beispiel zeigt eine Zeile mit Spaltenwerten.

Spalte Beispielwert
Status Fehler bei der Bereitstellung
Ebene Error
Code ProvisioningState/failed/VMExtensionProvisioningError

Wählen Sie die Zeile aus, um das Feld Nachricht anzuzeigen. Diese enthält noch mehr Informationen zu diesem Fehler. Das Feld Nachricht für die Beispielzeile beginnt beispielsweise im folgenden Text:

VM hat einen Fehler bei der Verarbeitung der Erweiterung "vmssCSE" gemeldet. Fehlermeldung: "Fehler beim Aktivieren: Befehl konnte nicht ausgeführt werden: Befehl beendet mit exit status=50 [stdout] [stderr] 0 0 0 --:

Mit diesen Informationen können Sie schließen, dass die VMs in der Skalierungsgruppe fehlgeschlagen sind und dass ein Exit status 50 generiert wurde.

Hinweis

Wenn die Clusterbereitstellung nicht den Punkt erreicht hat, an dem diese Ressourcen erstellt wurden, können Sie die verwaltete Clusterressourcengruppe möglicherweise nicht im Azure-Portal überprüfen.

Verwenden von Kubectl-Befehlen

Geben Sie kubectl-Befehle ein, um Details zu den Ressourcen zu erhalten, die im Cluster bereitgestellt wurden, um eine weitere Option zur Problembehandlung von Fehlern in Ihrem Cluster zu erhalten. Um kubectl zu verwenden, melden Sie sich zuerst bei Ihrem AKS-Cluster an:

az aks get-credentials --resource-group MyResourceGroup --name MyManagedCluster

Abhängig von der Art des Fehlers und dem Zeitpunkt des Auftretens können Sie sich möglicherweise nicht bei Ihrem Cluster anmelden, um weitere Details zu erhalten. Wenn Ihr Cluster jedoch erstellt wurde und im Azure-Portal angezeigt wird, sollten Sie sich im Allgemeinen anmelden und kubectl-Befehle ausführen können.

Anzeigen von Clusterknoten (kubectl get-Knoten)

Um weitere Details zum Ermitteln des Zustands der Knoten zu erhalten, zeigen Sie die Clusterknoten an, indem Sie den Befehl kubectl get nodes eingeben. In diesem Beispiel melden keine Knoten im Cluster:

$ kubectl get nodes

No resources found

Anzeigen von Pods im Systemnamespace (kubectl get pods)

Das Anzeigen der Pods im kube-system-Namespace ist auch eine gute Möglichkeit, ihr Problem zu beheben. Mit dieser Methode können Sie die status der Kubernetes-Systempods anzeigen. In diesem Beispiel geben wir den kubectl get pods Befehl ein:

$ kubectl get pods -n kube-system
NAME                                  READY   STATUS    RESTARTS   AGE
coredns-845757d86-7xjqb               0/1     Pending   0          78m
coredns-autoscaler-5f85dc856b-mxkrj   0/1     Pending   0          77m
konnectivity-agent-67f7f5554f-nsw2g   0/1     Pending   0          77m
konnectivity-agent-8686cb54fd-xlsgk   0/1     Pending   0          65m
metrics-server-6bc97b47f7-dfhbr       0/1     Pending   0          77m

Beschreiben der status eines Pods (kubectl describe pod)

Indem Sie die status der Pods beschreiben, können Sie die Konfigurationsdetails und alle Ereignisse anzeigen, die auf den Pods aufgetreten sind. Führen Sie den Befehl kubectl describe pod aus:

$ kubectl describe pod coredns-845757d86-7xjqb -n kube-system
Name:                 coredns-845757d86-7xjqb
Namespace:            kube-system
Priority:             2000001000
Priority Class Name:  system-node-critical
Node:                 <none>
Labels:               k8s-app=kube-dns
                      kubernetes.io/cluster-service=true
                      pod-template-hash=845757d86
                      version=v20
...
Events:
  Type     Reason            Age                 From               Message
  ----     ------            ----                ----               -------
  Warning  FailedScheduling  24m (x1 over 25m)   default-scheduler  no nodes available to schedule pods
  Warning  FailedScheduling  29m (x57 over 84m)  default-scheduler  no nodes available to schedule pods

In der Befehlsausgabe sehen Sie, dass der Pod nicht auf einem Knoten bereitgestellt werden kann, da keine Knoten verfügbar sind.

Kontaktieren Sie uns für Hilfe

Wenn Sie Fragen haben oder Hilfe mit Ihren Azure-Gutschriften benötigen, dann erstellen Sie beim Azure-Support eine Support-Anforderung oder fragen Sie den Azure Community-Support. Sie können auch Produktfeedback an die Azure Feedback Community senden.