Organízate con las colecciones
Guarda y clasifica el contenido según tus preferencias.
Recursos
Config Connector incluye una colección de definiciones de recursos personalizados (CRDs). Cada CRD te permite configurar un Google Cloud
recurso de Kubernetes. Config Connector también te permite aprovechar una serie de funciones de Kubernetes para gestionar recursos Google Cloud .
En esta página se explica cómo usa Config Connector los objetos de Kubernetes y sus metadatos.
Objetos de Kubernetes y recursos de Config Connector
Por ejemplo, cuando creas un objeto de Kubernetes de kind: SQLInstance, Config Connector crea una instancia de Cloud SQL.
En esta sección se describe cómo amplía Config Connector los tipos de objetos.
El campo spec contiene todos los campos que definen el estado deseado de un objeto, excepto Labels. Los subcampos de un spec
hacen referencia al recurso Google Cloud asociado. Cuando cambias un subcampo, el valor del recurso se actualiza de forma coherente con el valor que has indicado. Google Cloud
Un ejemplo de campo editable es databaseVersion en un recurso SQLInstance.
Estado
El campo status es de solo lectura y contiene el estado actual del objeto.
Config Connector lee periódicamente información sobre tu Google Cloud
recurso y actualiza el status. Para comprobar los mensajes de error o la disponibilidad de un recurso, consulta el Status.Condition.
Un ejemplo de campo de solo lectura status es el connectionName de un recurso SQLInstance.
Metadatos del objeto
Cada recurso de Config Connector incluye un campo metadata. En esta sección se describe cómo usa Config Connector los subcampos de los metadatos.
Nombre
Nombre de un recurso de Config Connector. Debe seguir la convención de nomenclatura de un nombre de objeto de Kubernetes. Se usa de forma predeterminada como nombre del recurso Google Cloud correspondiente. Si el campo resourceID se admite en el recurso de Config Connector, puedes especificar otro nombre, que siga la convención de nomenclatura del recurso Google Cloud, para el recurso Google Cloud correspondiente en el campo spec.resourceID. Para obtener más información, consulta el artículo sobre cómo gestionar recursos con el campo resourceID
.
Espacio de nombres
El espacio de nombres en el que creas un recurso de Config Connector determina el proyecto que contiene el recurso. Google Cloud Para obtener más información sobre los espacios de nombres, consulta Espacios de nombres de Kubernetes y proyectos Google Cloud .
Etiquetas
Las etiquetas del campo de metadatos de un recurso de Config Connector también se añaden al recurso Google Cloud asociado.
Además, Config Connector añade una etiqueta de sistema llamada managed-by-cnrm
con el valor true a tus recursos de Google Cloud .
Anotaciones
Config Connector puede realizar acciones adicionales en tus recursos que no estén definidas en el spec. Estas acciones se definen en subcampos de metadata.annotations. Los valores de las anotaciones deben ser cadenas.
Los tipos de anotaciones que admite Config Connector se describen en anotaciones.
Carpetas y recursos jerárquicos
Además de gestionar recursos en productos de Google Cloud , Config Connector permite crear y gestionar recursos enGoogle Cloud carpetas y organizaciones.
Para obtener más información, consulta Espacios de nombres y proyectos.
Usar RBAC para el control de acceso
El control de acceso basado en roles (RBAC) de Kubernetes protege tus recursos. Puedes controlar la creación de recursos de Google Cloud
asignando permisos de control de acceso basado en roles. Para obtener más información, consulta el artículo sobre cómo proteger el acceso a los recursos.
Status Condition
Config Connector usa una condición de preparado en status.condition con dos fines:
que indica cuándo está listo un recurso. Cuando un recurso se reconcilia y está listo, su status.condition.status se define como True. Para comprobar cuándo está listo un recurso, consulta Esperar a que los recursos estén listos.
Se muestra información o errores adicionales. La condición ready tiene los campos Message y Reason, que proporcionan información adicional sobre el estado del recurso.
Eventos
Los cambios de estado importantes de los recursos de Config Connector se muestran como eventos de Kubernetes. Para obtener más información, consulta Ver eventos.
[[["Es fácil de entender","easyToUnderstand","thumb-up"],["Me ofreció una solución al problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Es difícil de entender","hardToUnderstand","thumb-down"],["La información o el código de muestra no son correctos","incorrectInformationOrSampleCode","thumb-down"],["Me faltan las muestras o la información que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-08-21 (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."]]
