Acerca de los CRD de Config Connector

Config Connector incluye una colección de definiciones de recursos personalizados (CRD). Cada CRD te permite configurar un recurso Google Cloudde Kubernetes. Config Connector también te permite usar varias funciones de Kubernetes para administrar recursos de Google Cloud .

En esta página, se presenta cómo Config Connector usa 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 Config Connector extiende los tipos de objeto.

Especificación y estado

Cada recurso de Config Connector es un objeto de Kubernetes con un Spec y un Status.

Spec
El campo spec contiene todos los campos que definen el estado deseado de un objeto. Los subcampos de un spec hacen referencia al recurso Google Cloud asociado. Cuando cambias un subcampo, el valor del recurso Google Cloud escoherente con el tiempo con el valor que deseas.
Un ejemplo de un campo de escritura es databaseVersion en un recurso de SQLInstance.
En el caso de los recursos de Config Connector con spec.labels, las etiquetas configuradas en el campo spec.labels del recurso de Config Connector se aplicarán al recurso Google Cloud asociado. Para obtener más información, consulta Administra etiquetas.
Estado
El campo status es de solo lectura y contiene el estado actual del objeto. Config Connector lee periódicamente la información de tu recurso de Google Cloudy actualiza el status. Puedes verificar los mensajes de error o la preparación de un recurso consultando Status.Condition.
Un ejemplo de campo status de solo lectura es el connectionName de un recurso de SQLInstance.

Metadatos de objeto

Cada recurso de Config Connector incluye un campo metadata. En esta sección, se describe cómo Config Connector usa subcampos dentro de los metadatos.

Nombre
El 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 el nombre del recurso Google Cloud correspondiente. Si el campo resourceID es compatible con el recurso de Config Connector, puedes especificar un nombre diferente, 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 Administra 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 y Google Cloud proyectos de Kubernetes.
Etiquetas
Según el recurso, las etiquetas del campo metadata.labels de un recurso de Config Connector se pueden aplicar al recurso Google Cloudasociado. Para obtener más información, consulta Administra etiquetas.
Config Connector agrega una etiqueta del sistema llamada managed-by-cnrm con un valor de true a los recursos Google Cloud que admiten etiquetas.
Anotaciones
Config Connector puede realizar acciones adicionales en tus recursos que no se definen en spec. Estas acciones se definen en subcampos de metadata.annotations. Los valores de anotación deben ser una cadena. Los tipos de anotaciones que admite Config Connector se describen en anotaciones.

Administra etiquetas

En el caso de los recursos Google Cloud que admiten etiquetas, el lugar donde defines las etiquetas depende de si el recurso de Config Connector tiene un campo spec.labels:

  • Recursos con un campo spec.labels: Debes administrar las etiquetas en spec.labels. Las etiquetas especificadas por el usuario en este campo se aplican al recursoGoogle Cloud .
  • Recursos sin un campo spec.labels: Todas las etiquetas en metadata.labels, incluidas las etiquetas especificadas por el usuario y las etiquetas del sistema, se aplican al recurso Google Cloud .

Carpetas y recursos jerárquicos

Además de administrar recursos en productos de Google Cloud , Config Connector admite la creación y administración de recursos enGoogle Cloud carpetas y organizaciones. Para obtener más información, consulta Espacios de nombres y proyectos.

Usa 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 Cloudasignando permisos de RBAC. Para obtener más información, consulta Cómo proteger el acceso a los recursos.

Condición de estado

Config Connector usa una condición de preparación en status.condition con dos propósitos:

  • indicar cuándo está listo un recurso. Cuando un recurso está conciliado y listo, su status.condition.status se establecerá como True. Para verificar cuándo un recurso está listo, consulta Espera que los recursos estén listos
  • mostrar información o error adicional. La condición de preparación tiene los campos Message y Reason que proporcionan información adicional sobre el estado del recurso.

Eventos

Los cambios de estado importantes para los recursos de Config Connector son visibles como eventos de Kubernetes. Para obtener más información, consulta Ve los eventos.

Configuración declarativa y coherencia eventual

Consulta Conciliación.

¿Qué sigue?