Kubernetes-Feldverwaltung

Amazon-EKS-Add-ons werden in Ihrem Cluster unter Verwendung von bewährten Standardkonfigurationen installiert. Weitere Informationen zum Hinzufügen eines Amazon-EKS-Add-ons zu Ihrem Cluster finden Sie unter Amazon-EKS-Add-ons.

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

Wichtig

Das Ändern eines von Amazon EKS verwalteten Felds verhindert, dass Amazon EKS das Add-on verwaltet und kann dazu führen, dass Ihre Änderungen überschrieben werden, wenn ein Add-on aktualisiert wird.

Status der Feldverwaltung anzeigen

Sie können kubectl verwenden, um zu sehen, welche Felder von Amazon EKS für ein Amazon EKS Add-on verwaltet werden.

Verwaltungsstatus eines Felds anzeigen

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 Anzeigen der Kubernetes-Ressourcen.

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.

Grundlegendes zur Feldverwaltungssyntax in der Kubernetes API

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 EKS verwaltet. Änderungen an einem beliebigen Wert verursachen einen Konflikt.

• Teilweise verwaltet – Einige Schlüssel für das Feld werden von Amazon EKS verwaltet. Nur Änderungen an den Schlüsseln, die explizit von Amazon EKS verwaltet werden, 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, wobei value der exakte JSON-formatierte Wert eines Listenelements ist.

• 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
  [...]