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

Kurzbeschreibung

Wenn Sie eine benutzerdefinierte Startvorlage mit verwalteten Knotengruppen in Ihrem Amazon-EKS-Cluster verwenden, 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“

Behebung

Client.InternalError: Client error on launch

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

• Aktivieren Sie den AWS Key Management Service (AWS KMS)-Schlüssel, der zur Verschlüsselung des Volumes verwendet wird.
• Stellen Sie 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, ändern Sie die wichtigsten Richtlinien. Weitere Informationen finden Sie unter Erlaubt Schlüsselbenutzern die Verwendung des KMS-Schlüssels.

SourceEc2LaunchTemplateNotFound or The Amazon EC2 Launch Template lt-xxxxxxxxxxxxxxxxx version x was not found

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

Gehen Sie wie folgt vor, um Ihre EC2-Startvorlage von der verwalteten Knotengruppe aus zu aktualisieren:

1. Öffnen Sie die Amazon-EKS-Konsole.
2. Wählen Sie im Navigationsbereich die Option Cluster aus.
3. Wählen Sie unter Clustername den Cluster aus, der die zu aktualisierende Knotengruppe enthält.
4. Wählen Sie die Registerkarte Berechnen.
5. Wählen Sie für Knotengruppen Ihren Knoten aus und wählen Sie dann Version ändern.
6. Wählen Sie die Version aus, die auf Ihre Knotengruppe angewendet werden soll. Stellen Sie sicher, dass die Aktualisierungsstrategie auf Fortlaufendes Update eingestellt ist.
7. Wählen Sie Aktualisieren aus.

Dieser Fehler tritt auch auf, wenn Sie eine Referenzvorlage löschen, wenn Sie eine Knotengruppe mit einer benutzerdefinierten Startvorlage erstellen. Wenn Sie eine Knotengruppe mit einer benutzerdefinierten Startvorlage erstellen, repliziert Amazon EKS die Vorlage. Wenn Sie die ursprüngliche Vorlage löschen, müssen Sie die Knotengruppe neu erstellen.

Gehen Sie wie folgt vor, um die Knotengruppe neu zu erstellen:

1. Starten Sie eine neue Knotengruppe.

2. Führen Sie 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. Entleeren Sie Ihre Worker-Knoten.

4. Löschen Sie die ursprüngliche Knotengruppe.

Die Node-Gruppe wechselt in den Status DEGRADED, nachdem sie eine neue Startvorlage erstellt hat.

Eine Knotengruppe kann mit einer Meldung, die der folgenden Fehlermeldung ähnelt, in den Status DEGRADED wechseln:

"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 Ihre verwaltete Knotengruppe nicht mit der Version übereinstimmt, die Amazon EKS erstellt. Bestehende Knotengruppen, die keine benutzerdefinierte Startvorlage verwenden, können nicht direkt aktualisiert werden. Um diesen Fehler zu beheben, erstellen Sie eine Startvorlage und eine Version mit Ihren bevorzugten Einstellungen. Verwenden Sie dann die Startvorlage, um die Knotengruppe zu erstellen. Wenn die neue Knotengruppe von Ihrer benutzerdefinierten Vorlage aus gestartet wird, erstellen Sie neue Versionen der Vorlage. Sie können diese Vorlage verwenden, ohne die Knotengruppe in den Status DEGRADED zu versetzen.

Ähnliche Informationen

Anpassen verwalteter Knoten mit Startvorlagen

Grundlagen der Konfiguration von Startvorlagen