Puoi modificare un cluster Connect per aggiornare proprietà come il numero di vCPU, la memoria, la rete e le etichette.
Per modificare un cluster di connessione, puoi utilizzare la console Google Cloud , gcloud CLI, la libreria client o l'API Managed Kafka. Non puoi utilizzare l'API Apache Kafka open source per aggiornare un cluster Connect.
Prima di iniziare
Non tutte le proprietà di un cluster di connessione sono modificabili. Esamina le proprietà di un cluster Connect prima di eseguire l'aggiornamento.
Ruoli e autorizzazioni richiesti
Per ottenere le autorizzazioni necessarie per modificare un cluster Connect, chiedi all'amministratore di concederti il ruolo IAM Managed Kafka Connect Cluster Editor (roles/managedkafka.connectClusterEditor) nel progetto.
Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.
Questo ruolo predefinito contiene le autorizzazioni necessarie per modificare un cluster Connect. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:
Autorizzazioni obbligatorie
Per modificare un cluster connesso sono necessarie le seguenti autorizzazioni:
-
Aggiorna un cluster Connect:
managedkafka.connectClusters.update -
Visualizza i connettori quando utilizzi la console Google Cloud per aggiornare un cluster di connessione:
managedkafka.connectors.list
Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.
Autorizzazioni subnet del cluster
Se aggiorni la subnet dei worker di un cluster Connect, l'agente di servizio Managed Kafka collega la subnet durante l'operazione di aggiornamento.
L'autorizzazione managedkafka.connectClusters.update consente indirettamente a un'entità di collegare qualsiasi subnet che l'agente di servizio è autorizzato a utilizzare, anche se l'entità non dispone dell'autorizzazione diretta per utilizzare la subnet.
Modifica un cluster di connessione
L'aggiornamento di alcune proprietà, come CPU e memoria, richiede il riavvio del cluster.
I riavvii del cluster conservano i dati, ma potrebbero aumentare la latenza. Il numero iniziale di worker nel cluster determina la durata del riavvio.
Puoi aggiornare le seguenti proprietà del cluster di connessione:
| Proprietà | Modificabile |
|---|---|
| vCPU | Sì |
| Memoria | Sì |
| Rete | Sì |
| Subnet worker | Sì |
| Domini DNS risolvibili | Sì (aggiungi/elimina) |
| Nome cluster di connessione | No |
| Cluster Kafka | No |
| Località | No |
| Etichette | Sì (aggiungi/modifica/elimina) |
| Secret | Sì (aggiungi/elimina) |
Console
Nella console Google Cloud , vai alla pagina Connetti i cluster.
Fai clic sul cluster connesso che vuoi aggiornare.
Viene visualizzata la pagina Dettagli cluster di connessione.
Fai clic su Modifica.
Viene visualizzata la pagina Modifica cluster di connessione Kafka.
Apporta le modifiche necessarie alle proprietà modificabili.
Fai clic su Salva.
gcloud
-
Nella console Google Cloud , attiva Cloud Shell.
Nella parte inferiore della console Google Cloud , viene avviata una sessione di Cloud Shell e viene visualizzato un prompt della riga di comando. Cloud Shell è un ambiente shell con Google Cloud CLI già installata e con valori già impostati per il progetto corrente. L'inizializzazione della sessione può richiedere alcuni secondi.
Esegui il comando
gcloud managed-kafka connect-clusters update: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]Sostituisci quanto segue:
- CONNECT_CLUSTER_ID: l'ID o il nome del cluster connesso. Il nome di un cluster connesso è immutabile.
- LOCATION: la località del cluster connesso. La località di un cluster connesso è immutabile.
- CPU: il numero di vCPU per il cluster Connect. Il valore minimo è 3 vCPU.
- MEMORY: la quantità di memoria per il cluster Connect. Utilizza le unità "MB", "MiB", "GB", "GiB", "TB" o "TiB". Ad esempio, "10GiB". Devi eseguire il provisioning di una quantità compresa tra 1 GiB e 8 GiB per vCPU.
- DNS_NAME: il nome di dominio DNS della rete della subnet che deve essere reso visibile al cluster di connessione.
- LABELS: (facoltativo) etichette da associare al cluster. Per saperne di più sul formato delle etichette, consulta Etichette. Elenco di coppie CHIAVE=VALORE di etichette da aggiungere. Le chiavi devono iniziare con un carattere minuscolo e contenere solo trattini (-), trattini bassi (_), caratteri minuscoli e numeri. I valori devono contenere solo trattini (-), trattini bassi (_), caratteri minuscoli e numeri.
- SECRET: (facoltativo) secret da caricare nei worker.
Devono essere fornite le versioni esatte dei secret di Secret Manager, gli alias non sono supportati. In un cluster è possibile caricare fino a 32 secret. Formato:
projects/PROJECT_ID/secrets/SECRET_NAME/versions/VERSION_ID WORKER_SUBNET: la subnet worker per il cluster connesso. La subnet worker deve trovarsi nella stessa regione del cluster di connessione.
Il formato della subnet è
projects/PROJECT_ID/regions/REGION/subnetworks/SUBNET_ID.
Vai
Prima di provare questo esempio, segui le istruzioni di configurazione di Go in Installa le librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Go di Managed Service per Apache Kafka.
Per eseguire l'autenticazione in Managed Service per Apache Kafka, configura le Credenziali predefinite dell'applicazione (ADC). Per saperne di più, consulta Configura ADC per un ambiente di sviluppo locale.
Java
Prima di provare questo esempio, segui le istruzioni di configurazione di Java riportate in Installa le librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Java di Managed Service per Apache Kafka.
Per eseguire l'autenticazione in Managed Service per Apache Kafka, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura ADC per un ambiente di sviluppo locale.
Python
Prima di provare questo esempio, segui le istruzioni di configurazione di Python in Installa le librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Python di Managed Service per Apache Kafka.
Per eseguire l'autenticazione in Managed Service per Apache Kafka, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura ADC per un ambiente di sviluppo locale.