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:
- Modo Autopilot de GKE
- Acerca de las cargas de trabajo del modo Autopilot en GKE Standard
- ComputeClasses de GKE
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 updatepara 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 :
-
Crea y actualiza clústeres y grupos de nodos:
Administrador de clústeres de Kubernetes Engine (
roles/container.clusterAdmin) -
Administra ComputeClasses y cargas de trabajo en el clúster:
Desarrollador de Kubernetes Engine (
roles/container.developer)
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, comous-central1.BUILT_IN_COMPUTECLASS_NAME: Es la ComputeClass integrada que se usará como predeterminada del clúster, comoautopilot.
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.
Verifica que tu clúster cumpla con todos los requisitos de este documento.
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.
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-nodepoolo las reglas de afinidad de nodos de los Pods. - Verifica si algún espacio de nombres tiene la etiqueta
cloud.google.com/default-compute-classocloud.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.
Verifica si el clúster tiene una ComputeClass personalizada llamada
default:kubectl get computeclass default -o yamlSi 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 campometadata.annotations, ve al siguiente paso. Si esta anotación no existe, borra la ComputeClass:kubectl delete computeclass defaultBusca y borra los grupos de nodos existentes creados de forma manual en el clúster.
Habilita la configuración de Autopilot para el clúster:
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_NAMEReemplaza 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, comoautopilot.
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-zeroDe 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_DELAYReemplaza
SCALE_TO_ZERO_DELAYpor la duración del retraso. Este valor debe especificar un número entero y una unidad de tiempo, como0s,1mo3h. 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.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:
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: trueVerifica que GKE haya creado la ComputeClass
defaultadministrada en tu clúster:kubectl get computeclass default -o yamlEl 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.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 wideEn el resultado, los nodos que administra Autopilot tienen el prefijo
gk3-en la columnaNODE.
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.
- Inhabilita políticas específicas de Autopilot en tu clúster, como
no-standard-node-pools. - Inhabilita la ComputeClass predeterminada a nivel del clúster. Como alternativa, puedes
establecer una ComputeClass personalizada como la predeterminada del clúster creando una ComputeClass
llamada
default. Evita que el clúster se ajuste de forma automática a cero nodos:
gcloud container clusters update CLUSTER_NAME \ --location=CONTROL_PLANE_LOCATION \ --no-enable-cluster-scale-to-zero
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?
- Más información sobre las cargas de trabajo de Autopilot en GKE Standard
- Ejecuta cargas de trabajo en modo Autopilot en clústeres Standard
- Aplica ComputeClasses a los Pods de forma predeterminada
- Aplica políticas de seguridad de Autopilot en clústeres de Standard
- Escala automáticamente un clúster