Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Recursos
O Config Connector inclui uma coleção de
definições de recursos personalizados
(CRDs). Cada CRD permite-lhe configurar um recurso do Kubernetes. Google CloudO Config Connector também lhe permite tirar partido de várias funcionalidades do Kubernetes para gerir recursos. Google Cloud
Esta página explica como o Config Connector usa objetos Kubernetes e
os respetivos metadados.
Objetos do Kubernetes e recursos do Config Connector
Por exemplo, quando cria um objeto Kubernetes de kind: SQLInstance, o Config Connector cria uma instância do Cloud SQL.
Esta secção descreve como o Config Connector expande os tipos de objetos.
O campo spec contém todos os campos que definem o estado pretendido de um objeto, com exceção de Labels. Os subcampos de um spec
referem-se ao recurso Google Cloud associado. Quando altera um subcampo, o valor do recurso é eventualmente consistente com o valor pretendido. Google Cloud
Um exemplo de um campo gravável é databaseVersion num recurso SQLInstance.
Estado
O campo status é só de leitura e contém o estado atual do seu objeto.
O Config Connector lê periodicamente informações sobre o seu Google Cloudrecurso e atualiza o status. Pode verificar as mensagens de erro de um recurso ou a respetiva disponibilidade consultando o Status.Condition.
Um exemplo de campo status só de leitura é o connectionName de um recurso SQLInstance.
Metadados do objeto
Cada recurso do Config Connector inclui um campo metadata. Esta secção descreve como o Config Connector usa subcampos nos
metadados.
Nome
O nome de um recurso do Config Connector. Deve seguir a convenção de nomenclatura de um nome de objeto do Kubernetes. É usado por predefinição como o nome do recurso Google Cloud correspondente. Se o campo resourceID for suportado no recurso Config Connector, pode especificar um nome diferente, que segue a convenção de nomenclatura do recurso Google Cloud, para o recurso Google Cloud correspondente no campo spec.resourceID. Para mais informações, consulte o artigo
Faça a gestão de recursos com o campo resourceID.
Espaço de nomes
O espaço de nomes no qual cria um recurso do Config Connector determina o projeto que contém o recurso. Google Cloud Para mais informações sobre os espaços de nomes, consulte os artigos Espaços de nomes do Kubernetes e Google Cloud Projetos.
Etiquetas
As etiquetas no campo de metadados de um recurso do Config Connector também são adicionadas
ao recurso Google Cloud associado.
Além disso, o Config Connector adiciona uma etiqueta do sistema denominada managed-by-cnrm
com um valor de true aos seus recursos Google Cloud .
Notas
O Config Connector pode realizar ações adicionais nos seus recursos que não estão definidos no spec. Estas ações são definidas em subcampos de
metadata.annotations. Os valores de anotação têm de ser uma string.
Os tipos de anotações suportados pelo Config Connector são descritos em anotações.
Pastas e recursos hierárquicos
Além de gerir recursos em Google Cloud produtos,
o Config Connector suporta a criação e a gestão de recursos emGoogle Cloud pastas e organizações.
Para mais informações, consulte o artigo Espaços de nomes e projetos.
O Config Connector usa uma condição ready em
status.condition para dois fins:
indicando quando um recurso está pronto. Quando um recurso é reconciliado e está pronto, o respetivo status.condition.status é definido como True. Para verificar quando
um recurso está pronto, consulte o artigo Aguardar que os recursos estejam prontos
Apresentar um erro ou informações adicionais. A condição ready tem campos Message e Reason que fornecem informações adicionais sobre o estado do recurso.
Eventos
As alterações importantes ao estado dos recursos do Config Connector são visíveis como eventos do Kubernetes. Para mais informações, consulte o artigo
Ver eventos.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 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."]]
