Erste Schritte mit Config Connector

Dieser Leitfaden erläutert die Grundlagen der Config Connector-Ressourcenverwaltung. Dabei werden folgende Themen behandelt:

  • Aktivieren Sie eine Google Cloud API.
  • Erstellen und Verwalten Sie ein Pub/Sub-Thema.

Hinweis

Führen Sie folgende Aufgaben aus, bevor Sie mit den Übungen auf dieser Seite beginnen:

Verfügbare Google Cloud Ressourcen ermitteln

Führen Sie Folgendes aus, um festzustellen, welche Google Cloud Ressourcen Sie mit Config Connector erstellen können:

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

Als Ausgabe erhalten Sie eine Liste aller Ressourcen, die Ihre Config Connector-Version erstellen und verwalten kann.

Beispielsweise können Sie die API-Beschreibung für die Ressource PubSubTopic mit kubectl describe aufrufen:

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

Informationen zu verfügbaren Ressourcen finden Sie auch unter Config Connector-Ressourcen.

Pub/Sub-Dienst aktivieren

Verwenden Sie Config Connector, um die Pub/Sub API zu aktivieren. Dazu wenden Sie eine YAML-Konfiguration auf Ihren Cluster an:

  1. Erstellen Sie eine Datei mit dem Namen enable-pubsub.yaml und kopieren Sie die folgende YAML-Datei hinein:

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

    Ersetzen Sie PROJECT_ID durch Ihre Google CloudProjekt-ID.

  2. Verwenden Sie kubectl apply, um die Konfiguration auf Ihren Cluster anzuwenden. Führen Sie folgenden Befehl aus, um die Pub/Sub API zu aktivieren:

    kubectl apply -f enable-pubsub.yaml

Pub/Sub-Instanz erstellen

Erstellen Sie eine Datei mit dem Namen pubsub-topic.yaml und dem folgendem Inhalt:

  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

Ersetzen Sie Folgendes:

  • PROJECT_ID: Ihre Google Cloud Projekt-ID.
  • LABEL_KEY: LABEL_VALUE ist ein Schlüssel/Wert-Paar von Labels. Beispiel: environment: production
  • TOPIC_NAME: der Name des Pub/Sub-Themas.

Wenn Sie eine Ressource erstellen, legt Config Connector die Ressource an, falls sie noch nicht vorhanden ist. Wenn eine Google Cloud -Ressource mit demselben Namen bereits vorhanden ist, ruft Config Connector die Ressource ab und verwaltet sie. Weitere Informationen zum Abrufen einer vorhandenen Ressource finden Sie unter Ressourcen verwalten und löschen.

Verwenden Sie den Befehl kubectl apply, um Ressourcen zu erstellen. Führen Sie folgenden Befehl aus, um das Pub/Sub-Thema zu erstellen:

kubectl apply -f pubsub-topic.yaml

Ressource beschreiben

Mit kubectl describe lassen sich Details zu einer Ressource abrufen.

Führen Sie beispielsweise den folgenden Befehl aus, um alle Ihr Pub/Sub-Themem anzuzeigen:

kubectl describe pubsubtopics

In dieser Liste sollte das Pub/Sub-Thema angezeigt werden, das Sie im vorherigen Abschnitt erstellt haben.

Prüfen, ob eine Ressource bereit ist

Nachdem Sie ein Pub/Sub-Thema erstellt haben, können Sie dessen status.condition prüfen. Wenn Sie beispielsweise prüfen möchten, ob Ihre Pub/Sub-Themenressource bereit ist, führen Sie den folgenden Befehl aus:

kubectl wait --for=condition=READY pubsubtopics TOPIC_NAME

Ersetzen Sie TOPIC_NAME durch den Namen Ihres Pub/Sub-Themas.

Die Ausgabe sollte in etwa wie im folgenden Beispiel aussehen:

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

Ressource aktualisieren

Sie können Metadaten für Ihre Ressourcen aktualisieren, indem Sie Ihre YAML-Datei aktualisieren und mit kubectl noch einmal anwenden.

So ändern Sie das Label für das im vorherigen Abschnitt erstellte Pub/Sub-Thema:

  1. Bearbeiten Sie den metadata-Abschnitt in der pubsub-topic.yaml-Datei, um das Label zu ändern:

      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

    Ersetzen Sie Folgendes:

    • PROJECT_ID: Ihre Google Cloud Projekt-ID.
    • NEW_LABEL_VALUE: ein aktualisierter Wert für das zuvor hinzugefügte Label. Beispiel: environment: staging.
    • TOPIC_NAME ist der Name des Pub/Sub-Themas

  2. Verwenden Sie kubectl apply, um die Ressource zu aktualisieren. Führen Sie dazu diesen Befehl aus:

    kubectl apply -f pubsub-topic.yaml

  3. Prüfen Sie, ob der Name der Pub/Sub-Instanz geändert wurde:

    kubectl describe pubsubtopics

    Das neue Label sollte für Ihr Thema verwendet werden.

Ressource löschen

Zum Löschen von Ressourcen verwenden Sie kubectl delete. Führen Sie beispielsweise kubectl delete mit der Datei pubsub-topic.yaml aus, um die zuvor erstellte PubSubTopic zu löschen:

kubectl delete -f pubsub-topic.yaml

Sie erhalten eine Bestätigung, dass die Ressource gelöscht wurde:

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

Config Connector löscht standardmäßig die Ressource PubSubTopic. Wenn Sie diese Ressource beibehalten möchten, finden Sie entsprechende Informationen unter Ressourcen verwalten und löschen.

Nächste Schritte