Adjunta tu clúster de EKS

Descripción general

Conectar un clúster significa conectarlo a Google Cloud. Para ello, debes registrarlo en la administración de flotas de Google Cloud y, luego, instalar en él el software de clústeres conectados de GKE.

Puedes conectar un clúster con gcloud CLI o Terraform. Para aprender a crear y conectar un clúster de EKS mediante Terraform, consulta el repositorio de muestras de GitHub para clústeres conectados a GKE.

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

Requisitos previos

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

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

La región administrativa es una región de Google Cloud desde la cual administrar el clúster conectado. Puedes elegir cualquier región compatible, pero la práctica recomendada es elegir la región geográfica más cercana a tu clúster. No se almacenan datos del usuario en la región administrativa.

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

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

Reemplaza GOOGLE_CLOUD_REGION por el nombre de la ubicación de Google Cloud desde la que administrarás 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 conectados de GKE como la versión de la plataforma para distinguirla de la versión de Kubernetes. Los clústeres conectados de GKE usan la misma convención de numeración de versiones que GKE, por ejemplo, 1.21.5-gke.1. Cuando conectas o actualizas tu clúster, debes elegir una versión de la plataforma cuya versión secundaria sea igual a la versión de Kubernetes del clúster o un nivel inferior a ella. Por ejemplo, puedes conectar un clúster que ejecute Kubernetes v1.22.* con los clústeres conectados a GKE versión 1.21.* o 1.22.*.

Esto te permite actualizar tu clúster a la siguiente versión secundaria antes de actualizar los clústeres conectados de GKE.

Adjunta un clúster de EKS

Para conectar el clúster de EKS a la administración de flotas de Google Cloud, sigue estos pasos:

  1. Asegúrate de que tu archivo kubeconfig tenga una entrada para el clúster que deseas adjuntar:

    aws eks update-kubeconfig --region AWS_REGION \
      --name CLUSTER_NAME
    
  2. Recupera la URL de la entidad emisora de OIDC con el siguiente comando:

    aws eks describe-cluster \
      --region AWS_REGION \
      --name CLUSTER_NAME \
      --query "cluster.identity.oidc.issuer" \
      --output text
    

    El resultado de este comando es la URL de la entidad emisora de OIDC. Guarda este valor para usarlo más adelante.

  3. Ejecuta este comando para extraer el contexto kubeconfig del clúster y almacenarlo en la variable de entorno KUBECONFIG_CONTEXT:

    KUBECONFIG_CONTEXT=$(kubectl config current-context)
    
  4. 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
    

    Reemplaza lo siguiente:

  • AWS_REGION: Es la región de AWS en la que se encuentra el clúster de EKS.
  • CLUSTER_NAME: Es el nombre de tu clúster.
  • GOOGLE_CLOUD_REGION: Es la región de Google Cloud que se usará para administrar el clúster.
  • PLATFORM_VERSION: Es la versión de los clústeres conectados de GKE que se usará para el clúster.
  • PROJECT_NUMBER: Es el proyecto host de la flota en el que se registrará el clúster.
  • ISSUER_URL: La URL de la entidad emisora se recuperó antes
  • KUBECONFIG_CONTEXT: Es el contexto en kubeconfig para acceder al clúster de EKS, como se extrajo antes.
  • KUBECONFIG_PATH: Es la ruta de acceso a tu kubeconfig.

Autoriza Cloud Logging/Cloud Monitoring

Para que los clústeres conectados de GKE creen y suban registros y métricas del sistema a Google Cloud, se deben autorizar.

Para autorizar la identidad de carga de trabajo de Kubernetes gke-system/gke-telemetry-agent a fin de 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

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

Esta vinculación de IAM otorga acceso a todos los clústeres del proyecto de Google Cloud para subir registros y métricas. Solo necesitas ejecutarlo después de crear tu primer clúster para el proyecto.

La adición de esta vinculación de IAM fallará, a menos que se cree al menos un clúster en tu proyecto de Google Cloud. Esto se debe a que el grupo de identidades para cargas de trabajo al que se refiere (GOOGLE_PROJECT_ID.svc.id.goog) no se aprovisiona hasta que se crea el clúster.