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.
Especificación y estado
Cada recurso de Config Connector es un objeto de Kubernetes con un Spec
y un Status
.
- Especificación
- El campo
spec
contiene todos los campos que definen el estado deseado de un objeto, exceptoLabels
. Los subcampos de unspec
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 elstatus
. Para comprobar los mensajes de error o la disponibilidad de un recurso, consulta elStatus.Condition
. - Un ejemplo de campo de solo lectura
status
es elconnectionName
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 campospec.resourceID
. Para obtener más información, consulta el artículo sobre cómo gestionar recursos con el camporesourceID
.
- 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 valortrue
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 demetadata.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 comoTrue
. 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
yReason
, 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.
Configuración declarativa y coherencia retardada
Consulta Conciliación.
Siguientes pasos
- Empezar a usar Config Connector
- Consulta información sobre los recursos que configura Config Connector.