Felder extern verwalten
Wenn Config Connector eine Ressource Google Clouderstellt, übernehmen Felder, die im Feld spec nicht
angegeben sind, Werte aus der API, es sei denn, sie sind nicht
lesbar, z. B. Felder, die mit einer HTTP-GET-Anfrage nicht verfügbar sind.
In diesem Fall wird das Feld als extern verwaltet betrachtet, da Kubernetes nicht die „Source of Truth“ für diesen Wert ist.
Verhalten mit serverseitigem Apply
Wenn serverseitiges Anwenden für die Ressource aktiviert ist, werden die Werte extern verwalteter Felder im Objekt kontinuierlich aktualisiert, um der zugrunde liegenden Google Cloud Ressource zu entsprechen.
Wenn ein Feld im Abschnitt spec der angewendeten Konfiguration einen Wert hat, wird das Feld nicht extern verwaltet.
Ist das Feld entfernt, wird das Feld extern verwaltet.
Verhalten ohne serverseitiges Apply
Wenn serverseitiges Anwenden nicht aktiviert ist und die Ressource das Merge Ausfüllverhalten verwendet, füllt Config Connector nicht angegebene Felder im Feld spec der Ressource mit dem Wert aus, der aus der Google Cloud API gelesen wurde, und erzwingt diese anfänglich ausgefüllten Werte.
Angenommen, Sie wenden eine Ressourcenkonfiguration an, ohne einen Wert für das Feld field2 im Abschnitt spec festzulegen:
spec:
field1: "value-1"
Wenn der Wert des field2 Felds "api-value-1" in der Google Cloud
API ist, wird die Ressource im
API-Server
mit diesem Wert ausgefüllt:
# object in the api-server
spec:
field1: "value-1"
field2: "api-value-1" # populated by first reconciliation
Wenn die Google Cloud Ressource direkt geändert wird, sodass das field2
Feld jetzt "api-value-2" ist, setzt Config Connector die Google Cloud
Ressource auf den Wert zurück, der ursprünglich im Feld spec der Ressource ausgefüllt wurde
("api-value-1"):
# object in the api-server
spec:
field1: "value-1"
# still the originally populated value; overrides the external value
field2: "api-value-1"
Verhalten für Listenfelder in der Ressourcenspezifikation
Aufgrund einer technischen Einschränkung in Config Connector können Listenfelder in Ihrer Ressourcenkonfiguration standardmäßig nicht extern verwaltet werden, wenn die Ressource das Ausfüllverhalten Merge verwendet. Aufgrund dieser Einschränkung übernimmt Config Connector die Inhaberschaft von Listenfeldern im Feld spec der Ressource, auch wenn Sie das Feld in Ihrer ursprünglichen Ressourcenkonfiguration nicht angeben.
Wenn Sie ein Feld spec der Ressource anwenden, liest Config Connector den Wert der
Listenfelder aus der Google Cloud API und behandelt diesen Anfangswert als
„Source of Truth“ und Zielstatus. Wenn sich der Wert in diesem Listenfeld außerhalb von Config Connector ändert, versucht Config Connector, die Änderung rückgängig zu machen, was möglicherweise nicht beabsichtigt ist.
Um diese Einschränkung zu umgehen und Listenfelder extern verwalten zu lassen, verwenden Sie die
cnrm.cloud.google.com/state-into-spec: absent Annotation, um nicht angegebene Felder zu
ignorieren.
Der Wert dieser Annotation ist standardmäßig auf absent für neu erstellte Ressourcen in Config Connector Version 1.123.1 und höher festgelegt. Ob Ihre Ressource
die Annotation unterstützt, erfahren Sie auf der entsprechenden Ressourcenseite.
Fügen Sie die folgende Annotation in Ihr Ressourcenmanifest ein, um dieses Verhalten zu konfigurieren:
metadata:
annotations:
cnrm.cloud.google.com/state-into-spec: absent
Wenn Sie den Wert der Annotation state-into-spec auf absent setzen, ignoriert Config Connector Listenfelder, die in Ihrer Ressourcenkonfiguration nicht angegeben sind, damit sie extern verwaltet werden können.
Vorsichtsmaßnahmen
Felder, die von Config Connector verwaltet und automatisch von externen Diensten aktualisiert werden, können zu endlosen Aktualisierungen oder Abstimmungsfehlern in der zugrunde liegenden API führen. Diese Probleme können auftreten, wenn die zugrunde liegende Google CloudAPI Felder mit Autoscaling oder automatisch aktualisierten Feldern hat und Ihre Ressource die cnrm.cloud.google.com/state-into-spec: merge Annotation ohne serverseitiges Apply verwendet.
Wenn beispielsweise eine SQLInstance-Ressource die
cnrm.cloud.google.com/state-into-spec: merge Annotation verwendet, füllt Config Connector
das anfängliche Feld spec.maintenanceVersion der Instanz in das
Feld spec der Kubernetes-Ressource ein. Wenn Cloud SQL später eine
automatische Wartungsaktualisierung für die zugrunde liegende Instanz durchführt, versucht Config Connector,
die Instanz auf den älteren Wert spec.maintenanceVersion zurückzusetzen,
der im Feld spec gespeichert ist. Da Cloud SQL Downgrades der Wartungsversion ablehnt, schlägt die Abstimmung wiederholt mit einem UpdateFailed-Fehler fehl.
So lassen Sie automatisch aktualisierte Felder von externen Diensten verwalten:
- Lassen Sie das automatisch aktualisierte Feld in Ihrer YAML-Konfigurationsdatei weg, wenn Sie sie anwenden.
- Konfigurieren Sie die Ressource so, dass nicht angegebene Felder ignoriert werden. Führen Sie dazu einen der folgenden Schritte aus:
- Legen Sie die
cnrm.cloud.google.com/state-into-spec: absentAnnotation für die Ressource fest oder migrieren Sie die vorhandene Ressource vomMergeVerhalten zu demAbsentVerhalten. - Aktivieren Sie serverseitiges Apply für die Ressource.
- Legen Sie die