Erste Schritte mit Config Connector

In diesem Leitfaden werden die Grundlagen der Config Connector-Ressourcenverwaltung erläutert. Sie erfahren, wie Sie die folgenden Aufgaben ausführen:

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

Hinweise

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 die Google Cloud-Projekt-ID.

  2. Um die Konfiguration auf Ihren Cluster anzuwenden, verwenden Sie kubectl apply. 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 ist 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 es eine Google Cloud-Ressource mit dem angegebenen Namen bereits gibt, ruft Config Connector die Ressource ab und verwaltet sie. Weitere Informationen zum Abrufen einer vorhandenen Ressource finden Sie unter Ressourcen verwalten und löschen.

Um Ressourcen zu erstellen, verwenden Sie den Befehl kubectl apply. 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. Führen Sie beispielsweise den folgenden Befehl aus, um zu prüfen, ob die Ressource für das Pub/Sub-Thema bereit ist:

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.

Führen Sie die folgenden Schritte aus, um das Label für das Pub/Sub-Thema zu ändern, das Sie im vorherigen Abschnitt erstellt haben:

  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 ist 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

    Ihr Thema sollte das neue Label haben.

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