Connect を使用して、GKE クラスタをプロジェクトのフリートに登録する必要があります。フリートにより、複数のクラスタとそのワークロードを表示し、一元的に管理できます。フリートと有効にできる機能の詳細については、フリートガイドをご覧ください。
すべてのクラスタを同時に登録する必要はありませんが、クラスタを登録しないと、Google Cloud コンソールの GKE Enterprise の [クラスタ] ページにクラスタが表示されません。
Google Cloud CLI を使用すると、Connect Agent マニフェストのダウンロードと適用など、Google Cloud コンソールでは利用できない高度なクラスタ登録オプションを使用できます。これらのオプションの詳細については、Connect のドキュメントの高度な登録オプションをご覧ください。
始める前に
クラスタの登録に必要な権限があることを確認します。
フリート ホスト プロジェクトでクラスタを登録するために必要な API が有効になっていることを確認します。
クラスタの登録
gcloud
前提条件の手順に沿って、クラスタで GKE Workload Identity が有効になっていることを確認します。
次のいずれかのコマンドを実行してクラスタを登録します。
gcloud container fleet memberships register MEMBERSHIP_NAME \ --gke-uri=GKE_URI \ --enable-workload-identity
または
gcloud container fleet memberships register MEMBERSHIP_NAME \ --gke-cluster=GKE_CLUSTER \ --enable-workload-identity
以下を置き換えます。
- MEMBERSHIP_NAME: フリートに登録されているクラスタを一意に表すために選択したメンバーシップ名。
- GKE_URI: GKE クラスタの URI(例:
https://container.googleapis.com/v1/projects/my-gke-project/locations/us-central1-a/clusters/my-gke-cluster
)。URI を取得するには、gcloud container clusters list --uri
を実行します。 - GKE_CLUSTER: 現在のプロジェクトの GKE クラスタの
location/name
。ロケーションは、ゾーンまたはリージョンのいずれかです(例:us-central1-a/my-gke-cluster
)。
クラスタに Connect Agent をインストールする場合は、次の例のようにコマンドにオプションの
--install-connect-agent
フラグを追加します。デフォルトでは、エージェントはインストールされません(インストールするには、このフラグを指定する必要があります)。gcloud container fleet memberships register MEMBERSHIP_NAME \ --gke-cluster=GKE_CLUSTER \ --enable-workload-identity \
--install-connect-agent
次のステップ
- gcloud container hub コマンド グループについて詳細を確認する。