Config Connector enthält eine Sammlung von benutzerdefinierten Ressourcendefinitionen. Mit jeder CRD können Sie eine Google Cloud-Ressource von Kubernetes aus konfigurieren. Mit Config Connector können Sie auch eine Reihe von Kubernetes-Features für die Verwaltung von Google Cloud-Ressourcen nutzen.
Auf dieser Seite erfahren Sie, wie Config Connector Kubernetes-Objekte und ihre Metadaten verwendet.
Kubernetes-Objekte und Config Connector-Ressourcen
Wenn Sie beispielsweise ein Kubernetes-Objekt von kind: SQLInstance
erstellen, erstellt Config Connector eine Cloud SQL-Instanz.
In diesem Abschnitt wird beschrieben, wie Config Connector Objekttypen erweitert.
Spezifikation und Status
Jede Config Connector-Ressource ist ein Kubernetes-Objekt mit einem Spec
und einem Status
.
- Spezifikation
- Das Feld
spec
enthält alle Felder, die den gewünschten Status definieren, mit Ausnahme vonLabels
. Die Unterfelder einerspec
beziehen sich auf die zugehörige Google Cloud-Ressource. Wenn Sie ein Unterfeld ändern, entspricht der Wert der Google Cloud-Ressource dem Ende nach dem gewünschten Wert. - Ein beschreibbares Feld ist beispielsweise
databaseVersion
in einer SQL-Instanzressource. - Status
- Das Feld
status
ist schreibgeschützt und enthält den aktuellen Status des Objekts. Config Connector liest regelmäßig Informationen zu Ihrer Google Cloud-Ressource und aktualisiert diestatus
. Sie können die Fehlermeldungen oder Bereitschaft einer Ressource unterStatus.Condition
prüfen. - Das schreibgeschützte Feld
status
ist dieconnectionName
einer SQL-Instanz.
Objektmetadaten
Jede Config Connector-Ressource enthält ein Metadatenfeld. In diesem Abschnitt wird beschrieben, wie Config Connector untergeordnete Felder in Metadaten verwendet.
- Name
- Der Name einer Config Connector-Ressource. Es sollte der Namenskonvention eines Kubernetes-Objektnamens entsprechen. Er wird standardmäßig als Name der entsprechenden Google Cloud-Ressource verwendet. Wenn das Feld
resourceID
in der Config Connector-Ressource unterstützt wird, können Sie für die entsprechende Google Cloud-Ressource im Feldspec.resourceID
einen anderen Namen angeben, der der Namenskonvention der Google Cloud-Ressource folgt. Weitere Informationen finden Sie unter Ressourcen mit dem FeldresourceID
verwalten. - Namespace
- Der Namespace, in dem Sie eine Config Connector-Ressource erstellen, bestimmt das Projekt, das die Google Cloud-Ressource enthält. Weitere Informationen zu Namespaces finden Sie unter Kubernetes-Namespaces und Google Cloud-Projekte.
- Etiketten
- Labels im Metadatenfeld einer Config Connector-Ressource werden der zugehörigen Google Cloud-Ressource ebenfalls hinzugefügt.
- Außerdem fügt Config Connector Ihren Google Cloud-Ressourcen das Systemlabel
managed-by-cnrm
mit dem Werttrue
hinzu. - Anmerkungen
- Config Connector kann zusätzliche Aktionen für Ihre Ressourcen ausführen, die nicht im
spec
definiert sind. Diese Aktionen werden in Unterfeldern vonmetadata.annotations
definiert. Anmerkungswerte müssen ein String sein. Die Arten von Annotationen, die von Config Connector unterstützt werden, finden Sie unter Annotationen.
Ordner und hierarchische Ressourcen
Neben der Verwaltung von Ressourcen in Google Cloud-Produkten unterstützt Config Connector das Erstellen und Verwalten von Ressourcen in Ordnern und Organisationen von Google Cloud. Weitere Informationen finden Sie unter Namespaces und Projekte.
RBAC für die Zugriffssteuerung verwenden
Die rollenbasierte Zugriffssteuerung (Role-Based Access Control, RBAC) von Kubernetes schützt Ihre Ressourcen. Sie können die Erstellung von Google Cloud-Ressourcen durch Zuweisen von RBAC-Berechtigungen steuern. Weitere Informationen finden Sie unter Zugriff auf Ressourcen sichern.
Statusbedingung
Config Connector verwendet eine Bereit-Bedingung in status.condition
für zwei Zwecke:
- und gibt an, wann eine Ressource bereit ist. Wenn eine Ressource abgeglichen und bereit ist, wird ihre
status.condition.status
aufTrue
gesetzt. Informationen dazu, wie eine Ressource geprüft wird, finden Sie unter Auf Ressourcen warten. - mit zusätzlichen Fehlern oder Informationen. Die Bereit-Bedingung enthält die Felder
Message
undReason
, die zusätzliche Informationen zum Status der Ressource enthalten.
Veranstaltungen
Wichtige Statusänderungen für Config Connector-Ressourcen werden als Kubernetes-Ereignisse angezeigt. Weitere Informationen finden Sie unter Ereignisse ansehen.
Deklarative Konfiguration und Eventual Consistency
Siehe Abgleich.
Nächste Schritte
- Erste Schritte mit Config Connector
- Mehr über die von Config Connector konfigurierten Ressourcen erfahren