Wie behebe ich Probleme mit benutzerdefinierten Startvorlagen mit verwalteten Knotengruppen in Amazon EKS?

Kurzbeschreibung

Wenn du eine benutzerdefinierte Startvorlage mit verwalteten Knotengruppen in deinem Amazon-EKS-Cluster verwendest, wird möglicherweise eine der folgenden Fehlermeldungen angezeigt:

• "Client.InternalError: Client error on launch"
• "SourceEc2LaunchTemplateNotFound or The Amazon EC2 Launch Template lt-xxxxxxxxxxxxxxxxx version x was not found"
• "Node group entered a DEGRADED status"

Lösung

Client error on launch

Dieser Fehler tritt auf, wenn du verschlüsselte Amazon Elastic Block Store (Amazon EBS)-Volumes in der benutzerdefinierten Startvorlage mit falschen Berechtigungen verwendest. Führe die folgenden Aufgaben aus, um den Verschlüsselungsstatus und die Berechtigungen oder Richtlinien von AWS Identity and Access Management (IAM) zu überprüfen:

• Aktiviere den AWS Key Management Service (AWS KMS)-Schlüssel, der zur Verschlüsselung des Volumes verwendet wird.
• Stelle sicher, dass der AWS-KMS-Schlüssel die richtigen Schlüsselrichtlinien hat. Damit mehr IAM-Rollen mit verschlüsselten Amazon-EBS-Volumes arbeiten können, ändere die wichtigsten Richtlinien. Weitere Informationen findest du unter Erlaubt Schlüsselbenutzern die Verwendung des KMS-Schlüssels.

Startvorlage nicht gefunden

Dieser Fehler tritt auf, wenn du die Version der benutzerdefinierten Startvorlage manuell über die Auto-Scaling-Gruppe des Knotens anstelle von Amazon EKS änderst. Um dieses Problem zu beheben, musst du Amazon EKS verwenden, um die Version der Startvorlage zu aktualisieren.

Hinweis: Wenn du beim Ausführen von AWS Command Line Interface (AWS CLI)-Befehlen Fehlermeldungen erhältst, findest du weitere Informationen dazu unter Problembehandlung bei der AWS CLI. Stelle außerdem sicher, dass du die neueste Version der AWS CLI verwendest.

Gehe wie folgt vor, um deine Amazon Elastic Compute Cloud (Amazon EC2)-Startvorlage aus der verwalteten Knotengruppe zu aktualisieren:

1. Öffne die Amazon-EKS-Konsole.
2. Wähle im Navigationsbereich die Option Cluster aus.
3. Wähle unter Cluster-Name den Cluster aus, der die zu aktualisierende Knotengruppe enthält.
4. Wähle die Registerkarte Berechnen aus.
5. Wähle unter Knotengruppen deinen Knoten aus und wähle dann Version ändern aus.
   Hinweis: Diese Option wird nur angezeigt, wenn eine neue Version der Startvorlage verfügbar ist. Wenn du die Option nicht sehen kannst, verwende den AWS CLI-Befehl aws eks update-nodegroup-version, um die Startvorlagenversion der Knotengruppe zu ändern.
6. Wähle die Version aus, die auf deine Knotengruppe angewendet werden soll. Stelle sicher, dass die Aktualisierungsstrategie auf Fortlaufendes Update eingestellt ist.
7. Wähle Aktualisieren aus.

Dieser Fehler tritt auch auf, wenn du eine Referenzvorlage löschst, wenn du eine Knotengruppe mit einer benutzerdefinierten Startvorlage erstellst. Wenn du eine benutzerdefinierte Startvorlage verwendest, repliziert Amazon EKS die Vorlage. Wenn du die ursprüngliche Vorlage löschst, musst du die Knotengruppe neu erstellen.

Gehe wie folgt vor, um die Knotengruppe neu zu erstellen:

1. Starte eine neue Knotengruppe.

2. Führe den folgenden Befehl aus, um zu überprüfen, ob alle Knoten fehlerfrei sind, sich im Status Bereit befinden und dem Cluster beigetreten sind:

   $ kubectl get nodes

3. Entleere den Worker-Knoten.

4. Lösche die ursprüngliche Knotengruppe.

Knotengruppe wechselt in den Status DEGRADED

Eine Knotengruppe kann in den Status DEGRADED wechseln, nachdem Amazon EKS eine Startvorlage mit einer Fehlermeldung ähnlich der folgenden erstellt hat:

"The Amazon EC2 Launch Template : lt-xxxxxxxxxxxxxxxxx has a new version associated with your Autoscaling group, which is not managed by Amazon EKS. Expected Launch Template version: x".

Dieser Fehler tritt auf, wenn die Amazon-EC2-Startvorlagenversion für deine verwaltete Knotengruppe nicht mit der Version übereinstimmt, die Amazon EKS erstellt. Du kannst nur vorhandene Knotengruppen direkt aktualisieren, die eine benutzerdefinierte Startvorlage verwenden. Um diesen Fehler zu beheben, erstelle eine Startvorlage und eine Version mit deinen bevorzugten Einstellungen. Verwende dann die Startvorlage, um die Knotengruppe zu erstellen. Wenn die neue Knotengruppe von deiner benutzerdefinierten Vorlage aus startet, erstelle neue Versionen der Vorlage. Du kannst diese Vorlage verwenden, ohne die Knotengruppe in den Status DEGRADED zu versetzen.

Ähnliche Informationen

Verwaltete Knoten mit Startvorlagen anpassen

Grundlagen der Konfiguration von Startvorlagen