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 las siguientes instrucciones:

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

Antes de comenzar

Para finalizar los ejercicios de esta página, completa las siguientes tareas:

  • Instala Config Connector. Para ello, completa todos los pasos en Instala con el complemento de GKE.

  • Configura Config Connector para usar un espacio de nombres predeterminado.

  • Config Connector usa la API de Service Usage para habilitar las API de servicio. Para realizar estos pasos, debes habilitar la API de Service Usage. Puedes habilitar esta API mediante la herramienta de línea de comandos de gcloud:
    gcloud services enable serviceusage.googleapis.com

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. Copia el siguiente YAML en un archivo llamado enable-pubsub.yaml.

    apiVersion: serviceusage.cnrm.cloud.google.com/v1beta1
    kind: Service
    metadata:
      name: pubsub.googleapis.com
    
  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:
    labels:
      LABEL_VALUE
    name: TOPIC_NAME

Reemplaza lo siguiente:

  • 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 el 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 del 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:
        labels:
          NEW_LABEL_VALUE
        name: TOPIC_NAME
    

    Reemplaza lo siguiente:

    • NEW_LABEL_VALUE: Es 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. Busca el cambio de nombre en la instancia de Pub/Sub:

    kubectl describe pubsubtopics

    Tu tema debe tener la etiqueta nueva.

Borra un recurso

Usa kubectl delete para borrar recursos. Por ejemplo, para borrar el 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?