Erste Schritte mit Config Connector

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

  • 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

Wenn Sie sehen möchten, welche Arten von Google Cloud -Ressourcen Sie mit Config Connector erstellen können, führen Sie Folgendes aus:

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: Projekt-ID in Google Cloud .
  • 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, übernimmt Config Connector die Ressource und verwaltet sie. Weitere Informationen zum Erfassen 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

Verwenden Sie kubectl describe, um Details zu einer Ressource abzurufen.

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 seine status.condition prüfen. Führen Sie beispielsweise den folgenden Befehl aus, um zu prüfen, ob Ihre Pub/Sub-Themenressource 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 die Metadaten Ihrer Ressourcen aktualisieren, indem Sie die YAML-Datei aktualisieren und sie mit kubectl neu anwenden.

So ändern Sie das Label für das Pub/Sub-Thema, 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: Projekt-ID in Google Cloud .
    • NEW_LABEL_VALUE: ein aktualisierter Wert für das Label, das Sie zuvor hinzugefügt haben. 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

Verwenden Sie kubectl delete, 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