Introduzione a Config Connector

Questa guida illustra le nozioni di base della gestione delle risorse di Config Connector insegnandoti a completare le seguenti attività:

Prima di iniziare

Prima di iniziare gli esercizi in questa pagina, completa le seguenti attività:

Scoprire le risorse Google Cloud disponibili

Per vedere quali tipi di Google Cloud risorse puoi creare con Config Connector, esegui:

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

L'output è un elenco di tutte le risorse che la tua versione di Config Connector può creare e gestire.

Ad esempio, puoi visualizzare la descrizione dell'API per la risorsa PubSubTopic con kubectl describe:

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

Puoi anche visualizzare informazioni sulle risorse disponibili in Risorse di Config Connector.

Attivazione del servizio Pub/Sub

Utilizza Config Connector per abilitare l'API Pub/Sub applicando una configurazione YAML al cluster:

  1. Crea un file denominato enable-pubsub.yaml e copia al suo interno il seguente codice YAML:

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

    Sostituisci PROJECT_ID con il tuo Google Cloud ID progetto.

  2. Utilizza kubectl apply per applicare la configurazione al cluster. Per abilitare l'API Pub/Sub, esegui il comando seguente:

    kubectl apply -f enable-pubsub.yaml

Creazione di un'istanza Pub/Sub

Crea un file denominato pubsub-topic.yaml con i seguenti contenuti:

  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

Sostituisci quanto segue:

  • PROJECT_ID: il tuo Google Cloud ID progetto.
  • LABEL_KEY: LABEL_VALUE: una coppia chiave-valore di etichette. Ad esempio: environment: production.
  • TOPIC_NAME: il nome dell'argomento Pub/Sub.

Quando crei una risorsa, Config Connector la crea se non esiste. Se esiste già una Google Cloud risorsa con lo stesso nome, Config Connector la acquisisce e la gestisce. Per scoprire di più sull'acquisizione di una risorsa esistente, consulta Gestire ed eliminare le risorse.

Utilizza il comando kubectl apply per creare risorse. Per creare l'argomento Pub/Sub, esegui il seguente comando:

kubectl apply -f pubsub-topic.yaml

Descrivere una risorsa

Usa kubectl describe per visualizzare i dettagli di una risorsa.

Ad esempio, per visualizzare tutti gli argomenti Pub/Sub, esegui il seguente comando:

kubectl describe pubsubtopics

In questo elenco dovresti vedere l'argomento Pub/Sub che hai creato nella sezione precedente.

Verificare che una risorsa sia pronta

Dopo aver creato un argomento Pub/Sub, puoi controllarne il status.condition. Ad esempio, per verificare se la risorsa dell'argomento Pub/Sub è pronta, esegui il seguente comando:

kubectl wait --for=condition=READY pubsubtopics TOPIC_NAME

Sostituisci TOPIC_NAME con il nome dell'argomento Pub/Sub.

Dovresti vedere un output simile al seguente esempio:

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

Aggiornamento di una risorsa

Puoi aggiornare i metadati delle risorse aggiornando il file YAML e riapplicandolo con kubectl.

Per modificare l'etichetta dell'argomento Pub/Sub creato nella sezione precedente, completa i seguenti passaggi:

  1. Modifica la sezione metadata del file pubsub-topic.yaml per modificare l'etichetta:

      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

    Sostituisci quanto segue:

    • PROJECT_ID: il tuo Google Cloud ID progetto.
    • NEW_LABEL_VALUE: un valore aggiornato per l'etichetta che hai aggiunto in precedenza. Ad esempio, environment: staging.
    • TOPIC_NAME: il nome dell'argomento Pub/Sub

  2. Utilizza kubectl apply per aggiornare la risorsa. Esegui questo comando:

    kubectl apply -f pubsub-topic.yaml

  3. Controlla l'istanza Pub/Sub per verificare la modifica del nome:

    kubectl describe pubsubtopics

    L'argomento dovrebbe avere la nuova etichetta.

Eliminazione di una risorsa

Utilizza kubectl delete per eliminare le risorse. Ad esempio, per eliminare il file PubSubTopic creato in precedenza, esegui kubectl delete con il file pubsub-topic.yaml:

kubectl delete -f pubsub-topic.yaml

Riceverai una conferma dell'eliminazione della risorsa:

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

Per impostazione predefinita, Config Connector elimina la risorsa PubSubTopic. Se preferisci mantenere questa risorsa, consulta le istruzioni riportate in Gestire ed eliminare le risorse.

Passaggi successivi