Configura clústeres de Standard para usar Autopilot de forma predeterminada

Puedes configurar los clústeres de Google Kubernetes Engine (GKE) Standard para que funcionen de manera similar a los clústeres en modo Autopilot habilitando parámetros de configuración del clúster, como la ComputeClass predeterminada, las políticas de seguridad del clúster de Autopilot y la reducción de escala a cero del clúster.

Este documento está dirigido a administradores de plataformas y a ingenieros de seguridad que desean obtener todos los beneficios del modo Autopilot en un clúster de Standard con la flexibilidad de modificar o inhabilitar parámetros de configuración individuales. Si no necesitas esta flexibilidad, crea un clúster de Autopilot dedicado.

Ya deberías conocer los siguientes conceptos:

Configuración del clúster de Autopilot

Para configurar un clúster de Standard de modo que funcione como un clúster de Autopilot, establece todos los parámetros de configuración que se indican a continuación:

  • ComputeClass de Autopilot como predeterminada del clúster: Establece una de las ComputeClasses de Autopilot integradas. Los Pods que no seleccionen una ComputeClass se ejecutarán con la ComputeClass predeterminada especificada. Todas las ComputeClasses integradas usan el modo Autopilot y el modelo de facturación basado en Pods.
  • Ajusta la escala del clúster de forma automática a cero nodos: Configura el escalador automático del clúster para que ajuste la escala del clúster a cero nodos cuando no haya cargas de trabajo de usuario activas en el clúster. De manera opcional, puedes ajustar el período de retraso antes de que el escalador automático ajuste la escala del clúster a cero nodos.
  • Cero nodos iniciales: Durante la creación del clúster, evita la creación automática de un grupo de nodos predeterminado. En el caso de los clústeres existentes, borra los grupos de nodos creados de forma manual.
  • Políticas de seguridad del clúster de Autopilot: Aplica todas las políticas de seguridad de Autopilot. Estas políticas ayudan a proteger las cargas de trabajo y las identidades del sistema.

Puedes modificar tu clúster para cambiar cualquiera de estos parámetros de configuración de forma independiente de los demás parámetros de configuración. Por ejemplo, si necesitas crear un grupo de nodos de forma manual, puedes inhabilitar la política de seguridad del clúster de Autopilot correspondiente sin cambiar ninguno de los otros parámetros de configuración.

Consideraciones de flexibilidad y seguridad

Cuando creas un clúster de Autopilot, el modo de clúster es permanente. La configuración del clúster, como el escalado a cero nodos, la prevención de la creación manual de grupos de nodos y las diversas restricciones de seguridad, son inmutables. Sin embargo, cuando configuras un clúster de Standard para usar todos los parámetros de configuración de un clúster de Autopilot, los parámetros de configuración son mutables. Cualquier persona que tenga acceso para modificar las configuraciones del clúster puede cambiar o inhabilitar los parámetros de configuración individuales.

Para aplicar el uso de estos parámetros de configuración en una organización, carpeta o proyecto, los administradores de la organización pueden usar una restricción de política de la organización personalizada. Para obtener más información, consulta la sección Aplica la configuración de Autopilot con políticas de la organización personalizadas de este documento.

Limitaciones

Si configuras Confidential GKE Nodes a nivel del clúster, GKE ignora tu comando para usar una ComputeClass de Autopilot como la predeterminada del clúster.

Antes de comenzar

Antes de comenzar, asegúrate de haber realizado las siguientes tareas:

  • Habilita la API de Google Kubernetes Engine.
  • Habilitar la API de Google Kubernetes Engine
  • Si deseas usar Google Cloud CLI para esta tarea, instala y, luego, inicializa la gcloud CLI. Si ya instalaste gcloud CLI, ejecuta el comando gcloud components update para obtener la versión más reciente. Es posible que las versiones anteriores de gcloud CLI no admitan la ejecución de los comandos de este documento.
  • Asegúrate de tener un clúster de Standard que cumpla con todos los requisitos.

Requisitos

Para usar todas las funciones de Autopilot en un clúster de Standard, tu clúster debe cumplir con los siguientes requisitos:

  • El clúster debe ejecutar la versión 1.37.1-gke.3020000 o posterior de GKE. Los requisitos de versión para los parámetros de configuración individuales son los siguientes:

    • Para establecer una ComputeClass de Autopilot integrada como la predeterminada del clúster, este debe ejecutar la versión 1.37.1-gke.1380000 o posterior de GKE.
    • Para crear un clúster que no tenga nodos iniciales, el clúster debe ejecutar la versión 1.37.1-gke.1153000 o una posterior de GKE.
    • Para configurar el escalador automático de clústeres de modo que escale el clúster a cero nodos, el clúster debe ejecutar la versión 1.37.1-gke.3020000 o posterior de GKE.

    Para actualizar el clúster a una versión compatible, consulta Actualiza de forma manual el plano de control o los grupos de nodos de un clúster.

  • El clúster debe cumplir con todos los requisitos para usar ComputeClasses de Autopilot. Para verificar si tu clúster cumple con estos requisitos, consulta Ejecuta cargas de trabajo en el modo Autopilot en clústeres de Standard.

Roles y permisos requeridos

Para obtener los permisos que necesitas para crear o actualizar clústeres que usen el modo Autopilot, pídele a tu administrador que te otorgue los siguientes roles de IAM en tu proyecto de Google Cloud :

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

Crea un clúster de Standard que use el modo Autopilot

Para crear un clúster de Standard nuevo que use toda la configuración de Autopilot, ejecuta el siguiente comando:

gcloud container clusters create CLUSTER_NAME \
    --location=CONTROL_PLANE_LOCATION \
    --num-nodes=0 \
    --default-compute-class=BUILT_IN_COMPUTECLASS_NAME \
    --enable-cluster-scale-to-zero \
    --autopilot-cluster-policies=no-system-mutation,no-system-impersonation,no-unsafe-webhooks,no-standard-node-pools

Reemplaza lo siguiente:

  • CLUSTER_NAME: Es un nombre para tu clúster nuevo.
  • CONTROL_PLANE_LOCATION: Es una región para el plano de control del clúster, como us-central1.
  • BUILT_IN_COMPUTECLASS_NAME: Es la ComputeClass integrada que se usará como predeterminada del clúster, como autopilot.

De manera opcional, puedes ajustar el período de retraso antes de que el escalador automático del clúster escale el clúster a cero nodos con la marca --cluster-scale-to-zero-delay:

gcloud container clusters create CLUSTER_NAME \
    --location=CONTROL_PLANE_LOCATION \
    --num-nodes=0 \
    --default-compute-class=BUILT_IN_COMPUTECLASS_NAME \
    --enable-cluster-scale-to-zero \
    --cluster-scale-to-zero-delay=SCALE_TO_ZERO_DELAY \
    --autopilot-cluster-policies=no-system-mutation,no-system-impersonation,no-unsafe-webhooks,no-standard-node-pools

Reemplaza SCALE_TO_ZERO_DELAY por la duración del retraso. Este valor debe especificar un número entero y una unidad de tiempo, como 0s, 1m o 3h. La demora máxima es de 3 horas. Si no especificas la marca --cluster-scale-to-zero-delay, la demora predeterminada es de 3 horas.

Si el comando de creación del clúster falla y muestra un mensaje de error, consulta el mensaje de error para obtener más información. Los errores más comunes son los siguientes:

  • Tu clúster usa una versión que no admite una de las marcas especificadas. Para resolver este error, actualiza tu clúster a la versión mínima requerida, como se especifica en la sección Requisitos.
  • Especificaste marcas de configuración del grupo de nodos (como la marca --machine-type) en el comando de creación del clúster. Debido a que tu clúster nuevo no tiene un grupo de nodos inicial, no puedes especificar marcas de configuración del grupo de nodos. Para resolver este error, quita las marcas de configuración del grupo de nodos de tu comando.
  • Especificaste el nombre de una ComputeClass personalizada para la marca --default-compute-class. Para resolver este error, especifica una de las ComputeClasses integradas de Autopilot.

Actualiza un clúster de Standard existente para usar el modo Autopilot

Puedes modificar un clúster de Standard existente para usar el modo Autopilot. Este proceso implica cambios potencialmente disruptivos en tus cargas de trabajo, como borrar grupos de nodos creados de forma manual. Realiza estos pasos durante un período de mantenimiento programado.

  1. Verifica que tu clúster cumpla con todos los requisitos de este documento.

  2. Revisa tu clúster y realiza los cambios necesarios para evitar conflictos con las políticas de clúster de Autopilot. Para obtener más información sobre los posibles cambios, consulta Políticas compatibles.

  3. Cuando configuras una ComputeClass de Autopilot como la predeterminada del clúster, los Pods entrantes que no seleccionan una ComputeClass diferente se convierten en cargas de trabajo de Autopilot. Verifica las cargas de trabajo que no seleccionan una ComputeClass para las siguientes propiedades:

    • Verifica que tus cargas de trabajo cumplan con las restricciones de seguridad de Autopilot o configura una lista de entidades permitidas para las cargas de trabajo con privilegios.
    • Busca y quita los selectores de nodos cloud.google.com/gke-nodepool o las reglas de afinidad de nodos de los Pods.
    • Verifica si algún espacio de nombres tiene la etiqueta cloud.google.com/default-compute-class o cloud.google.com/default-compute-class-non-daemonset. Las ComputeClasses predeterminadas a nivel de espacio de nombres tienen prioridad sobre la ComputeClass predeterminada a nivel de clúster.
  4. Verifica si el clúster tiene una ComputeClass personalizada llamada default:

    kubectl get computeclass default -o yaml
    

    Si el resultado está en blanco, continúa con el siguiente paso. Si existe la ComputeClass default, el resultado es similar al siguiente:

    apiVersion: cloud.google.com/v1
    kind: ComputeClass
    metadata:
      annotations:
        cloud.google.com/gke-managed-default-compute-class: "true"
      name: default
    # Multiple lines are omitted here.
    

    En el resultado, si la anotación cloud.google.com/gke-managed-default-compute-class: "true" está en el campo metadata.annotations, ve al siguiente paso. Si esta anotación no existe, borra la ComputeClass:

    kubectl delete computeclass default
    
  5. Busca y borra los grupos de nodos existentes creados de forma manual en el clúster.

  6. Habilita la configuración de Autopilot para el clúster:

    1. Establece la ComputeClass predeterminada del clúster en una ComputeClass integrada:

      gcloud container clusters update CLUSTER_NAME \
          --location=CONTROL_PLANE_LOCATION \
          --default-compute-class=BUILT_IN_COMPUTECLASS_NAME
      

      Reemplaza lo siguiente:

      • CLUSTER_NAME: Es el nombre de tu clúster estándar existente.
      • CONTROL_PLANE_LOCATION: Es la región del plano de control del clúster.
      • BUILT_IN_COMPUTECLASS_NAME: Es la ComputeClass de Autopilot integrada que se usará como predeterminada del clúster, como autopilot.
      1. Habilita el escalado automático de clústeres y permite que el escalador automático escale el clúster a cero nodos:

        gcloud container clusters update CLUSTER_NAME \
            --location=CONTROL_PLANE_LOCATION \
            --enable-autoscaling \
            --enable-cluster-scale-to-zero
        

        De manera opcional, puedes ajustar el período de retraso antes de que el escalador automático del clúster reduzca la escala del clúster a cero nodos con la marca --cluster-scale-to-zero-delay:

        gcloud container clusters update CLUSTER_NAME \
            --location=CONTROL_PLANE_LOCATION \
            --enable-autoscaling \
            --enable-cluster-scale-to-zero \
            --cluster-scale-to-zero-delay=SCALE_TO_ZERO_DELAY
        

        Reemplaza SCALE_TO_ZERO_DELAY por la duración del retraso. Este valor debe especificar un número entero y una unidad de tiempo, como 0s, 1m o 3h. La demora máxima es de 3 horas. Si no especificas la marca --cluster-scale-to-zero-delay, la demora predeterminada es de 3 horas.

      2. Habilita las políticas del clúster de Autopilot:

        gcloud container clusters update CLUSTER_NAME \
            --location=CONTROL_PLANE_LOCATION \
            --autopilot-cluster-policies=no-system-mutation,no-system-impersonation,no-unsafe-webhooks,no-standard-node-pools
        

    Si alguno de los comandos de actualización del clúster falla y muestra un mensaje de error, consulta el mensaje de error para obtener más información. Los errores más comunes son los siguientes:

    • Tu clúster usa una versión que no admite una de las marcas especificadas. Para resolver este error, actualiza tu clúster a la versión mínima requerida, como se especifica en la sección Requisitos.
    • Especificaste el nombre de una ComputeClass personalizada para la marca --default-compute-class. Para resolver este error, especifica una de las ComputeClasses integradas de Autopilot.
    • Tu clúster tiene grupos de nodos creados de forma manual, por lo que GKE no puede aplicar de manera forzosa la política no-standard-node-pools. Para resolver este error, borra los grupos de nodos creados de forma manual.

Verifica que tu clúster use el modo Autopilot

Después de configurar tu clúster nuevo o existente, verifica que la configuración de Autopilot esté activa:

  1. Verifica que la ComputeClass predeterminada, la reducción de escala a cero y la configuración de la política del clúster estén habilitadas en el clúster:

    gcloud container clusters describe CLUSTER_NAME \
        --location=CONTROL_PLANE_LOCATION \
        --format="yaml(autoscaling.defaultComputeClassConfig,autoscaling.scaleToZeroConfig,autopilot.clusterPolicyConfig)"
    

    El resultado es similar a lo siguiente:

    autoscaling:
      defaultComputeClassConfig:
        computeClass: autopilot
        enabled: true
      scaleToZeroConfig:
        enabled: true
        delay: 3h
    autopilot:
      clusterPolicyConfig:
        noManualNodePools: true
        noSystemImpersonation: true
        noSystemMutation: true
        noUnsafeWebhooks: true
    
  2. Verifica que GKE haya creado la ComputeClass default administrada en tu clúster:

    kubectl get computeclass default -o yaml
    

    El resultado es similar a lo siguiente:

    Si el resultado está en blanco, continúa con el siguiente paso. Si existe la ComputeClass default, el resultado es similar al siguiente:

    apiVersion: cloud.google.com/v1
    kind: ComputeClass
    metadata:
      annotations:
        cloud.google.com/gke-managed-default-compute-class: "true"
      name: default
    # Multiple lines are omitted here.
    spec:
      autopilot:
        enabled: true
    # Multiple lines are omitted here.
    

    En este resultado, la anotación cloud.google.com/gke-managed-default-compute-class: "true" indica que GKE creó la ComputeClass.

  3. Cuando implementes un Pod que no seleccione una ComputeClass diferente, verifica que el Pod se ejecute en un nodo administrado por Autopilot:

    kubectl get pods -o wide
    

    En el resultado, los nodos que administra Autopilot tienen el prefijo gk3- en la columna NODE.

Modifica o inhabilita parámetros de configuración individuales de Autopilot

Debido a que cada capacidad de Autopilot en un clúster de Standard es modular, puedes personalizar o inhabilitar parámetros de configuración individuales en cualquier momento. Si eres administrador de seguridad, puedes usar restricciones de políticas de la organización personalizadas para aplicar estos parámetros de configuración. Para obtener más información, consulta Aplica la configuración de Autopilot con políticas de la organización personalizadas.

Aplica la configuración de Autopilot con políticas de la organización personalizadas

Debido a que los usuarios que tienen permisos de actualización de clústeres pueden modificar o inhabilitar la configuración de Autopilot en los clústeres de Standard, los administradores de la organización pueden usar restricciones de políticas de la organización personalizadas en el servicio de políticas de la organización para aplicar esta configuración en una organización, carpeta o proyecto. En el siguiente ejemplo de restricción, se rechazan las operaciones de creación o actualización de clústeres que no aplican de manera forzosa todos los parámetros de configuración de Autopilot:

name: organizations/ORGANIZATION_ID/customConstraints/custom.enforceAutopilotSettings
resourceTypes:
- container.googleapis.com/Cluster
methodTypes:
- CREATE
condition: >-
  "resource.ClusterPolicyConfig.no_system_mutation != true ||
  resource.ClusterPolicyConfig.no_system_impersonation != true ||
  resource.ClusterPolicyConfig.no_unsafe_webhooks != true ||
  resource.ClusterPolicyConfig.no_standard_node_pools != true ||
  resource.ScaleToZeroConfig.enabled != true ||
  !(resource.DefaultComputeClassConfig.computeClass in [
    'autopilot', 'autopilot-spot', 'autopilot-arm', 'autopilot-arm-spot'
  ])"
actionType: DENY
displayName: Enforce Autopilot cluster policies in Standard clusters
description: All new clusters must use all Autopilot settings by default.

Reemplaza ORGANIZATION_ID por el ID de tu organización.

¿Qué sigue?