您可以編輯 Connect 叢集,更新 vCPU 數量、記憶體、網路和標籤等屬性。
如要編輯 Connect 叢集,可以使用 Google Cloud 控制台、gcloud CLI、用戶端程式庫或 Managed Kafka API。您無法使用開放原始碼 Apache Kafka API 更新 Connect 叢集。
事前準備
Connect 叢集的部分屬性無法編輯。更新前,請先查看 Connect 叢集的屬性。
必要角色和權限
如要取得編輯 Connect 叢集所需的權限,請要求管理員授予您專案的代管 Kafka Connect 叢集編輯者 (roles/managedkafka.connectClusterEditor) IAM 角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。
這個預先定義的角色具備編輯 Connect 叢集所需的權限。如要查看確切的必要權限,請展開「Required permissions」(必要權限) 部分:
所需權限
必須具備下列權限,才能編輯 Connect 叢集:
-
更新 Connect 叢集:
managedkafka.connectClusters.update -
使用 Google Cloud 控制台更新 Connect 叢集時,查看連接器:
managedkafka.connectors.list
叢集子網路權限
如果更新 Connect 叢集的工作站子網路,Managed Kafka 服務代理會在更新作業期間附加子網路。
managedkafka.connectClusters.update 權限可讓主體間接附加服務代理有權使用的任何子網路,即使主體沒有直接使用子網路的權限也一樣。
編輯 Connect 叢集
如要更新 CPU 和記憶體等特定屬性,必須重新啟動叢集。
重新啟動叢集會保留資料,但可能會增加延遲時間。叢集中的 worker 初始數量會決定重新啟動時間長度。
您可以更新下列 Connect 叢集屬性:
| 屬性 | 可編輯 |
|---|---|
| vCPU | 是 |
| 記憶體 | 是 |
| 網路 | 是 |
| Worker 子網路 | 是 |
| 可解析的 DNS 網域 | 是 (新增/刪除) |
| Connect 叢集名稱 | 否 |
| Kafka 叢集 | 否 |
| 位置 | 否 |
| 標籤 | 是 (新增/編輯/刪除) |
| 密鑰 | 是 (新增/刪除) |
控制台
前往 Google Cloud 控制台的「Connect Clusters」(連結叢集) 頁面。
按一下要更新的 Connect 叢集。
系統隨即會顯示「Connect cluster details」(連結叢集詳細資料) 頁面。
按一下 [編輯]。
系統隨即會顯示「Edit Kafka Connect cluster」(編輯 Kafka Connect 叢集) 頁面。
對可編輯的屬性進行必要變更。
按一下「儲存」。
gcloud
-
在 Google Cloud 控制台啟用 Cloud Shell。
Google Cloud 控制台底部會開啟 Cloud Shell 工作階段,並顯示指令列提示。Cloud Shell 是已安裝 Google Cloud CLI 的殼層環境,並已設定適用於您目前專案的值。工作階段可能要幾秒鐘的時間才能初始化。
請執行
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]更改下列內容:
- CONNECT_CLUSTER_ID:: Connect 叢集的 ID 或名稱。Connect 叢集的名稱無法變更。
- LOCATION:Connect 叢集的位置。Connect 叢集的位置無法變更。
- CPU:Connect 叢集的 vCPU 數量。最小值為 3 個 vCPU。
- MEMORY::Connect 叢集的記憶體容量。請使用「MB」、「MiB」、「GB」、「GiB」、「TB」或「TiB」單位。例如「10GiB」。每個 vCPU 必須佈建 1 GiB 至 8 GiB。
- DNS_NAME:子網路網路的 DNS 網域名稱,會向 Connect 叢集顯示。
- LABELS:(選用) 要與叢集建立關聯的標籤。如要進一步瞭解標籤格式,請參閱「標籤」。要新增的標籤「鍵=值」組合清單。鍵的開頭必須是小寫字元,且只能包含連字號 (-)、底線 (_)、小寫字元和數字。值只能使用連字號 (-)、底線 (_)、小寫字元和數字。
- SECRET:(選用) 要載入 worker 的 Secret。您必須提供 Secret Manager 的確切 Secret 版本,不支援別名。一個叢集最多可載入 32 個 Secret。格式:
projects/PROJECT_ID/secrets/SECRET_NAME/versions/VERSION_ID WORKER_SUBNET:Connect 叢集的工作站子網路。worker 子網路必須與 Connect 叢集位於相同區域。
子網路的格式為
projects/PROJECT_ID/regions/REGION/subnetworks/SUBNET_ID。
Go
在試用這個範例之前,請先按照「安裝用戶端程式庫」中的 Go 設定操作說明進行操作。詳情請參閱 Managed Service for Apache Kafka Go API 參考文件。
如要向 Managed Service for Apache Kafka 進行驗證,請設定應用程式預設憑證 (ADC)。詳情請參閱「為本機開發環境設定 ADC」。
Java
在試用這個範例之前,請先按照「安裝用戶端程式庫」中的 Java 設定操作說明進行操作。詳情請參閱 Managed Service for Apache Kafka Java API 參考文件。
如要向 Managed Service for Apache Kafka 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定 ADC」。
Python
在試用這個範例之前,請先按照「安裝用戶端程式庫」中的 Python 設定操作說明進行操作。詳情請參閱 Managed Service for Apache Kafka Python API 參考文件。
如要向 Managed Service for Apache Kafka 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定 ADC」。