Debes registrar el clúster de GKE en el entorno de tu proyecto mediante Connect. Un Environ proporciona una manera unificada de ver y administrar varios clústeres y sus cargas de trabajo. Puedes obtener más información sobre los Environ y la funcionalidad que habilitan en nuestra guía de Environ.
No es necesario que registres todos los clústeres a la vez, pero no aparecerán en la página de clústeres de Anthos en Cloud Console hasta que lo hagas.
Usar la herramienta de línea de comandos de gcloud
te brinda algunas opciones de registro de clústeres más avanzadas que no están disponibles en Cloud Console, como la descarga y la aplicación del manifiesto del agente de Connect. Para obtener más información sobre estas opciones, consulta las opciones avanzadas de registro en la documentación de Connect.
Antes de comenzar
Asegúrate de tener los permisos necesarios para registrar el clúster.
Asegúrate de que tu proyecto host de Environ tenga las API necesarias habilitadas para registrar el clúster.
Registra tu clúster
gcloud
Determina si Workload Identity está habilitado en tu clúster de GKE
Ejecuta el siguiente comando para enumerar qué grupo de Workload Identity del clúster es miembro de
gcloud container clusters describe GKE_CLUSTER --format="value(workloadIdentityConfig.workloadPool)"
Reemplaza lo siguiente:
- GKE_CLUSTER: el
name
del clúster de GKE del proyecto actual.
Si ves un resultado similar al siguiente, Workload Identity ya está habilitado en su clúster de GKE y puedes pasar directamente a “Registrar el clúster” a continuación.
GKE_PROJECT_ID.svc.id.goog
Si no hay resultados, Workload Identity no está habilitada en el clúster de GKE. Continúa habilitando Workload Identity en tu clúster de GKE antes de continuar con el registro del clúster.
- GKE_CLUSTER: el
Habilitar Workload Identity
Sigue atentamente las instrucciones vinculadas para habilitar GKE Workload Identity. Cuando habilitas GKE Workload Identity, se modifica el comportamiento de autenticación de los nuevos grupos de nodos creados después de que se habilita, lo que puede afectar a las aplicaciones que dependen de las cuentas de servicio conectadas a las instancias de Compute Engine en el grupo de nodos.
Registra el clúster
Ejecuta cualquiera de los siguientes comandos para registrar el clúster:
gcloud beta container hub memberships register MEMBERSHIP_NAME \ --gke-uri=GKE_URI \ --enable-workload-identity
o
gcloud beta container hub memberships register MEMBERSHIP_NAME \ --gke-cluster=GKE_CLUSTER \ --enable-workload-identity
Reemplaza lo siguiente:
- MEMBERSHIP_NAME: Es el nombre de la membresía que eliges para representar de forma única el clúster que se registra en Hub.
- GKE_URI: Es el URI del clúster de GKE, por ejemplo:
https://container.googleapis.com/v1/projects/my-gke-project/locations/us-central1-a/clusters/my-gke-cluster
. Para obtener el URI, ejecutagcloud container clusters list --uri
. - GKE_CLUSTER: Es el
location/name
del clúster de GKE del proyecto actual. La ubicación puede ser una zona o una región, por ejemplo:us-central1-a/my-gke-cluster
.
¿Qué sigue?
- Obtén más información sobre el grupo de comandos de gcloud container hub.