É necessário registrar seu cluster do GKE com a frota do seu projeto usando o Connect. Uma frota é uma maneira unificada de visualizar e gerenciar vários clusters e as respectivas cargas de trabalho. Saiba mais sobre as frotas e a funcionalidade que elas permitem no nosso guia de frotas.
Não é preciso registrar todos os clusters de uma só vez, mas eles não aparecerão na página dos clusters do GKE Enterprise no console do Google Cloud até que você os registre.
Usar a Google Cloud CLI fornece algumas opções de registro de cluster mais avançadas que não estão disponíveis no console do Google Cloud, incluindo o download e a aplicação do manifesto do agente do Connect por conta própria. Para saber mais sobre essas opções, consulte opções avançadas de registro na documentação do Connect.
Antes de começar
Verifique se você tem as permissões necessárias para registrar o cluster.
Verifique se o projeto host do ambiente tem as APIs necessárias ativadas para registrar o cluster.
Como registrar o cluster
gcloud
Verifique se o cluster tem a identidade da carga de trabalho do GKE ativada, seguindo as instruções nos nossos pré-requisitos.
Execute um dos seguintes comandos para registrar o cluster:
gcloud container fleet memberships register MEMBERSHIP_NAME \ --gke-uri=GKE_URI \ --enable-workload-identity
ou
gcloud container fleet memberships register MEMBERSHIP_NAME \ --gke-cluster=GKE_CLUSTER \ --enable-workload-identity
Substitua:
- MEMBERSHIP_NAME: o nome da assinatura que você escolhe para representar de maneira exclusiva o cluster que está sendo registrado na frota.
- GKE_URI: o URI do cluster do GKE,
por exemplo:
https://container.googleapis.com/v1/projects/my-gke-project/locations/us-central1-a/clusters/my-gke-cluster
. Para conseguir o URI, executegcloud container clusters list --uri
. - GKE_CLUSTER: a
location/name
do cluster do GKE do projeto atual. O local pode ser uma zona ou região, por exemplo:us-central1-a/my-gke-cluster
.
Se você quiser instalar o agente do Connect no cluster, adicione a flag
--install-connect-agent
opcional a qualquer um dos comandos, como no exemplo a seguir. Por padrão, sem essa flag, o agente não é instalado.gcloud container fleet memberships register MEMBERSHIP_NAME \ --gke-cluster=GKE_CLUSTER \ --enable-workload-identity \
--install-connect-agent
A seguir
- Saiba mais sobre o grupo de comandos gcloud container hub.