Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Ressources
Config Connector comprend un ensemble de définitions de ressources personnalisées (CRD, Custom Resource Definitions). Chaque CRD vous permet de configurer une ressource Google Cloudà partir de Kubernetes. Config Connector vous permet également de tirer parti d'un certain nombre de fonctionnalités Kubernetes pour gérer les ressources Google Cloud .
Cette page explique comment Config Connector utilise les objets Kubernetes et leurs métadonnées.
Objets Kubernetes et ressources de Config Connector
Par exemple, lorsque vous créez un objet Kubernetes de kind: SQLInstance, Config Connector crée une instance Cloud SQL.
Cette section décrit comment Config Connector étend les types d'objets.
Le champ spec contient tous les champs qui définissent l'état souhaité d'un objet, à l'exception de Labels. Les sous-champs d'un spec font référence à la ressource Google Cloud associée. Lorsque vous modifiez un sous-champ, la valeur de la ressource Google Cloud est éventuellement cohérente avec la valeur souhaitée.
Un exemple de champ accessible en écriture est databaseVersion dans une ressource d'instance SQL.
État
Le champ status est en lecture seule et contient l'état actuel de votre objet.
Config Connector lit périodiquement des informations sur votre ressource Google Cloudet met à jour le status. Vous pouvez vérifier les messages d'erreur ou l'aptitude d'une ressource en consultant le champ Status.Condition.
Un exemple de champ status en lecture seule est le connectionName d'une ressource d'instance SQL.
Métadonnées des objets
Chaque ressource Config Connector comprend un champ de métadonnées. Cette section décrit comment Config Connector utilise les sous-champs dans les métadonnées.
Nom
Nom d'une ressource Config Connector. Ce nom doit suivre la convention d'attribution de noms d'un nom d'objet Kubernetes. Il est utilisé par défaut comme nom de la ressource Google Cloud correspondante. Si le champ resourceID est compatible avec la ressource Config Connector, vous pouvez spécifier un nom différent, qui suit la convention d'attribution de noms de la ressource Google Cloud, pour la ressource Google Cloud correspondante dans le champ spec.resourceID. Pour en savoir plus, consultez la section Gérer les ressources avec le champ resourceID.
Espace de noms
L'espace de noms dans lequel vous créez une ressource Config Connector détermine le projet qui contient la ressource. Google Cloud Pour en savoir plus sur les espaces de noms, consultez la page Espaces de noms et Google Cloud projets Kubernetes.
Étiquettes
Les libellés du champ de métadonnées d'une ressource Config Connector sont également ajoutés à la ressource Google Cloud associée.
De plus, Config Connector ajoute un libellé système nommé managed-by-cnrm avec une valeur de true à vos Google Cloud ressources.
Annotations
Config Connector peut effectuer des actions supplémentaires sur vos ressources qui ne sont pas définies dans le spec. Ces actions sont définies dans les sous-champs de metadata.annotations. Les valeurs d'annotation doivent être une chaîne.
Les types d'annotations compatibles avec Config Connector sont décrits dans la section Annotations.
Dossiers et ressources hiérarchiques
En plus de la gestion des ressources dans les Google Cloud produits, Config Connector permet de créer et de gérer des ressources dans lesGoogle Cloud dossiers et organisations.
Pour en savoir plus, consultez la section Espaces de noms et projets.
L'aptitude que Config Connector met à disposition dans status.condition a un double objectif :
Indiquer quand une ressource est prête. Lorsqu'une ressource est réconciliée et prête, son status.condition.status est défini sur True. Pour vérifier si une ressource est prête, consultez la section Vérifier si une ressource est prête.
Afficher des informations ou des erreurs supplémentaires. L'aptitude comporte des champs Message et Reason qui fournissent des informations supplémentaires sur l'état de la ressource.
Événements
Les changements d'état importants des ressources Config Connector sont visibles en tant qu'événements Kubernetes. Pour en savoir plus, consultez la section Afficher des événements.
Découvrez les ressources que Config Connector configure.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/04 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 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."]]
