Esta página se ha traducido con Cloud Translation API.

Asociar un clúster de EKS

Información general

Asociar un clúster significa conectarlo a Google Cloud registrándolo enGoogle Cloud Gestión de flotas e instalando el software de clústeres adjuntos de GKE en él.

Puedes adjuntar un clúster con la CLI de gcloud o Terraform. Para saber cómo crear y adjuntar un clúster de EKS con Terraform, consulta el repositorio de GitHub de ejemplos de clústeres adjuntos de GKE.

Esta página está dirigida a administradores de TI y operadores que quieran configurar, monitorizar y gestionar la infraestructura de la nube. Para obtener más información sobre los roles habituales y las tareas de ejemplo a las que hacemos referencia en el contenido, consulta Roles y tareas habituales de los usuarios de GKE. Google Cloud

Para asociar un clúster de EKS mediante gcloud, sigue estos pasos.

Requisitos previos

Asegúrate de que tu clúster cumpla los requisitos del clúster.

Cuando adjuntes tu clúster, debes especificar lo siguiente:

una Google Cloud región administrativa y
una versión de la plataforma.

La región administrativa es una Google Cloud región desde la que puedes administrar tu clúster adjunto. Puedes elegir cualquier región admitida, pero lo más recomendable es que elijas la región geográficamente más cercana a tu clúster. No se almacenan datos de usuario en la región administrativa.

La versión de la plataforma es la versión de los clústeres de GKE vinculados que se instalará en tu clúster. Para ver todas las versiones compatibles, ejecuta el siguiente comando:

gcloud container attached get-server-config  \
  --location=GOOGLE_CLOUD_REGION

Sustituye GOOGLE_CLOUD_REGION por el nombre de laGoogle Cloud ubicación desde la que quieres administrar el clúster.

Numeración de la versión de la plataforma

En estos documentos, se hace referencia a la versión de los clústeres adjuntos de GKE como la versión de la plataforma para distinguirla de la versión de Kubernetes. Los clústeres adjuntos de GKE usan la misma convención de numeración de versiones que GKE (por ejemplo, 1.21.5-gke.1). Cuando asocies o actualices tu clúster, debes elegir una versión de plataforma cuya versión secundaria sea igual o un nivel inferior a la versión de Kubernetes de tu clúster. Por ejemplo, puedes adjuntar un clúster que ejecute Kubernetes v1.22.* con la versión de plataforma 1.21.* o 1.22.* de clústeres adjuntos de GKE.

De esta forma, puedes actualizar tu clúster a la siguiente versión secundaria antes de actualizar los clústeres adjuntos de GKE.

Vincular un clúster de EKS

Para adjuntar tu clúster de EKS a Google Cloud Gestión de flotas, sigue estos pasos:

Asegúrate de que tu archivo kubeconfig tenga una entrada para el clúster que quieras adjuntar:
```
aws eks update-kubeconfig --region AWS_REGION \
  --name EKS_CLUSTER_NAME
```
Recupera la URL del emisor de OIDC con el siguiente comando:
```
aws eks describe-cluster \
  --region AWS_REGION \
  --name EKS_CLUSTER_NAME \
  --query "cluster.identity.oidc.issuer" \
  --output text
```
El resultado de este comando es la URL de tu emisor de OIDC. Guarda este valor para usarlo más adelante.
Ejecuta este comando para extraer el contexto kubeconfig de tu clúster y almacenarlo en la variable de entorno KUBECONFIG_CONTEXT:
```
KUBECONFIG_CONTEXT=$(kubectl config current-context)
```

Usa el comando gcloud container attached clusters register para registrar el clúster:

gcloud container attached clusters register CLUSTER_NAME \
  --location=GOOGLE_CLOUD_REGION \
  --fleet-project=PROJECT_NUMBER \
  --platform-version=PLATFORM_VERSION \
  --distribution=eks \
  --issuer-url=ISSUER_URL \
  --context=KUBECONFIG_CONTEXT \
  --kubeconfig=KUBECONFIG_PATH

Sustituye:

AWS_REGION: la región de AWS en la que se encuentra tu clúster de EKS
CLUSTER_NAME: el nombre de tu clúster. Este nombre puede ser el mismo EKS_CLUSTER_NAME que has usado en los pasos anteriores. El CLUSTER_NAME debe cumplir el estándar de nombres de etiquetas RFC 1123.
GOOGLE_CLOUD_REGION: la región Google Cloud para administrar tu clúster
PLATFORM_VERSION: la versión de los clústeres de GKE adjuntos que se va a usar en el clúster
PROJECT_NUMBER: el proyecto de host de la flota en el que se registrará el clúster
ISSUER_URL: la URL de la entidad emisora obtenida anteriormente
KUBECONFIG_CONTEXT: contexto en kubeconfig para acceder al clúster de EKS, tal como se ha extraído anteriormente
KUBECONFIG_PATH: ruta a tu kubeconfig

Nota: Si no se puede adjuntar el clúster, el sistema revierte automáticamente los cambios realizados en los recursos de Google Cloud relacionados con el clúster, como el grupo de identidades de carga de trabajo. Esto significa que no se ha establecido la conexión entre tu clúster y los clústeres adjuntos de GKE, pero tu clúster de EKS no se verá afectado. Puedes volver a intentar adjuntar el clúster después de solucionar el problema que ha provocado el error.

Autorizar Cloud Logging o Cloud Monitoring

Para que los clústeres de GKE adjuntos puedan crear y subir registros y métricas del sistema aGoogle Cloud, deben estar autorizados.

Para autorizar la identidad de carga de trabajo de Kubernetes gke-system/gke-telemetry-agent para escribir registros en Google Cloud Logging y métricas en Google Cloud Monitoring, ejecuta este comando:

gcloud projects add-iam-policy-binding GOOGLE_PROJECT_ID \
  --member="serviceAccount:GOOGLE_PROJECT_ID.svc.id.goog[gke-system/gke-telemetry-agent]" \
  --role=roles/gkemulticloud.telemetryWriter

Sustituye GOOGLE_PROJECT_ID por el ID del proyecto del clúster. Google Cloud

Este enlace de gestión de identidades y accesos concede acceso a todos los clústeres del proyecto Google Cloud project para subir registros y métricas. Solo tienes que ejecutarlo después de crear el primer clúster del proyecto.

No se podrá añadir este enlace de gestión de identidades y accesos a menos que se haya creado al menos un clúster en tu Google Cloud proyecto. Esto se debe a que el grupo de identidades de carga de trabajo al que hace referencia (GOOGLE_PROJECT_ID.svc.id.goog) no se aprovisiona hasta que se crea el clúster.