Erste Schritte mit Config Connector

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

  • Google Cloud API aktivieren
  • 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 die Google Cloud-Projekt-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 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.

Verwenden Sie die Methode kubectl apply zum Erstellen von Ressourcen. 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.

Prüfen, ob eine Ressource bereit ist

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

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, indem Sie die YAML-Datei aktualisieren und sie mit kubectl noch einmal anwenden.

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

  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 erhalten.

Ressource löschen

kubectl delete verwenden um Ressourcen zu löschen. 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