Introduzione a Config Connector

Questa guida mostra 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 risorse Google Cloud 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 tuo 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 l'ID progetto Google Cloud.

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

    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 ID progetto Google Cloud .
  • 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 risorsa Google Cloud 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 questo comando:

kubectl apply -f pubsub-topic.yaml

Descrivere una risorsa

Utilizza kubectl describe per visualizzare i dettagli di una risorsa.

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

kubectl describe pubsubtopics

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

Verifica che una risorsa sia pronta

Dopo aver creato un argomento Pub/Sub, puoi controllarne status.condition. Ad esempio, per verificare se la risorsa argomento Pub/Sub è pronta, esegui questo 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 tue risorse aggiornando il file YAML e riapplicandolo con kubectl.

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

  1. Modifica la sezione metadata del file pubsub-topic.yaml per cambiare 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 ID progetto Google Cloud .
    • 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 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 PubSubTopic che hai creato in precedenza, esegui kubectl delete con il file pubsub-topic.yaml:

kubectl delete -f pubsub-topic.yaml

Ricevi la 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 conservare questa risorsa, consulta le istruzioni in Gestione ed eliminazione delle risorse.

Passaggi successivi