Introduzione a Config Connector
Questa guida illustra le nozioni di base della gestione delle risorse di Config Connector insegnandoti a completare le seguenti attività:
- Abilita un' Google Cloud API.
- Crea e gestisci un argomento Pub/Sub.
Prima di iniziare
Prima di iniziare gli esercizi in questa pagina, completa le seguenti attività:
Installa Config Connector completando tutti i passaggi descritti in Installare manualmente l'operatore Config Connector.
Configura Config Connector per utilizzare uno spazio dei nomi predefinito. Lo spazio dei nomi impostato come predefinito deve essere lo stesso a cui hai aggiunto un'annotazione quando hai specificato dove creare le risorse.
- Config Connector utilizza l'API Service Usage per attivare le API di servizio. Per eseguire questi passaggi, devi abilitare l'API Utilizzo servizio. Puoi abilitare questa API utilizzando Google Cloud CLI:
gcloud services enable serviceusage.googleapis.com
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:
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.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:
Modifica la sezione
metadata
del filepubsub-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
Utilizza
kubectl apply
per aggiornare la risorsa. Esegui questo comando:kubectl apply -f pubsub-topic.yaml
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
- Scopri in che modo Config Connector modella le Google Cloud risorse con i costruzioni Kubernetes.
- Consulta le Google Cloud risorse che Config Connector può gestire.
- Utilizza Config Connector per gestire le risorse Google Cloud esistenti.
- Consulta altri esempi di utilizzo di Config Connector nel repository GitHub.
- Scopri come Kubernetes gestisce la configurazione dichiarativa degli oggetti.