Primeros pasos con Config Connector

En esta guía se muestran los conceptos básicos de la gestión de recursos de Config Connector. Para ello, te enseñaremos a completar las siguientes tareas:

Antes de empezar

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

Descubrir los recursos Google Cloud disponibles

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

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

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

Por ejemplo, puede ver la descripción de la API del recurso PubSubTopic con kubectl describe:

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

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

Habilitar el servicio Pub/Sub

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

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

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

    Sustituye PROJECT_ID por el ID de tu proyecto. Google Cloud

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

    kubectl apply -f enable-pubsub.yaml

Crear 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

Haz los cambios siguientes:

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

Cuando creas un recurso, Config Connector lo crea si no existe. Si ya existe un recurso con el mismo nombre, Config Connector lo adquiere y lo gestiona. Google Cloud Para obtener más información sobre cómo adquirir un recurso, consulta el artículo Gestionar y eliminar 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

Describir un recurso

Usa kubectl describe para obtener información sobre un recurso.

Por ejemplo, para ver todos tus temas de Pub/Sub, ejecuta el siguiente comando:

kubectl describe pubsubtopics

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

Verificar que un recurso esté listo

Una vez que hayas creado un tema de Pub/Sub, puedes consultar su status.condition. Por ejemplo, para comprobar si tu recurso de tema de Pub/Sub está listo, ejecuta el siguiente comando:

kubectl wait --for=condition=READY pubsubtopics TOPIC_NAME

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

Debería ver un resultado similar al siguiente ejemplo:

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

Actualizar un recurso

Para actualizar los metadatos de tus recursos, modifica el archivo YAML y vuelve a aplicarlo con kubectl.

Para cambiar la etiqueta del tema de Pub/Sub que has creado en la sección anterior, sigue estos pasos:

  1. Modifica la sección metadata de tu 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

    Haz los cambios siguientes:

    • PROJECT_ID: tu ID de proyecto Google Cloud .
    • NEW_LABEL_VALUE: un valor actualizado de la etiqueta que has añadido anteriormente. Por ejemplo, environment: staging.
    • TOPIC_NAME: 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. Comprueba que el nombre de la instancia de Pub/Sub ha cambiado:

    kubectl describe pubsubtopics

    El tema debería tener la nueva etiqueta.

Eliminar un recurso

Usa kubectl delete para eliminar recursos. Por ejemplo, para eliminar el PubSubTopic que has creado antes, ejecuta kubectl delete con tu archivo pubsub-topic.yaml:

kubectl delete -f pubsub-topic.yaml

Recibirás una confirmación de que se ha eliminado el recurso:

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

De forma predeterminada, Config Connector elimina el recurso PubSubTopic. Si prefieres conservar este recurso, consulta las instrucciones que se indican en el artículo Gestionar y eliminar recursos.

Siguientes pasos