Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Risorse
Config Connector include una raccolta di
definizioni di risorse personalizzate
(CRD). Ogni CRD consente di configurare una Google Cloud
risorsa da Kubernetes. Config Connector ti consente inoltre di sfruttare una serie di funzionalità di Kubernetes per la gestione delle risorse. Google Cloud
Questa pagina illustra come Config Connector utilizza gli oggetti Kubernetes e i relativi metadati.
Risorse di Config Connector e oggetti Kubernetes
Ad esempio, quando crei un
oggetto Kubernetes
di kind: SQLInstance, Config Connector crea un'istanza Cloud SQL.
Questa sezione descrive in che modo Config Connector estende i tipi di oggetti.
Il campo spec contiene tutti i campi che definiscono lo stato preferito di un oggetto, ad eccezione di Labels. I campi secondari di un spec
si riferiscono alla risorsa Google Cloud associata. Quando modifichi un
Google Cloud campo secondario, il valore della risorsa è
eventualmente coerente con il valore previsto.
Un esempio di campo modificabile è databaseVersion in una risorsa SQLInstance.
Stato
Il campo status è di sola lettura e contiene lo stato corrente dell'oggetto.
Config Connector legge periodicamente le informazioni sulla tua Google Cloud
risorsa e aggiorna il status. Puoi controllare i messaggi di errore o l'idoneità di una risorsa consultando Status.Condition.
Un esempio di campo status di sola lettura è connectionName di una risorsa SQLInstance.
Metadati degli oggetti
Ogni risorsa Config Connector include un campo metadata. Questa sezione descrive come Config Connector utilizza i campi secondari all'interno
degli elementi metadati.
Nome
Il nome di una risorsa Config Connector. Deve rispettare la
convenzione di denominazione
di un nome di oggetto Kubernetes. Viene utilizzato per impostazione predefinita come nome della Google Cloud risorsa corrispondente. Se il campo resourceID è supportato nella risorsa Config Connector, puoi specificare un nome diverso, che segua la convenzione di denominazione della risorsa Google Cloud, per la risorsa Google Cloud corrispondente nel campo spec.resourceID. Per ulteriori informazioni, consulta
Gestire le risorse con il campo resourceID.
Spazio dei nomi
Lo spazio dei nomi in cui crei una risorsa Config Connector determina il progetto che contiene la risorsa. Google Cloud Per saperne di più sugli spazi dei nomi, consulta Spazi dei nomi e progetti Google Cloud Kubernetes.
Etichette
Le etichette nel campo dei metadati di una risorsa Config Connector vengono aggiunte anche alla risorsa Google Cloud associata.
Inoltre, Config Connector aggiunge alle risorse un'etichetta di sistema denominata managed-by-cnrm con un valore true.
Google Cloud
Annotazioni
Config Connector può eseguire azioni aggiuntive sulle risorse che non sono definite in spec. Queste azioni sono definite nei campi secondari di
metadata.annotations. I valori delle annotazioni devono essere una stringa.
I tipi di annotazioni supportati da Config Connector sono descritti in annotations.
Cartelle e risorse gerarchiche
Oltre a gestire le risorse nei Google Cloud prodotti,
Config Connector supporta la creazione e la gestione delle risorse all'interno di
Google Cloud cartelle e organizzazioni.
Per ulteriori informazioni, consulta Spazi dei nomi e progetti.
Config Connector utilizza una condizione di disponibilità in
status.condition per due scopi:
che indica quando una risorsa è pronta. Quando una risorsa è riconciliata e pronta, il relativo status.condition.status viene impostato su True. Per controllare quando
una risorsa è pronta, consulta In attesa del completamento delle risorse
visualizzando un errore o informazioni aggiuntive. La condizione di stato attivo
ha i campi Message e Reason che forniscono informazioni aggiuntive sullo stato della risorsa.
Eventi
Le modifiche importanti dello stato delle risorse di Config Connector sono visibili come eventi Kubernetes. Per ulteriori informazioni, consulta
Visualizzare gli eventi.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-09-04 UTC."],[[["\u003cp\u003eConfig Connector allows the configuration of Google Cloud resources using Kubernetes Custom Resource Definitions (CRDs), extending Kubernetes capabilities.\u003c/p\u003e\n"],["\u003cp\u003eEach Config Connector resource includes a \u003ccode\u003espec\u003c/code\u003e field, defining the desired state of the object, and a read-only \u003ccode\u003estatus\u003c/code\u003e field, reflecting the current state as observed in Google Cloud.\u003c/p\u003e\n"],["\u003cp\u003eConfig Connector resources utilize Kubernetes object metadata, including names, namespaces, and labels, with labels being mirrored to the associated Google Cloud resource.\u003c/p\u003e\n"],["\u003cp\u003eConfig Connector supports \u003ccode\u003emetadata.annotations\u003c/code\u003e, which allows users to define actions not within \u003ccode\u003espec\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eConfig connector displays error information and if the resource is ready through \u003ccode\u003estatus.condition\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Resources\n=========\n\n*** ** * ** ***\n\nConfig Connector includes a collection of\n[Custom Resource Definitions](https://kubernetes.io/docs/concepts/extend-kubernetes/api-extension/custom-resources/)\n(CRDs). Each CRD allows you to configure a Google Cloud\nresource from Kubernetes. Config Connector also allows you to leverage a number\nof Kubernetes features for managing Google Cloud resources.\n\nThis page introduces you to how Config Connector uses Kubernetes objects and\ntheir metadata.\n\nKubernetes objects and Config Connector resources\n-------------------------------------------------\n\nFor example, when you create a\n[Kubernetes Object](https://kubernetes.io/docs/concepts/overview/working-with-objects/kubernetes-objects/)\nof `kind: SQLInstance`, Config Connector creates a Cloud SQL Instance.\nThis section describes how Config Connector extends object types.\n\n### Spec and Status\n\nEach Config Connector resource is a\n[Kubernetes object](https://kubernetes.io/docs/concepts/overview/working-with-objects/kubernetes-objects/)\nwith a\n[`Spec` and a `Status`](https://kubernetes.io/docs/concepts/overview/working-with-objects/kubernetes-objects/#object-spec-and-status).\n\nSpec\n: The `spec` field contains all the fields that define an object's desired\n state, with the exception of [`Labels`](#labels). The subfields of a `spec`\n refer to the associated Google Cloud resource. When you change a\n subfield, the Google Cloud resource's value is\n [eventually consistent](#declarative_configuration_and_eventual_consistency) with your intended value.\n: An example of a writable field is `databaseVersion` in a SQLInstance\n resource.\n\nStatus\n: The `status` field is read-only and contains the current state of your object.\n Config Connector periodically reads information on your Google Cloud\n resource and updates the `status`. You can check a resource's error messages\n or readiness by looking at the [`Status.Condition`](#status_condition).\n: An example read-only `status` field is the `connectionName` of a\n SQLInstance resource.\n\nObject metadata\n---------------\n\nEach Config Connector resource includes a\n[metadata](https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations/#attaching-metadata-to-objects)\nfield. This section describes how Config Connector uses subfields within\nmetadata.\n\nName\n: The name of a Config Connector resource. It should follow the\n [naming convention](https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#dns-subdomain-names)\n of a Kubernetes object name. It is used by default as the name of the\n corresponding Google Cloud resource. If the `resourceID` field is\n supported in the Config Connector resource, you can specify a different\n name, which follows the naming convention of the Google Cloud\n resource, for the corresponding Google Cloud resource in the\n `spec.resourceID` field. For more information, see\n [Managing resources with the `resourceID` field](/config-connector/docs/how-to/managing-resources-with-resource-ids).\n\nNamespace\n: The namespace you create a Config Connector resource in determines the\n project that contains the Google Cloud resource. For more on\n namespaces, see\n [Kubernetes Namespaces and Google Cloud Projects](/config-connector/docs/concepts/namespaces-and-projects).\n\nLabels\n: Labels in the metadata field of a Config Connector resource are also added\n to the associated Google Cloud resource.\n: In addition, Config Connector adds a system label named `managed-by-cnrm`\n with a value of `true` to your Google Cloud resources.\n\nAnnotations\n: Config Connector can take additional actions on your resources that are\n not defined in the `spec`. These actions are defined in subfields of\n `metadata.annotations`. Annotation values *must* be a string.\n The types of annotations Config Connector supports\n are described in [annotations](/config-connector/docs/reference/annotations).\n\nFolders and hierarchical resources\n----------------------------------\n\nIn addition to managing resources in Google Cloud products,\nConfig Connector supports creating and managing resources within\nGoogle Cloud [Folders and Organizations](/resource-manager/docs/creating-managing-folders).\nFor more information, see [Namespaces and projects](/config-connector/docs/concepts/namespaces-and-projects).\n\nUsing RBAC for Access Control\n-----------------------------\n\nKubernetes\n[Role Based Access Control](https://kubernetes.io/docs/reference/access-authn-authz/rbac/)\n(RBAC) secures your resources. You can control creation of Google Cloud\nresources by assigning RBAC permissions. For more information, see\n[Securing access to resources](/config-connector/docs/how-to/securing-access-to-resources).\n\nStatus Condition\n----------------\n\nConfig Connector uses a ready condition in\n[`status.condition`](https://dev.to/maelvls/what-the-heck-are-kubernetes-conditions-for-4je7) for two purposes:\n\n- indicating when a resource is ready. When a resource is reconciled and ready, its `status.condition.status` will be set to `True`. To check when a resource is ready, see [Waiting for resources to be ready](/config-connector/docs/how-to/monitoring-your-resources#waiting_for_resources_to_be_ready)\n- displaying additional error or information. The ready condition has `Message` and `Reason` fields which provide additional information on the resource's status.\n\nEvents\n------\n\nImportant status changes for Config Connector resources are visible as\nKubernetes events. For more information, see\n[Viewing events](/config-connector/docs/how-to/monitoring-your-resources#viewing_events_for_a_single_resource).\n\nDeclarative configuration and eventual consistency\n--------------------------------------------------\n\nSee [Reconciliation](/config-connector/docs/concepts/reconciliation).\n\nWhat's next\n-----------\n\n- [Get started with Config Connector](/config-connector/docs/how-to/getting-started)\n- Learn about the [Resources](/config-connector/docs/reference/resources) that Config Connector configures."]]
