Recursos

Organízate con las colecciones Guarda y clasifica el contenido según tus preferencias.

Config Connector incluye una colección de definiciones de recursos personalizadas (CRD). Cada CRD te permite configurar un recurso de Google Cloud desde Kubernetes. Config Connector también te permite aprovechar una serie de funciones de Kubernetes para administrar los recursos de Google Cloud.

En esta página, se presenta cómo Config Connector usa 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 objetos.

Especificaciones y estado

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

Especificaciones
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 de Google Cloud asociado. Cuando cambias un subcampo, el valor de los recursos de Google Cloud tiene una coherencia eventual con el valor deseado.
Un ejemplo de un campo que admite escritura es databaseVersion en un recurso SQLInstance.
Estado
El campo status es de solo lectura y contiene el estado actual de tu objeto. Config Connector lee la información sobre tu recurso de Google Cloud de forma periódica y actualiza status. Puedes verificar la disponibilidad o los mensajes de error de un recurso si observas el Status.Condition.
Un campo de solo lectura status de ejemplo es el connectionName de un recurso de SQLInstance.

Metadatos de objeto

Cada recurso de Config Connector incluye un campo de metadatos. 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 asignación de nombres de un nombre de objeto de Kubernetes. Se usa de forma predeterminada como el nombre del recurso de Google Cloud correspondiente. Si el campo resourceID es compatible con el recurso de Config Connector, puedes especificar un nombre diferente, que sigue la convención de nomenclatura del recurso de Google Cloud, para el recurso de 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 de Google Cloud. Para obtener más información sobre los espacios de nombres, consulta Espacios de nombres de Kubernetes y proyectos de Google Cloud.
Etiquetas
Las etiquetas en el campo de metadatos de un recurso de Config Connector también se agregan al recurso de Google Cloud asociado.
Además, Config Connector agrega una etiqueta del sistema llamada managed-by-cnrm con un valor de true a tus recursos de Google Cloud.
Anotaciones
Config Connector puede realizar acciones adicionales en tus recursos que no están definidas en spec. Estas acciones se definen en los subcampos de metadata.annotations. Los valores de anotaciones deben ser una string. Los tipos de anotaciones que admite Config Connector se describen en las anotaciones.

Carpetas y recursos jerárquicos

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

Usa RBAC para control de acceso

El control de acceso según la función (RBAC) de Kubernetes protege tus recursos. Puedes controlar la creación de recursos de Google Cloud si asignas permisos RBAC. Para obtener más información, consulta Protege el acceso a los recursos.

Condición de estado

Config Connector usa una condición lista en status.condition para dos propósitos:

  • que indica cuándo un recurso está listo. Cuando un recurso se concilia y está listo, su status.condition.status se configurará como True. Para verificar cuándo un recurso está listo, consulta Espera a que los recursos estén listos.
  • Mostrar información o error adicional. La condición de lista 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 Visualiza eventos.

Configuración declarativa y coherencia eventual

Consulte Conciliación.

Próximos pasos