Ermitteln Sie Felder, die Sie für EKS Amazon-Add-Ons anpassen können

EKSAmazon-Add-Ons werden mithilfe von standardmäßigen Best-Practice-Konfigurationen in Ihrem Cluster installiert. Weitere Informationen zum Hinzufügen eines EKS Amazon-Add-ons zu Ihrem Cluster finden Sie unterEKSAmazon-Add-Ons.

Möglicherweise möchten Sie die Konfiguration eines EKS Amazon-Add-ons anpassen, um erweiterte Funktionen zu aktivieren. Amazon EKS verwendet die Kubernetes serverseitige Apply-Funktion, um die Verwaltung eines Add-ons durch Amazon zu ermöglichen, EKS ohne Ihre Konfiguration für Einstellungen zu überschreiben, die nicht von Amazon verwaltet werden. EKS Weitere Informationen finden Sie unter Server-side Apply? in der Kubernetes-Dokumentation. Um dies zu erreichen, EKS verwaltet Amazon eine Mindestanzahl von Feldern für jedes Add-on, das es installiert. Sie können alle Felder, die nicht von Amazon EKS oder einem anderen Prozess auf Kubernetes Steuerungsebene verwaltet werdenkube-controller-manager, problemlos ändern.

Wichtig

Wenn Sie ein von Amazon verwaltetes Feld ändernEKS, kann Amazon EKS das Add-on nicht verwalten. Dies kann dazu führen, dass Ihre Änderungen überschrieben werden, wenn ein Add-on aktualisiert wird.

Syntax für die Feldverwaltung

Wenn Sie Details für ein Kubernetes-Objekt anzeigen, werden sowohl verwaltete als auch nicht verwaltete Felder in der Ausgabe zurückgegeben. Verwaltete Felder können einer der folgenden Typen sein:

• Vollständig verwaltet — Alle Schlüssel für das Feld werden von Amazon verwaltetEKS. Änderungen an einem beliebigen Wert verursachen einen Konflikt.

• Teilweise verwaltet — Einige Schlüssel für das Feld werden von Amazon verwaltetEKS. Nur Änderungen an den Schlüsseln, die explizit von Amazon verwaltet werden, EKS verursachen einen Konflikt.

Beide Arten von Feldern sind gekennzeichnet mit manager: eks.

Jeder Schlüssel ist entweder ein ., welches das Feld darstellt, das immer einem leeren Satz zugeordnet wird, oder eine Zeichenfolge, die ein Unterfeld oder Element darstellt. Die Ausgabe für die Feldverwaltung besteht aus folgenden Angabetypen:

• f:name, wobei name der Name eines Feldes in einer Liste ist.

• k:keys, wobei keys eine Karte der Felder eines Listenelements ist.

• v:value, wo value ist der exakte JSON formatierte Wert eines Listenelements.

• i:index, wobei index die Position eines Elements in der Liste ist.

Die folgenden Ausgabeteile für das CoreDNS-Add-on veranschaulichen die vorherigen Angaben:

• Vollständig verwaltete Felder – Wenn ein verwaltetes Feld ein f: (Feld) festgelegt hat, aber keinen k: (Schlüssel), dann wird das gesamte Feld verwaltet. Änderungen an Werten in diesem Feld verursachen einen Konflikt.

  In der folgenden Ausgabe sehen Sie, dass der Container mit dem Namen coredns verwaltet von eks. Dieargs, image und imagePullPolicy Unterfelder werden auch verwaltet von eks. Änderungen an Werten in diesen Feldern verursachen einen Konflikt.

  [...]
  f:containers:
    k:{"name":"coredns"}:
    .: {}
    f:args: {}
    f:image: {}
    f:imagePullPolicy: {}
  [...]
  manager: eks
  [...]

• Teilweise verwaltete Felder – Wenn für einen verwalteten Schlüssel ein Wert angegeben ist, werden die angegebenen Schlüssel für dieses Feld verwaltet. Das Ändern der angegebenen Schlüssel führt zu einem Konflikt.

  In der folgenden Ausgabe sehen Sie, dass eks die config-volume und tmp Volumes verwaltet, welche mit dem name-Schlüssel eingestellt wurden.

  [...]
  f:volumes:
    k:{"name":"config-volume"}:
      .: {}
      f:configMap:
        f:items: {}
        f:name: {}
      f:name: {}
    k:{"name":"tmp"}:
      .: {}
      f:name: {}
  [...]
  manager: eks
  [...]

• Hinzufügen von Schlüsseln zu teilweise verwalteten Feldern – Wenn nur ein bestimmter Schlüsselwert verwaltet wird, können Sie sicher zusätzliche Schlüssel wie Argumente zu einem Feld hinzufügen, ohne einen Konflikt zu verursachen. Wenn Sie zusätzliche Schlüssel hinzufügen, stellen Sie sicher, dass das Feld nicht zuerst verwaltet wird. Das Hinzufügen oder Ändern eines verwalteten Werts verursacht einen Konflikt.

  In der folgenden Ausgabe sehen Sie, dass sowohl der Schlüssel name als auch das Feld name verwaltet werden. Das Hinzufügen oder Ändern eines Containernamens verursacht einen Konflikt mit diesem verwalteten Schlüssel.

  [...]
  f:containers:
    k:{"name":"coredns"}:
  [...]
      f:name: {}
  [...]
  manager: eks
  [...]

Verfahren

Sie können kubectl damit sehen, welche Felder von Amazon EKS für jedes EKS Amazon-Add-on verwaltet werden.

Sie können alle Felder, die nicht von Amazon EKS oder einem anderen Prozess auf Kubernetes Steuerungsebene verwaltet werdenkube-controller-manager, problemlos ändern.

1. Bestimmen Sie das Add-on, das Sie überprüfen möchten. Informationen zu allen deployments und DaemonSets, die in Ihrem Cluster bereitgestellt werden, finden Sie unter KubernetesRessourcen anzeigen in der AWS Management Console.

2. Führen Sie den folgenden Befehl aus, um die verwalteten Felder für ein Add-on anzuzeigen:

   kubectl get type/add-on-name -n add-on-namespace -o yaml
   

   Sie können beispielsweise die verwalteten Felder für das CoreDNS-Add-on mit dem folgenden Befehl sehen.

   kubectl get deployment/coredns -n kube-system -o yaml
   

   Die Feldverwaltung wird im folgenden Abschnitt in der zurückgegebenen Ausgabe aufgeführt.

   [...]
   managedFields:
     - apiVersion: apps/v1
       fieldsType: FieldsV1
       fieldsV1:                        
   [...]               

   Anmerkung

   Wenn managedFields in der Ausgabe nicht angezeigt wird, fügen Sie dem Befehl --show-managed-fields hinzu, und führen Sie ihn erneut aus. Die Version von kubectl, die Sie verwenden, bestimmt, ob verwaltete Felder standardmäßig zurückgegeben werden.

Nächste Schritte

Passen Sie die Felder an, die nicht AWS Ihrem Add-on gehören.