Anda dapat mengedit cluster Connect untuk memperbarui properti seperti jumlah vCPU, memori, jaringan, dan label.
Untuk mengedit cluster Connect, Anda dapat menggunakan Konsol Google Cloud , gcloud CLI, library klien, atau Managed Kafka API. Anda tidak dapat menggunakan Apache Kafka API open source untuk mengupdate cluster Connect.
Sebelum memulai
Tidak semua properti cluster Connect dapat diedit. Tinjau properti cluster Connect sebelum Anda mengupdate.
Peran dan izin yang diperlukan
Untuk mendapatkan izin yang
diperlukan untuk mengedit cluster Connect,
minta administrator untuk memberi Anda
peran IAM Managed Kafka Connect Cluster Editor (roles/managedkafka.connectClusterEditor) di project Anda.
Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.
Peran bawaan ini berisi izin yang diperlukan untuk mengedit cluster Connect. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:
Izin yang diperlukan
Izin berikut diperlukan untuk mengedit cluster Connect:
-
Mengupdate cluster Connect:
managedkafka.connectClusters.update -
Lihat konektor saat menggunakan konsol Google Cloud untuk mengupdate cluster Connect:
managedkafka.connectors.list
Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.
Izin subnet cluster
Jika Anda mengupdate subnet worker cluster Connect, agen layanan Managed Kafka akan melampirkan subnet selama operasi update.
Izin managedkafka.connectClusters.update secara tidak langsung memungkinkan akun utama
melampirkan subnet apa pun yang diizinkan untuk digunakan oleh agen layanan, meskipun
akun utama tidak memiliki izin langsung untuk menggunakan subnet tersebut.
Mengedit cluster Connect
Memperbarui properti tertentu, seperti CPU dan memori, memerlukan mulai ulang cluster.
Memulai ulang cluster akan mempertahankan data, tetapi dapat meningkatkan latensi. Jumlah awal worker dalam cluster menentukan durasi mulai ulang.
Anda dapat memperbarui properti cluster Connect berikut:
| Properti | Dapat diedit |
|---|---|
| vCPU | Ya |
| Memori | Ya |
| Jaringan | Ya |
| Subnet Worker | Ya |
| Domain DNS yang dapat di-resolve | Ya (Tambahkan/Hapus) |
| Nama cluster Connect | Tidak |
| Cluster Kafka | Tidak |
| Lokasi | Tidak |
| Label | Ya (Tambahkan/Edit/Hapus) |
| Rahasia | Ya (Tambahkan/Hapus) |
Konsol
Di konsol Google Cloud , buka halaman Connect Clusters.
Klik cluster Connect yang ingin Anda update.
Halaman Connect cluster details akan ditampilkan.
Klik Edit.
Halaman Edit Kafka Connect cluster akan ditampilkan.
Lakukan perubahan yang diperlukan pada properti yang dapat diedit.
Klik Simpan.
gcloud
-
Di konsol Google Cloud , aktifkan Cloud Shell.
Di bagian bawah konsol Google Cloud , sesi Cloud Shell akan terbuka dan menampilkan prompt command line. Cloud Shell adalah lingkungan shell dengan Google Cloud CLI yang sudah terinstal, dan dengan nilai yang sudah ditetapkan untuk project Anda saat ini. Diperlukan waktu beberapa detik untuk melakukan inisialisasi pada sesi.
Jalankan perintah
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]Ganti kode berikut:
- CONNECT_CLUSTER_ID: ID atau nama cluster Connect. Nama cluster Connect tidak dapat diubah.
- LOCATION: Lokasi cluster Connect. Lokasi cluster Connect tidak dapat diubah.
- CPU: Jumlah vCPU untuk cluster Connect. Nilai minimumnya adalah 3 vCPU.
- MEMORY: Jumlah memori untuk cluster Connect. Gunakan unit "MB", "MiB", "GB", "GiB", "TB", atau "TiB". Misalnya, "10GiB". Anda harus menyediakan antara 1 GiB dan 8 GiB per vCPU.
- DNS_NAME: Nama domain DNS dari jaringan subnet yang akan ditampilkan ke Connect Cluster.
- LABELS: (Opsional) Label yang akan dikaitkan dengan cluster. Untuk mengetahui informasi selengkapnya tentang format label, lihat Label. Daftar pasangan KEY=VALUE label yang akan ditambahkan. Kunci harus diawali dengan karakter huruf kecil dan hanya berisi tanda hubung (-), garis bawah (_), karakter huruf kecil, dan angka. Nilai hanya boleh berisi tanda hubung (-), garis bawah (_), karakter huruf kecil, dan angka.
- SECRET: (Opsional) Secret yang akan dimuat ke worker.
Versi Secret yang tepat dari Secret Manager harus disediakan, alias tidak didukung. Hingga 32 secret dapat dimuat ke dalam satu cluster. Format:
projects/PROJECT_ID/secrets/SECRET_NAME/versions/VERSION_ID WORKER_SUBNET: Subnet worker untuk cluster Connect. Subnet worker harus berada di region yang sama dengan cluster Connect.
Format subnet adalah
projects/PROJECT_ID/regions/REGION/subnetworks/SUBNET_ID.
Go
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Go di Menginstal library klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Go Managed Service untuk Apache Kafka.
Untuk melakukan autentikasi ke Managed Service untuk Apache Kafka, siapkan Kredensial Default Aplikasi (ADC). Untuk mengetahui informasi selengkapnya, lihat Menyiapkan ADC untuk lingkungan pengembangan lokal.
Java
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Java di Menginstal library klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Java Managed Service untuk Apache Kafka.
Untuk melakukan autentikasi ke Managed Service untuk Apache Kafka, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan ADC untuk lingkungan pengembangan lokal.
Python
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Python di Menginstal library klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi Python API Managed Service untuk Apache Kafka.
Untuk melakukan autentikasi ke Managed Service untuk Apache Kafka, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan ADC untuk lingkungan pengembangan lokal.