Ein EKS Amazon-Add-on aktualisieren

Bestimmen Sie die aktuellen Add-Ons und Add-On-Versionen, die auf Ihrem Cluster installiert sind. Ersetzen Sie my-cluster mit dem Namen Ihres Clusters.

eksctl get addon --cluster my-cluster

Eine Beispielausgabe sieht wie folgt aus.

NAME        VERSION              STATUS  ISSUES  IAMROLE  UPDATE AVAILABLE
coredns     v1.8.7-eksbuild.2    ACTIVE  0
kube-proxy  v1.23.7-eksbuild.1   ACTIVE  0                v1.23.8-eksbuild.2
vpc-cni     v1.10.4-eksbuild.1   ACTIVE  0                v1.12.0-eksbuild.1,v1.11.4-eksbuild.1,v1.11.3-eksbuild.1,v1.11.2-eksbuild.1,v1.11.0-eksbuild.1

IIhre Ausgabe sieht möglicherweise anders aus, je nachdem, welche Add-Ons und Versionen Sie auf Ihrem Cluster haben. Sie können sehen, dass in der vorherigen Beispielausgabe für zwei vorhandene Add-Ons auf dem Cluster neuere Versionen in der UPDATE AVAILABLE-Spalte verfügbar sind.

Aktualisieren Sie das Add-On.

1. Kopieren Sie den folgenden Befehl auf Ihr Gerät. Nehmen Sie nach Bedarf die folgenden Änderungen am Befehl vor:

   • Ersetzen Sie my-cluster mit dem Namen Ihres Clusters.

   • region-codeErsetzen Sie es durch AWS-Region das, in dem sich Ihr Cluster befindet.

   • Ersetzen Sie vpc-cni durch den Namen eines Add-Ons, das in der Ausgabe des vorherigen Schritts zurückgegeben wurde, das Sie aktualisieren möchten.

   • Wenn Sie eine ältere Version als die neueste verfügbare Version aktualisieren möchten, dann ersetzen Sie latest durch die Versionsnummer, die in der Ausgabe des vorherigen Schritts zurückgegeben wurde, die Sie verwenden möchten. Für einige Add-Ons gibt es empfohlene Versionen. Weitere Informationen finden Sie in der Dokumentation für das Add-on, das Sie aktualisieren.

   • Wenn das Add-on eine verwendet Kubernetes Dienstkonto und IAM Rolle, 111122223333 ersetzen Sie sie durch Ihre Konto-ID und role-name durch den Namen einer vorhandenen IAM Rolle, die Sie erstellt haben. Anweisungen zum Erstellen der Rolle finden Sie in der Dokumentation für das Add-On, das Sie erstellen. Die Angabe einer Dienstkontorolle setzt voraus, dass Sie über eine IAM OpenID Connect (OIDC) Anbieter für Ihren Cluster. Um festzustellen, ob Sie über einen solchen für Ihren Cluster verfügen, oder um einen zu erstellen, lesen Sie Erstelle eine IAM OIDC Anbieter für Ihren Cluster.

     Wenn das Add-on kein verwendet Kubernetes Dienstkonto und IAM Rolle, löschen Sie die serviceAccountRoleARN: arn:aws:iam::111122223333:role/role-name Zeile.

   • Die preserve Option behält die vorhandenen Werte für das Add-on bei. Wenn Sie benutzerdefinierte Werte für Add-On-Einstellungen festgelegt haben und diese Option nicht verwenden, EKS überschreibt Amazon Ihre Werte mit den Standardwerten. Wenn Sie diese Option verwenden, empfehlen wir, dass Sie alle Feld- und Wertänderungen auf einem Nicht-Produktionscluster testen, bevor Sie das Add-on auf Ihrem Produktionscluster aktualisieren. Wenn Sie diesen Wert auf ändernoverwrite, werden alle Einstellungen auf EKS Amazon-Standardwerte geändert. Wenn Sie benutzerdefinierte Werte für Einstellungen festgelegt haben, werden diese möglicherweise mit EKS Amazon-Standardwerten überschrieben. Wenn Sie diesen Wert auf ändernnone, EKS ändert Amazon den Wert aller Einstellungen nicht, aber das Update schlägt möglicherweise fehl. Wenn das Update fehlschlägt, erhalten Sie eine Fehlermeldung, die Sie bei der Behebung des Konflikts unterstützt.

     cat >update-addon.yaml <<EOF
     apiVersion: eksctl.io/v1alpha5
     kind: ClusterConfig
     metadata:
       name: my-cluster
       region: region-code
     
     addons:
     - name: vpc-cni
       version: latest
       serviceAccountRoleARN: arn:aws:iam::111122223333:role/role-name
       resolveConflicts: preserve
     EOF
     

2. Führen Sie den bearbeiteten Befehl aus, um die update-addon.yaml-Datei zu erstellen.

3. Wenden Sie die Konfigurationsdatei auf Ihren Cluster an.

   eksctl update addon -f update-addon.yaml
   

Weitere Informationen zum Aktualisieren von Add-Ons finden Sie in der eksctl Dokumentation unter Aktualisieren von Addons.

Öffnen Sie die EKS Amazon-Konsole unter https://console.aws.amazon.com/eks/home#/clusters.

Wählen Sie im linken Navigationsbereich die Option Cluster aus.

Wählen Sie den Namen des Clusters, für den Sie das Add-on aktualisieren möchten.

Wählen Sie die Registerkarte Add-ons.

Wählen Sie das Add-on aus, das Sie aktualisieren möchten.

Wählen Sie Edit (Bearbeiten) aus.

Auf der Seite Configure name of addonGehen Sie auf der Seite wie folgt vor:

1. Wählen Sie die Version, die Sie verwenden möchten. Das Add-On verfügt möglicherweise über eine empfohlene Version. Weitere Informationen finden Sie in der Dokumentation für das Add-on, das Sie aktualisieren.

2. Für IAMRolle auswählen können Sie die IAM Rolle des Knotens (Nicht festgelegt) oder eine vorhandene Rolle verwenden, die Sie für die Verwendung mit dem Add-on erstellt haben. Wenn Sie keine Rolle auswählen können, verfügen Sie über keine vorhandene Rolle. Unabhängig davon, für welche Option Sie sich entscheiden, finden Sie in der Dokumentation zu dem Add-on, das Sie erstellen, Informationen zum Erstellen einer IAM Richtlinie und zum Anhängen dieser Richtlinie an eine Rolle. Für die Auswahl einer IAM Rolle benötigen Sie eine IAM OpenID Connect (OIDC) Anbieter für Ihren Cluster. Um festzustellen, ob Sie über einen solchen für Ihren Cluster verfügen, oder um einen zu erstellen, lesen Sie Erstelle eine IAM OIDC Anbieter für Ihren Cluster.

3. Erweitern Sie Optionale Konfigurationseinstellungen.

4. Geben Sie im Feld Konfigurationswerte alle zusätzlichen spezifischen Konfigurationsinformationen ein. Weitere Informationen finden Sie in der Dokumentation für das Add-on, das Sie aktualisieren.

5. Wählen Sie für die Conflict resolution method (Methode zur Konfliktlösung) eine der Optionen aus. Wenn Sie benutzerdefinierte Werte für Add-On-Einstellungen festgelegt haben, empfehlen wir die Option Preserve (Beibehalten). Wenn Sie diese Option nicht wählen, EKS überschreibt Amazon Ihre Werte mit den Standardwerten. Wenn Sie diese Option verwenden, empfehlen wir, dass Sie alle Feld- und Wertänderungen auf einem Nicht-Produktionscluster testen, bevor Sie das Add-on auf Ihrem Produktionscluster aktualisieren.

Wählen Sie Änderungen speichern.

Hier finden Sie eine Liste der installierten Add-Ons. Ersetzen Sie my-cluster mit dem Namen Ihres Clusters.

aws eks list-addons --cluster-name my-cluster

Eine Beispielausgabe sieht wie folgt aus.

{
    "addons": [
        "coredns",
        "kube-proxy",
        "vpc-cni"
    ]
}

Zeigen Sie die aktuelle Version des Add-Ons an, die Sie aktualisieren möchten. Ersetzen Sie my-cluster mit Ihrem Clusternamen und vpc-cni mit dem Namen des Add-Ons, das Sie aktualisieren möchten.

aws eks describe-addon --cluster-name my-cluster --addon-name vpc-cni --query "addon.addonVersion" --output text

Eine Beispielausgabe sieht wie folgt aus.

v1.10.4-eksbuild.1

Bestimmen Sie, welche Versionen des -Add-ons für die Version Ihres Clusters verfügbar sind. Ersetzen Sie 1.31 mit Ihrer Cluster-Version und vpc-cni mit dem Namen des Add-Ons, das Sie aktualisieren möchten.

aws eks describe-addon-versions --kubernetes-version 1.31 --addon-name vpc-cni \
    --query 'addons[].addonVersions[].{Version: addonVersion, Defaultversion: compatibilities[0].defaultVersion}' --output table

Eine Beispielausgabe sieht wie folgt aus.

------------------------------------------
|          DescribeAddonVersions         |
+-----------------+----------------------+
| Defaultversion  |       Version        |
+-----------------+----------------------+
|  False          |  v1.12.0-eksbuild.1  |
|  True           |  v1.11.4-eksbuild.1  |
|  False          |  v1.10.4-eksbuild.1  |
|  False          |  v1.9.3-eksbuild.1   |
+-----------------+----------------------+

Die Version True in der Defaultversion-Spalte ist standardmäßig die Version, mit der das Add-On erstellt wurde.

Aktualisieren Sie Ihr Add-on. Kopieren Sie den folgenden Befehl auf Ihr Gerät. Nehmen Sie bei Bedarf die folgenden Änderungen am Befehl vor, und führen Sie dann den geänderten Befehl aus. Weitere Informationen zu diesem Befehl finden Sie update-addonin der Amazon EKS Command Line Reference.

aws eks update-addon --cluster-name my-cluster --addon-name vpc-cni --addon-version version-number \
    --service-account-role-arn arn:aws:iam::111122223333:role/role-name --configuration-values '{}' --resolve-conflicts PRESERVE

Überprüfen Sie den Status des Updates. Ersetzen Sie my-cluster mit Ihrem Clusternamen und vpc-cni mit dem Namen des Add-Ons, das Sie aktualisieren möchten.

aws eks describe-addon --cluster-name my-cluster --addon-name vpc-cni

Eine Beispielausgabe sieht wie folgt aus.

{
    "addon": {
        "addonName": "vpc-cni",
        "clusterName": "my-cluster",
        "status": "UPDATING",
[...]

Das Update ist abgeschlossen, wenn der Status ACTIVE ist.