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 una instancia de Cloud Spanner

Antes de comenzar

Para completar los pasos de esta página, haz lo siguiente:

  • Instala Config Connector.

  • Configura Config Connector para usar un proyecto predeterminado.

  • Config Connector usa la API de Resource Manager para habilitar las API de servicio. Para seguir estos pasos, debes habilitar la API de Resource Manager. Puedes habilitar esta API con el siguiente comando de “gcloud”.
    gcloud services enable cloudresourcemanager.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 SpannerInstance con kubectl describe:

kubectl describe crd spannerinstances.spanner.cnrm.cloud.google.com

Habilita el servicio de Cloud Spanner

Puedes usar Config Connector para habilitar la API de Cloud Spanner si aplicas una configuración YAML a tu clúster.

  1. Copia el siguiente YAML en un archivo llamado enable-spanner.yaml.

    apiVersion: serviceusage.cnrm.cloud.google.com/v1beta1
    kind: Service
    metadata:
      name: spanner.googleapis.com
    
  2. Usa kubectl apply para aplicar la configuración al clúster: Para habilitar la API de Cloud Spanner, ejecuta el siguiente comando:

    kubectl --namespace [CC_NAMESPACE] apply -f enable-spanner.yaml

    Reemplaza [CC_NAMESPACE] con el espacio de nombres que administra Config Connector.

Crea una instancia de Cloud Spanner

Crea un archivo llamado spanner-instance.yaml con el siguiente contenido:

apiVersion: spanner.cnrm.cloud.google.com/v1beta1
kind: SpannerInstance
metadata:
  annotations:
    cnrm.cloud.google.com/project-id: [PROJECT_ID]
  labels:
    label-one: "value-one"
  name: spannerinstance-sample
spec:
  config: regional-us-west1
  displayName: Spanner Instance Sample
  numNodes: 1

Reemplaza [PROJECT_ID] con el ID del proyecto.

Cuando creas un recurso, el conector de configuración lo crea si aún 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 la instancia de Cloud Spanner, copia el siguiente comando:

kubectl apply -f spanner-instance.yaml --namespace [CC_NAMESPACE]

Reemplaza [CC_NAMESPACE] con tu espacio de nombres de Config Connector.

Describe un recurso

Usa kubectl describe para obtener detalles sobre un recurso.

Por ejemplo, para ver la instancia de Cloud Spanner, ejecuta el siguiente comando:

kubectl describe spannerinstance spannerinstance-sample

Actualiza un recurso

Puedes actualizar metadatos en los recursos mediante la actualización del archivo de YAML y vuelve a aplicarlo con kubectl. Para actualizar los metadatos en la instancia de Spanner que creaste antes, haz lo siguiente:

  1. Modifica el archivo spanner-instance.yaml para cambiar spec.displayName de "Muestra de instancia de Spanner" a "Mi instancia de Spanner".

    apiVersion: spanner.cnrm.cloud.google.com/v1beta1
    kind: SpannerInstance
    metadata:
      annotations:
        cnrm.cloud.google.com/project-id: [PROJECT_ID]
      labels:
        label-one: "value-one"
      name: spannerinstance-sample
    spec:
      config: regional-us-west1
      displayName: My Spanner Instance
      numNodes: 1
    

    Reemplaza [PROJECT_ID] con el ID del proyecto.

  2. Usa kubectl apply para actualizar el recurso. Ejecuta el siguiente comando:

    kubectl apply -f spanner-instance.yaml
  3. Verifica la instancia de Cloud Spanner para el cambio de nombre.

    kubectl describe spannerinstance spannerinstance-sample

    La descripción debe incluir el nombre nuevo, My Spanner Instance.

Borra un recurso

Usa kubectl delete para borrar recursos. Por ejemplo, para borrar la SpannerInstance que creaste antes, ejecuta kubectl delete con tu archivo spanner-instance.yaml:

kubectl delete -f spanner-instance.yaml

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

spannerinstance.spanner.cnrm.cloud.google.com "spannerinstance-sample" deleted

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

Qué sigue