Prácticas recomendadas para Config Connector


En esta página, se explican las prácticas recomendadas que debes tener en cuenta cuando usas Config Connector.

Administra los límites de cuota de la API

Si encuentras errores que indican que excediste el límite de cuota de la API, podría deberse a que creaste demasiados recursos de Config Connector del mismo tipo en el mismo proyecto de cuota. Cuando creas muchos recursos, estos pueden generar demasiadas APIs de acceso al mismo extremo de API debido al estrategia de conciliación que usa Config Connector.

Una forma de resolver este problema es solicitar un aumento de la cuota. Además de una cuota de aumento si confirmaste que el error de cuota se debe a solicitudes GET en los recursos de Google Cloud que administra tu Config Connector recursos, puedes considerar una de las siguientes opciones:

Cómo aumentar el intervalo de conciliación

Puedes aumentar el tiempo que transcurre entre la conciliación de Config Connector de un recurso y la a evitar alcanzar las cuotas de las APIs. Se recomienda establecer el intervalo de conciliación en 1 hora.

Para aumentar el intervalo de conciliación, sigue los pasos que se indican en Cómo configurar el intervalo de conciliación.

Divide tus recursos en varios proyectos

Este enfoque distribuye tus recursos de Config Connector entre diferentes proyectos. Este enfoque funciona bien cuando se agregan recursos nuevos, pero puede Es arriesgado dividir los recursos existentes porque necesitas borrar y volver a crearlos en diferentes proyectos. Borrar recursos puede causar la pérdida de datos con algunos tipos de recursos, como SpannerInstance o BigtableTable recursos. Debes crear una copia de seguridad de tus datos antes de borrarlos.

Para dividir los recursos existentes de Config Connector en diferentes proyectos, completa sigue estos pasos:

  1. Decide qué recursos de Config Connector planeas mover a diferentes proyectos.
  2. Borra los recursos de Config Connector. Asegúrate de que la anotación cnrm.cloud.google.com/deletion-policy no esté configurada como abandon.
  3. Actualiza el campo spec.projectRef o la anotación cnrm.cloud.google.com/project-id en la configuración de YAML de los recursos de Config Connector que planeas trasladar a los proyectos nuevos.
  4. Otorga la cuenta de servicio de IAM que usa Config Connector de forma correcta permisos en los proyectos nuevos.
  5. Aplica la configuración de YAML actualizada para crear los recursos de Config Connector.

Cambia al modo con espacio de nombres

Puedes vincular diferentes cuentas de servicio de IAM que pertenezcan a diferentes Proyectos de Google Cloud en diferentes espacios de nombres en los que Config Connector está instalada en modo con espacio de nombres y dividir los recursos en diferentes espacios de nombres. Para lograrlo, completa los siguientes pasos:

  1. Configura Config Connector para que se ejecute en modo con espacio de nombres. Crea cuentas de servicio de IAM nuevas desde diferentes proyectos y vincúlalas a diferentes espacios de nombres siguiendo las instrucciones para configurar Config Connector para cada proyecto.

  2. Otorga los permisos adecuados a las nuevas cuentas de servicio de IAM para el proyecto que contiene los recursos.

  3. Decide qué recursos de Config Connector planeas mover a diferentes espacios de nombres.

  4. Actualiza la configuración de YAML de los recursos de Config Connector y establece la anotación cnrm.cloud.google.com/deletion-policy abandon.

  5. Aplica la configuración de YAML actualizada para actualizar la política de eliminación de recursos de Config Connector.

  6. Abandona los recursos de Config Connector.

  7. Actualiza el campo metadata.namespace en la configuración de YAML de los recursos de Config Connector que planeas mover a los diferentes espacios de nombres.

  8. Aplica la configuración de YAML actualizada al los recursos abandonados.

Administra grupos de nodos en clústeres de GKE

Es posible que experimentes errores cuando crees un clúster aplicando un recurso ContainerCluster en Config Connector y, luego, intentes actualizar nodeConfig o algún otro campo relacionado con el nodo aplicando una configuración ContainerCluster actualizada. Estos errores se deben a campos inmutables, como nodeConfig, nodeConfig.labels y nodeConfig.taint, que es una limitación técnica de la API de Google Cloud subyacente.

Si necesitas actualizar estos campos, puedes usar el recurso ContainerNodePool para administrar grupos de nodos en los que estos campos no son inmutables. Para administrar los grupos de nodos con el recurso ContainerNodePool, debes especificar una anotación cnrm.cloud.google.com/remove-default-node-pool: "true". Esta quita el grupo de nodos predeterminado que se crea durante de la creación de cuentas de servicio. Luego, para crear grupos de nodos separados, especifica los campos nodeConfig en ContainerNodePool en lugar de en ContainerCluster. Consulta el ejemplo de recurso ContainerNodePool como referencia.

Deberías establecer la anotación cnrm.cloud.google.com/state-into-spec: absent para los recursos ContainerCluster y ContainerNodePool. Esta anotación, se evitan posibles errores de conciliación durante la interacción entre el controlador de Config Connector y las APIs subyacentes.

En los siguientes ejemplos, se muestra una configuración de ContainerCluster y ContainerNodePool con estas anotaciones establecidas:

apiVersion: container.cnrm.cloud.google.com/v1beta1
kind: ContainerCluster
metadata:
  name: containercluster-sample
  annotations:
    cnrm.cloud.google.com/remove-default-node-pool: "true"
    cnrm.cloud.google.com/state-into-spec: absent
spec:
  description: A sample cluster.
  location: us-west1
  initialNodeCount: 1
apiVersion: container.cnrm.cloud.google.com/v1beta1
kind: ContainerNodePool
metadata:
  labels:
    label-one: "value-one"
  name: containernodepool-sample
  annotations:
    cnrm.cloud.google.com/state-into-spec: absent
spec:
  location: us-west1
  autoscaling:
    minNodeCount: 1
    maxNodeCount: 3
  nodeConfig:
    machineType: n1-standard-1
    preemptible: false
    oauthScopes:
      - "https://www.googleapis.com/auth/logging.write"
      - "https://www.googleapis.com/auth/monitoring"
  clusterRef:
    name: containercluster-sample