Introduzione a Config Connector

Questa guida illustra le nozioni di base sulla gestione delle risorse di Config Connector, insegnando come completare le attività seguenti:

Prima di iniziare

Prima di iniziare gli allenamenti su questa pagina, completa le seguenti attività:

Scoperta delle 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 configurazione 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 vedere le informazioni sulle risorse disponibili in Risorse Config Connector.

Abilitazione 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 lì il seguente 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 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 il seguente contenuto:

  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 crea la risorsa se non esiste. Se esiste già una risorsa Google Cloud con lo stesso nome, Config Connector acquisisce la risorsa e la gestisce. Per scoprire di più sull'acquisizione di una risorsa esistente, consulta Gestione ed eliminazione delle risorse.

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

kubectl apply -f pubsub-topic.yaml

Descrizione di una risorsa

Utilizza kubectl describe per ottenere dettagli su una risorsa.

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

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 la status.condition. Ad esempio, per verificare se la risorsa di argomento Pub/Sub è pronta, esegui il comando seguente:

kubectl wait --for=condition=READY pubsubtopics TOPIC_NAME

Sostituisci TOPIC_NAME con il nome del tuo argomento Pub/Sub.

Dovresti vedere un output simile all'esempio seguente:

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

Aggiornamento di una risorsa

Per aggiornare i metadati nelle tue risorse, aggiorna il file YAML e applicalo di nuovo con kubectl.

Per modificare l'etichetta nell'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 aggiunta in precedenza. Ad esempio, environment: staging.
    • TOPIC_NAME: 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 deve avere la nuova etichetta.

Eliminazione di una risorsa

Utilizza kubectl delete per eliminare risorse. Ad esempio, per eliminare l'elemento 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