Sie können einen Connect-Cluster bearbeiten, um Attribute wie die Anzahl der vCPUs, den Arbeitsspeicher, das Netzwerk und die Labels zu aktualisieren.
Sie können einen Connect-Cluster mit der Google Cloud Console, der gcloud CLI, der Clientbibliothek oder der Managed Kafka API bearbeiten. Sie können die Open-Source-Apache Kafka API nicht verwenden, um einen Connect-Cluster zu aktualisieren.
Hinweis
Nicht alle Attribute eines Connect-Clusters können bearbeitet werden. Prüfen Sie die Attribute eines Connect-Clusters, bevor Sie ihn aktualisieren.
Erforderliche Rollen und Berechtigungen
Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Managed Kafka Connect Cluster Editor (roles/managedkafka.connectClusterEditor) für Ihr Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Bearbeiten eines Connect-Clusters benötigen.
Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.
Diese vordefinierte Rolle enthält die Berechtigungen, die zum Bearbeiten eines Connect-Clusters erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die notwendigen Berechtigungen anzuzeigen:
Erforderliche Berechtigungen
Die folgenden Berechtigungen sind zum Bearbeiten eines Connect-Clusters erforderlich:
-
Connect-Cluster aktualisieren:
managedkafka.connectClusters.update -
So rufen Sie Connectors auf, wenn Sie die Google Cloud Console zum Aktualisieren eines Connect-Clusters verwenden:
managedkafka.connectors.list
Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.
Berechtigungen für Cluster-Subnetze
Wenn Sie das Worker-Subnetz eines Connect-Clusters aktualisieren, hängt der Managed Kafka-Dienst-Agent das Subnetz während des Aktualisierungsvorgangs an.
Mit der Berechtigung managedkafka.connectClusters.update kann ein Hauptkonto indirekt jedes Subnetz anhängen, für das der Dienst-Agent die Berechtigung zur Verwendung hat, auch wenn das Hauptkonto keine direkte Berechtigung zur Verwendung des Subnetzes hat.
Connect-Cluster bearbeiten
Für die Aktualisierung bestimmter Attribute wie CPU und Arbeitsspeicher ist ein Neustart des Clusters erforderlich.
Bei Clusterneustarts bleiben die Daten erhalten, aber die Latenz kann sich erhöhen. Die anfängliche Anzahl der Worker im Cluster bestimmt die Dauer des Neustarts.
Sie können die folgenden Connect-Clusterattribute aktualisieren:
| Attribut | Bearbeitbar |
|---|---|
| vCPUs | Ja |
| Arbeitsspeicher | Ja |
| Netzwerk | Ja |
| Worker-Subnetz | Ja |
| Auflösbare DNS-Domains | Ja (hinzufügen/löschen) |
| Name des Connect-Clusters | Nein |
| Kafka-Cluster | Nein |
| Standort | Nein |
| Labels | Ja (hinzufügen/bearbeiten/löschen) |
| Secrets | Ja (hinzufügen/löschen) |
Console
Rufen Sie in der Google Cloud Console die Seite Cluster verbinden auf.
Klicken Sie auf den Connect-Cluster, den Sie aktualisieren möchten.
Die Seite Connect-Clusterdetails wird angezeigt.
Klicken Sie auf Bearbeiten.
Die Seite Kafka Connect-Cluster bearbeiten wird angezeigt.
Nehmen Sie die erforderlichen Änderungen an den bearbeitbaren Attributen vor.
Klicken Sie auf Speichern.
gcloud
-
Aktivieren Sie Cloud Shell in der Google Cloud Console.
Unten in der Google Cloud Console wird eine Cloud Shell-Sitzung gestartet und eine Eingabeaufforderung angezeigt. Cloud Shell ist eine Shell-Umgebung, in der das Google Cloud CLI bereits installiert ist und Werte für Ihr aktuelles Projekt bereits festgelegt sind. Das Initialisieren der Sitzung kann einige Sekunden dauern.
Führen Sie den Befehl
gcloud managed-kafka connect-clusters updateaus:gcloud managed-kafka connect-clusters update CONNECT_CLUSTER_ID \ --location=LOCATION \ [--cpu=CPU --memory=MEMORY | --clear-dns-names \ | --dns-name=DNS_NAME --clear-labels \ | --labels=LABELS --clear-secrets \ | --secret=SECRET [--primary-subnet=WORKER_SUBNET \ [--async]Ersetzen Sie Folgendes:
- CONNECT_CLUSTER_ID: Die ID oder der Name des Connect-Clusters. Der Name eines Connect-Clusters kann nicht geändert werden.
- LOCATION: Der Standort des Connect-Clusters. Der Standort eines Connect-Clusters kann nicht geändert werden.
- CPU: Die Anzahl der vCPUs für den Connect-Cluster. Der Mindestwert beträgt 3 vCPUs.
- MEMORY: Die Größe des Arbeitsspeichers für den Connect-Cluster. Verwenden Sie die Einheiten „MB“, „MiB“, „GB“, „GiB“, „TB“ oder „TiB“. Beispiel: „10GiB“. Sie müssen zwischen 1 GiB und 8 GiB pro vCPU bereitstellen.
- DNS_NAME: DNS-Domainname aus dem Netzwerk des Subnetzes, der für den Connect-Cluster sichtbar gemacht werden soll.
- LABELS: (Optional) Labels, die dem Cluster zugeordnet werden sollen. Weitere Informationen zum Format von Labels finden Sie unter Labels. Liste der hinzuzufügenden KEY=VALUE-Labelpaare. Schlüssel müssen mit einem Kleinbuchstaben beginnen und dürfen nur Bindestriche (-), Unterstriche (_), Kleinbuchstaben und Ziffern enthalten. Werte dürfen nur Bindestriche (-), Unterstriche (_), Kleinbuchstaben und Ziffern enthalten.
- SECRET: (Optional) Secrets, die in Worker geladen werden sollen.
Es müssen genaue Secret-Versionen aus Secret Manager angegeben werden. Aliasse werden nicht unterstützt. In einen Cluster können bis zu 32 Secrets geladen werden. Format:
projects/PROJECT_ID/secrets/SECRET_NAME/versions/VERSION_ID WORKER_SUBNET: Das Worker-Subnetz für den Connect-Cluster. Das Worker-Subnetz muss sich in derselben Region wie der Connect-Cluster befinden.
Das Format des Subnetzes ist
projects/PROJECT_ID/regions/REGION/subnetworks/SUBNET_ID.
Go
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Go unter Clientbibliotheken installieren. Weitere Informationen finden Sie in der Go API-Referenzdokumentation für Managed Service for Apache Kafka.
Richten Sie zur Authentifizierung bei Managed Service for Apache Kafka Standardanmeldedaten für Anwendungen (Application Default Credentials, ADC) ein. Weitere Informationen finden Sie unter ADC für eine lokale Entwicklungsumgebung einrichten.
Java
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Anleitung zur Einrichtung von Java unter Clientbibliotheken installieren. Weitere Informationen finden Sie in der Referenzdokumentation zur Managed Service for Apache Kafka Java API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Managed Service for Apache Kafka zu authentifizieren. Weitere Informationen finden Sie unter Standardanmeldedaten für Anwendungen für eine lokale Entwicklungsumgebung einrichten.
Python
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Python unter Clientbibliotheken installieren. Weitere Informationen finden Sie in der Referenzdokumentation zur Managed Service for Apache Kafka Python API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Managed Service for Apache Kafka zu authentifizieren. Weitere Informationen finden Sie unter ADC für eine lokale Entwicklungsumgebung einrichten.