Comienza a usar Config Connector


En esta guía, se muestran los conceptos básicos de la administración de recursos de Config Connector, mediante la enseñanza sobre cómo completar las siguientes tareas:

  • Habilita una API de Google Cloud.
  • Crea y administra un tema de Pub/Sub.

Antes de comenzar

Antes de comenzar los ejercicios en esta página, completa las siguientes tareas:

Descubre los recursos disponibles de Google Cloud

Para ver qué tipos de recursos de Google Cloud puedes crear con Config Connector, ejecuta lo siguiente:

kubectl get crds --selector cnrm.cloud.google.com/managed-by-kcc=true

El resultado es una lista de todos los recursos que tu versión de Config Connector puede crear y administrar.

Por ejemplo, puedes ver la descripción de la API para el recurso PubSubTopic con kubectl describe:

kubectl describe crd pubsubtopics.pubsub.cnrm.cloud.google.com

También puedes ver información sobre los recursos disponibles en los recursos de Config Connector.

Habilita el servicio de Pub/Sub

Usa Config Connector para habilitar la API de Pub/Sub mediante la aplicación de una configuración YAML a tu clúster:

  1. Crea un archivo llamado enable-pubsub.yaml y copia el siguiente archivo YAML en él:

    apiVersion: serviceusage.cnrm.cloud.google.com/v1beta1
    kind: Service
    metadata:
      name: pubsub.googleapis.com
    spec:
      projectRef:
        external: projects/PROJECT_ID
    

    Reemplaza PROJECT_ID por el ID del proyecto de Google Cloud.

  2. Usa kubectl apply para aplicar la configuración al clúster: Para habilitar la API de Pub/Sub, ejecuta el siguiente comando:

    kubectl apply -f enable-pubsub.yaml

Crea una instancia de Pub/Sub

Crea un archivo llamado pubsub-topic.yaml con el siguiente contenido:

  apiVersion: pubsub.cnrm.cloud.google.com/v1beta1
  kind: PubSubTopic
  metadata:
    annotations:
      cnrm.cloud.google.com/project-id: PROJECT_ID
    labels:
      LABEL_KEY:LABEL_VALUE
    name: TOPIC_NAME

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID de tu proyecto de Google Cloud.
  • LABEL_KEY:LABEL_VALUE: Es un par clave-valor de etiquetas. Por ejemplo, environment:production.
  • TOPIC_NAME: Es el nombre del tema de Pub/Sub.

Cuando creas un recurso, Config Connector crea el recurso si no existe. Si ya existe un recurso de Google Cloud con el mismo nombre, Config Connector adquiere el recurso y lo administra. Para obtener más información sobre cómo adquirir un recurso existente, consulta Administra y borra recursos.

Usa el comando kubectl apply para crear recursos: Para crear el tema de Pub/Sub, ejecuta el siguiente comando:

kubectl apply -f pubsub-topic.yaml 

Describe un recurso

Usa kubectl describe para obtener detalles sobre un recurso.

Por ejemplo, para ver todo el tema de Pub/Sub, ejecuta el siguiente comando:

kubectl describe pubsubtopics

En esta lista, deberías ver el tema de Pub/Sub que creaste en la sección anterior.

Verifica que un recurso esté listo

Después de crear un tema de Pub/Sub, puedes verificar su status.condition. Por ejemplo, para verificar si tu recurso de tema de Pub/Sub está listo, ejecuta el siguiente comando:

kubectl wait --for=condition=READY pubsubtopics TOPIC_NAME

Reemplaza TOPIC_NAME por el nombre de tu tema de Pub/Sub.

Deberías ver un resultado similar al siguiente:

pubsubtopic.pubsub.cnrm.cloud.google.com/TOPIC_NAME condition met

Actualiza un recurso

Puedes actualizar metadatos en los recursos mediante la actualización del archivo de YAML y vuelve a aplicarlo con kubectl.

Para cambiar la etiqueta en el tema de Pub/Sub que creaste en la sección anterior, completa los siguientes pasos:

  1. Modifica la sección metadata del archivo pubsub-topic.yaml para cambiar la etiqueta:

      apiVersion: pubsub.cnrm.cloud.google.com/v1beta1
      kind: PubSubTopic
      metadata:
        annotations:
          cnrm.cloud.google.com/project-id: PROJECT_ID
        labels:
          NEW_LABEL_VALUE
        name: TOPIC_NAME
    

    Reemplaza lo siguiente:

    • PROJECT_ID: Es el ID de tu proyecto de Google Cloud.
    • NEW_LABEL_VALUE: Un valor actualizado para la etiqueta que agregaste antes. Por ejemplo, environment: staging.
    • TOPIC_NAME: Es el nombre del tema de Pub/Sub.
  2. Usa kubectl apply para actualizar el recurso. Ejecuta el siguiente comando:

    kubectl apply -f pubsub-topic.yaml
  3. Verifica la instancia de Pub/Sub para ver el cambio de nombre:

    kubectl describe pubsubtopics

    Tu tema debe tener la etiqueta nueva.

Borra un recurso

Usa kubectl delete para borrar recursos. Por ejemplo, para borrar la PubSubTopic que creaste antes, ejecuta kubectl delete con tu archivo pubsub-topic.yaml:

kubectl delete -f pubsub-topic.yaml

Recibirás la confirmación de que se borró el recurso:

pubsubtopic.pubsub.cnrm.cloud.google.com "TOPIC_NAME" deleted

De forma predeterminada, Config Connector borra el recurso PubSubTopic. Si prefieres conservar este recurso, consulta las instrucciones en Administra y borra recursos.

¿Qué sigue?