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 depósito de Cloud Storage.

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 StorageBuckets con kubectl describe:

kubectl describe crd storagebuckets.storage.cnrm.cloud.google.com

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

Habilita el servicio de Cloud Storage

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

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

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

    kubectl --namespace YOUR_NAMESPACE apply -f enable-storage.yaml

    Reemplaza YOUR_NAMESPACE con el espacio de nombres que administra Config Connector.

Crea una instancia de Cloud Storage

Crea un archivo llamado storage-bucket.yaml con el siguiente contenido:

  apiVersion: storage.cnrm.cloud.google.com/v1beta1
  kind: StorageBucket
  metadata:
    annotations:
      cnrm.cloud.google.com/project-id : PROJECT_ID
    name: BUCKET_NAME
  spec:
    lifecycleRule:
      - action:
          type: Delete
        condition:
          age: 7

Reemplaza lo siguiente:

  • PROJECT_ID por el ID del proyecto
  • Reemplaza BUCKET_NAME por el nombre de tu bucket.

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 el bucket de Cloud Storage, ejecuta el siguiente comando:

kubectl apply -f storage-bucket.yaml --namespace YOUR_NAMESPACE

Reemplaza YOUR_NAMESPACE por el espacio de nombres que administra Config Connector.

Describe un recurso

Usa kubectl describe para obtener detalles sobre un recurso.

Por ejemplo, ejecuta el siguiente comando para ver todos los depósitos de Cloud Storage:

kubectl describe storagebuckets

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 del bucket de almacenamiento que creaste antes, haz lo siguiente:

  1. Modifica la sección metadata del archivo storage-bucket.yaml para agregar el directivo de force-destroy y una etiqueta con un valor.

    apiVersion: storage.cnrm.cloud.google.com/v1beta1
    kind: StorageBucket
    metadata:
      annotations:
        cnrm.cloud.google.com/force-destroy: "true"
        cnrm.cloud.google.com/project-id : PROJECT_ID
      labels:
        label-one: "my_bucket" 
      name: BUCKET_NAME
    spec:
      lifecycleRule:
        - action:
            type: Delete
          condition:
            age: 7
    

    Reemplaza lo siguiente:

    • PROJECT_ID por el ID del proyecto
    • Reemplaza BUCKET_NAME por el nombre de tu bucket.
  2. Usa kubectl apply para actualizar el recurso. Ejecuta el siguiente comando:

    kubectl apply -f storage-bucket.yaml
  3. Comprueba el cambio de nombre en la instancia de Cloud Storage.

    kubectl describe storagebuckets

    Tu depósito debe incluir la etiqueta y anotación nuevas:

    ...
    Labels:       label-one=my_bucket
    Annotations:  cnrm.cloud.google.com/force-destroy: true
    ...
    

Borra un recurso

Usa kubectl delete para borrar recursos. Por ejemplo, para borrar la StorageBucket que creaste antes, ejecuta kubectl delete con tu archivo storage-bucket.yaml:

kubectl delete -f storage-bucket.yaml

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

storage.cnrm.cloud.google.com "BUCKET_NAME" deleted

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

¿Qué sigue?