Connect クラスタを編集して、vCPU 数、メモリ、ネットワーク、ラベルなどのプロパティを更新できます。
Connect クラスタを編集するには、 Google Cloud コンソール、gcloud CLI、クライアント ライブラリ、または Managed Kafka API を使用します。オープンソースの Apache Kafka API を使用して Connect クラスタを更新することはできません。
始める前に
Connect クラスタのすべてのプロパティを編集できるわけではありません。更新する前に、Connect クラスタのプロパティを確認します。
必要なロールと権限
Connect クラスタの編集に必要な権限を取得するには、プロジェクトに対するマネージド Kafka Connect クラスタ編集者(roles/managedkafka.connectClusterEditor)IAM ロールを付与するよう管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織に対するアクセス権の管理をご覧ください。
この事前定義ロールには、Connect クラスタの編集に必要な権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。
必要な権限
Connect クラスタを編集するには、次の権限が必要です。
-
Connect クラスタを更新します。
managedkafka.connectClusters.update -
Google Cloud コンソールを使用して Connect クラスタを更新するときに、コネクタを表示する:
managedkafka.connectors.list
カスタムロールや他の事前定義ロールを使用して、これらの権限を取得することもできます。
クラスタのサブネットの権限
Connect クラスタのワーカー サブネットを更新すると、Managed Kafka サービス エージェントは更新オペレーション中にサブネットを接続します。
managedkafka.connectClusters.update 権限を使用すると、プリンシパルがサブネットを使用する直接的な権限を持っていなくても、サービス エージェントが使用する権限を持つサブネットを間接的に接続できます。
Connect クラスタを編集する
CPU やメモリなどの特定のプロパティを更新するには、クラスタの再起動が必要です。
クラスタを再起動すると、データは保持されますが、レイテンシが増加する可能性があります。クラスタ内のワーカーの初期数によって、再起動時間が決まります。
次の Connect クラスタ プロパティを更新できます。
| プロパティ | 編集可能 |
|---|---|
| vCPU | ○ |
| メモリ | ○ |
| ネットワーク | ○ |
| ワーカー サブネット | ○ |
| 解決可能な DNS ドメイン | はい(追加 / 削除) |
| Connect クラスタ名 | いいえ |
| Kafka クラスタ | いいえ |
| ロケーション | いいえ |
| ラベル | はい(追加 / 編集 / 削除) |
| シークレット | はい(追加 / 削除) |
コンソール
Google Cloud コンソールで、[Connect クラスタ] ページに移動します。
更新する Connect クラスタをクリックします。
[Connect クラスタの詳細] ページが表示されます。
[編集] をクリックします。
[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: Connect クラスタに表示されるサブネットのネットワークの DNS ドメイン名。
- LABELS:(省略可)クラスタに関連付けるラベル。ラベルの形式の詳細については、ラベルをご覧ください。追加するラベルの KEY=VALUE ペアのリスト。キーは小文字で始まり、使用できるのはハイフン(-)、アンダースコア(_)、小文字、数字のみです。値に使用できるのは、ハイフン(-)、アンダースコア(_)、小文字、数字のみです。
- SECRET: (省略可)ワーカーに読み込む Secret。Secret Manager の正確な Secret バージョンを指定する必要があります。エイリアスはサポートされていません。1 つのクラスタに最大 32 個のシークレットを読み込むことができます。形式:
projects/PROJECT_ID/secrets/SECRET_NAME/versions/VERSION_ID WORKER_SUBNET: Connect クラスタのワーカー サブネット。ワーカー サブネットは 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 の設定をご覧ください。