Personalización de la configuración de nodos en los grupos de nodos de Azure Kubernetes Service (AKS)

Al personalizar la configuración del nodo, puede ajustar la configuración del sistema operativo (SO) o los parámetros de kubelet para satisfacer las necesidades de las cargas de trabajo. Al crear un clúster de AKS o agregar un grupo de nodos al clúster, puede personalizar un subconjunto de los valores de configuración de kubelet y del sistema operativo más usados. Para configurar opciones más allá de este subconjunto, utilice un DaemonSet para personalizar las configuraciones que necesite sin perder la compatibilidad de AKS para sus nodos.

Prerequisites

A medida que el servicio incorpora compatibilidad con nuevas opciones de configuración y parámetros de kubelet, es posible que sea necesario registrar indicadores de características en versión preliminar. Si se requiere un indicador de versión preliminar, la referencia de parámetros de configuración del nodo personalizado lo indica.

Las configuraciones de kubelet kubeReserved, hardEvictionThreshold, softEvictionThreshold, softEvictionGracePeriod y evictionMaxPodGracePeriodInSeconds están en versión preliminar y requieren el indicador de característica CustomNodeConfigPreview. Esta configuración le permite personalizar las reservas de recursos y los umbrales de expulsión, que también se configuran mediante AKS Node Hardening. Para conocer los pasos de registro, los valores predeterminados y los ejemplos, consulte Node Hardening (versión preliminar) en AKS.

Creación de archivos de configuración de nodos personalizados para grupos de nodos de AKS

Para cambiar la configuración del sistema operativo y kubelet, cree un nuevo archivo de configuración con los parámetros y la configuración que desee. Si no especifica un valor para un parámetro, se usa el valor predeterminado.

Nota

En los ejemplos siguientes se muestran las opciones de configuración comunes. Modifique la configuración para cumplir los requisitos de carga de trabajo. Para obtener la lista completa de parámetros de configuración personalizados admitidos, consulte Parámetros de configuración de nodo personalizados para AKS.

Configuración de kubelet

Cree un archivo linuxkubeletconfig.json con el siguiente contenido:

{
 "cpuManagerPolicy": "static",
 "cpuCfsQuota": true,
 "cpuCfsQuotaPeriod": "200ms",
 "imageGcHighThreshold": 90,
 "imageGcLowThreshold": 70,
 "topologyManagerPolicy": "best-effort",
 "allowedUnsafeSysctls": [
  "kernel.msg*",
  "net.*"
],
 "failSwapOn": false
}

Para personalizar los recursos kube-reserved y los umbrales de expulsión en grupos de nodos de Linux, consulte Personalizar la configuración de refuerzo de nodos.

Configuración del sistema operativo

Cree un archivo linuxosconfig.json con el siguiente contenido:

{
 "transparentHugePageEnabled": "madvise",
 "transparentHugePageDefrag": "defer+madvise",
 "swapFileSizeMB": 1500,
 "sysctls": {
  "netCoreSomaxconn": 163849,
  "netIpv4TcpTwReuse": true,
  "netIpv4IpLocalPortRange": "32000 60000"
 }
}

Creación de un clúster de AKS mediante archivos de configuración personalizados

Nota

Tenga en cuenta la siguiente información al usar archivos de configuración personalizados al crear un nuevo clúster de AKS:

  • Si especifica una configuración al crear un clúster, la configuración solo se aplica a los nodos del grupo de nodos inicial. El clúster conserva los valores predeterminados de las opciones que no están configuradas en el archivo JSON.
  • CustomLinuxOsConfig no es compatible con el tipo de sistema operativo Windows.
  • Las configuraciones de kubelet de vista previa kubeReserved y de umbral de expulsión solo se admiten para los grupos de nodos de Linux y requieren la marca de característica CustomNodeConfigPreview. Para conocer los pasos de registro, consulte Node Hardening (versión preliminar) en AKS.

Crear un clúster nuevo con archivos de configuración personalizados ejecutando el comando az aks create y especificando los archivos de configuración para los parámetros --kubelet-config y --linux-os-config. El siguiente comando de ejemplo crea un nuevo clúster con los archivos personalizados ./linuxkubeletconfig.json y ./linuxosconfig.json:

az aks create --name <cluster-name> --resource-group <resource-group-name> --kubelet-config ./linuxkubeletconfig.json --linux-os-config ./linuxosconfig.json

Adición de un grupo de nodos mediante archivos de configuración personalizados

Nota

Tenga en cuenta la siguiente información al usar archivos de configuración personalizados para agregar un nuevo grupo de nodos a un clúster de AKS existente:

  • Al agregar un grupo de nodos de Linux a un clúster existente, puede especificar la configuración de kubelet, la configuración del sistema operativo, o ambas. Cuando se agrega un grupo de nodos Windows a un clúster existente, sólo se puede especificar la configuración de kubelet. Si especifica una configuración al agregar un grupo de nodos, la configuración solo se aplica a los nodos del nuevo grupo de nodos. El grupo de nodos conserva los valores predeterminados de las opciones que no están configuradas en el archivo JSON.
  • CustomKubeletConfig es compatible con los grupos de nodos de Linux y Windows.
  • Las configuraciones de kubelet de vista previa kubeReserved y del umbral de expulsión solo se admiten para los grupos de nodos de Linux y requieren la marca de característica CustomNodeConfigPreview. Para conocer los pasos de registro, consulte Node Hardening (versión preliminar) en AKS.

Cree un nuevo grupo de nodos de Linux mediante el az aks nodepool add comando y especifique los archivos de configuración para los --kubelet-config parámetros y --linux-os-config . El siguiente comando de ejemplo crea un nuevo grupo de nodos de Linux con el archivo personalizado ./linuxkubeletconfig.json :

az aks nodepool add --name <node-pool-name> --cluster-name <cluster-name> --resource-group <resource-group-name> --kubelet-config ./linuxkubeletconfig.json

Confirmación de que se aplicó la configuración

Después de aplicar la configuración de nodo personalizada, puede confirmar que la configuración se aplicó a los nodos conectándose al host y comprobandosysctl o realizando cambios de configuración en el sistema de archivos.

Revisión de los parámetros de configuración personalizados admitidos

Para obtener la lista completa de parámetros de configuración de kubelet y Linux compatibles, valores permitidos, valores predeterminados y descripciones, consulte Parámetros de configuración de nodo personalizados para AKS.

Consideraciones sobre las configuraciones de nodo personalizadas

Tenga en cuenta las siguientes consideraciones al personalizar la configuración del nodo:

  • Las actualizaciones de imágenes de nodo vuelven a aplicar configuraciones de nodo personalizadas.
  • Las operaciones de escalado horizontal conservan las configuraciones de nodos personalizadas.
  • AKS no realiza la validación previa al vuelo para cada parámetro o valor de configuración de nodo personalizado. Asegúrese de que los valores y parámetros de configuración de nodo personalizados que especifique son compatibles y válidos para evitar posibles problemas con los nodos del clúster.
  • La configuración de kubelet de vista previa kubeReserved y de umbral de expulsión solo está disponible en grupos de nodos de Linux. Si los configura, use las reglas de emparejamiento, unidades y intervalos admitidos en la referencia de parámetros de configuración de nodo personalizado.
  • Los valores predeterminados para los parámetros de configuración de nodos personalizados suelen cambiar con las nuevas versiones del sistema operativo. Al aplicar configuraciones de nodo personalizadas, revise los valores predeterminados de los parámetros que está configurando para asegurarse de que las opciones personalizadas son adecuadas para la versión del sistema operativo de los nodos del clúster.
  • Limite el número de personas que tienen permisos para modificar la configuración del nodo personalizado para evitar consecuencias imprevistas en la estabilidad y el rendimiento del clúster. Considere usar Microsoft Entra ID para la autorización de la API de Kubernetes para restringir el acceso a la configuración del clúster.
  • Separe los grupos de nodos con configuraciones personalizadas de aquellas sin configuraciones personalizadas para evitar consecuencias imprevistas en las cargas de trabajo que podrían ser sensibles a determinados cambios de configuración. Por ejemplo, si tiene una carga de trabajo crítica que requiere una configuración específica de kubelet, considere la posibilidad de aislar esa carga de trabajo en un grupo de nodos dedicado con la configuración de kubelet personalizada necesaria.

Contenido relacionado

  • Se actualizó por última vez el