Adjuntar el clúster de AKS

Asociar un clúster significa conectarlo a Google Cloud registrándolo con Google 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 AKS con Terraform, consulta el repositorio de GitHub de ejemplos de clústeres adjuntos de GKE.

Para adjuntar un clúster de AKS 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 admitida
• 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.

Adjuntar el clúster de AKS

Nota: El número predeterminado de clústeres que puedes adjuntar por proyecto es 50. Para aumentar esta cuota, ponte en contacto con el Google Cloud equipo de Asistencia.

Para adjuntar tu clúster de AKS a Google Cloud Gestión de flotas, ejecuta los siguientes comandos:

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

   az aks get-credentials -n AKS_CLUSTER_NAME \
     -g RESOURCE_GROUP
   

2. 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)
   

3. El comando para registrar tu clúster varía ligeramente en función de si lo has configurado con el emisor de OIDC privado predeterminado o con el público experimental. Elige la pestaña que corresponda a tu clúster:

   Entidad emisora de OIDC privada (opción predeterminada)

   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=aks \
     --context=KUBECONFIG_CONTEXT \
     --has-private-issuer \
     --kubeconfig=KUBECONFIG_PATH
   

   Haz los cambios siguientes:

   • CLUSTER_NAME: el nombre de tu clúster. Este nombre puede ser el mismo AKS_CLUSTER_NAME que has usado en el paso 1. El CLUSTER_NAME debe cumplir el estándar de nombres de etiquetas RFC 1123.
   • GOOGLE_CLOUD_REGION: la región Google Cloud desde la que administrar tu clúster
   • PROJECT_NUMBER: el proyecto de host de la flota en el que se registrará el clúster
   • PLATFORM_VERSION: la versión de la plataforma que se va a usar en el clúster.
   • KUBECONFIG_CONTEXT: contexto en kubeconfig para acceder al clúster de AKS
   • KUBECONFIG_PATH: ruta a tu kubeconfig

   Entidad emisora de OIDC pública

   1. Obtén la URL del emisor de OIDC de tu clúster con el siguiente comando:

        az aks show -n CLUSTER_NAME \
          -g RESOURCE_GROUP \
          --query "oidcIssuerProfile.issuerUrl" -otsv
      

      Sustituye RESOURCE_GROUP por el grupo de recursos de AKS al que pertenece tu clúster.

      El resultado de este comando será la URL de tu emisor de OIDC. Guarda este valor para usarlo más adelante.

   2. 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)
      

   3. 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=aks \
        --issuer-url=ISSUER_URL \
        --context=KUBECONFIG_CONTEXT \
        --kubeconfig=KUBECONFIG_PATH
      

      Haz los cambios siguientes:

      • CLUSTER_NAME: el nombre de tu clúster. Este nombre puede ser el mismo AKS_CLUSTER_NAME que has usado en el paso 1. 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
      • PROJECT_NUMBER: el proyecto host de la flota en el que se registrará el clúster
      • PLATFORM_VERSION: la versión de los clústeres de GKE adjuntos que se va a usar en el clúster
      • ISSUER_URL: la URL de la entidad emisora obtenida anteriormente
      • KUBECONFIG_CONTEXT: contexto del archivo kubeconfig para acceder al clúster, 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 relacionados con el clúster, como el grupo de identidades de carga de trabajo. Google Cloud 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 AKS 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

Nota: A partir de la versión 1.28 de Kubernetes, ya no es necesario vincular manualmente la política para autorizar a la cuenta de servicio gke-system/gke-telemetry-agent a recoger registros y métricas. Ahora, los permisos necesarios se conceden automáticamente a esta cuenta de servicio. Por lo tanto, puedes ignorar esta sección.

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.