Todos los productos
Search

Este producto

    Container Service for Kubernetes:Customize ACK Pro control plane parameters

    Centro de documentos

    Container Service for Kubernetes:Customize ACK Pro control plane parameters

    Última actualización: Sep 21, 2026

    Ajuste la configuración de kube-apiserver, kube-controller-manager, CCM y kube-scheduler desde la consola de ACK.

    Siga los pasos que se describen a continuación para personalizar los parámetros. Después, revise los parámetros disponibles según el tipo de clúster.

    Antes de empezar

    Asegúrese de contar con lo siguiente:

    Notas de uso

    • Tipos de clúster compatibles: Solo los clústeres ACK managed Pro, ACK Serverless Pro, ACK Edge Pro y ACK Lingjun admiten la personalización de los parámetros del plano de control.

    • Reinicio del plano de control: El plano de control se reinicia después de guardar los cambios en los parámetros. Programe estos cambios fuera del horario de mayor actividad.

    • Los parámetros sobrescriben los valores predeterminados: Los parámetros personalizados reemplazan por completo los valores predeterminados. Compruebe que estén completos antes de guardarlos, ya que un parámetro incorrecto puede impedir el inicio del plano de control.

    • Restricciones de versión: Algunos parámetros requieren versiones específicas del clúster, como se indica en cada tabla. Para actualizar, consulte Manually upgrade a cluster.

    • La consola como fuente de verdad: La consola muestra la lista actual de parámetros personalizables. Las tablas siguientes reflejan los valores predeterminados documentados.

    Personalizar un parámetro de un componente del plano de control

    Los pasos son idénticos para todos los componentes. Este ejemplo utiliza kube-apiserver.

    1. Inicie sesión en la consola de administración de Container Service. En el panel de navegación izquierdo, haga clic en Clusters.

    2. En la página Clusters, haga clic en el nombre de su clúster. En el panel de navegación izquierdo, haga clic en Add-ons.

    3. En la sección Core Components, busque el componente deseado y haga clic en Configuration.

    4. En el cuadro de diálogo Parameters, introduzca los parámetros personalizados. Compruebe la configuración y siga las indicaciones en pantalla para enviarla.

    Parámetros predeterminados

    Las tablas siguientes enumeran los parámetros personalizables según el tipo de clúster. Para conocer el significado y los valores válidos de cada parámetro, consulte la documentación de Kubernetes: kube-apiserver, kube-controller-manager y kube-scheduler.

    ACK managed cluster Pro Edition

    kube-apiserver

    Parámetro Descripción Rango válido / notas
    enableAdmissionPlugins Habilita complementos adicionales del controlador de admisión. Valor predeterminado: vacío. Requiere la versión 1.28 del clúster o posterior.
    serviceNodePortRange Rango de puertos para los servicios NodePort. De 10000 a 65535. Valor predeterminado: vacío.
    Importante

    Este rango no debe superponerse con net.ipv4.ip_local_port_range en los nodos del clúster. Consulte How do I correctly configure the NodePort range?.
    requestTimeout Tiempo de espera global para las solicitudes de API sin un tiempo de espera específico. Valor predeterminado: vacío (utiliza el valor predeterminado de Kubernetes).
    defaultNotReadyTolerationSeconds Tiempo durante el cual los contenedores pueden ejecutarse en un nodo con estado NotReady antes de ser desalojados. Valor predeterminado: vacío.
    defaultUnreachableTolerationSeconds Tiempo durante el cual los contenedores pueden ejecutarse en un nodo con estado Unreachable antes de ser desalojados. Valor predeterminado: vacío.
    maxMutatingRequestsInflight Número máximo de solicitudes de API mutantes simultáneas. Las solicitudes excedentes se rechazan. De 1 a 1000. Valor predeterminado: vacío.
    maxRequestsInflight Número máximo de solicitudes de API no mutantes simultáneas. De 1 a 3000. Valor predeterminado: vacío.
    featureGates Habilita o deshabilita feature gates de Kubernetes. Valores compatibles: ServerSideApply , TTLAfterFinished , EphemeralContainers , RemoveSelfLink , HPAScaleToZero . Valor predeterminado: vacío.
    Nota

    HPAScaleToZero requiere la versión 1.18 del clúster o posterior. RemoveSelfLink no se puede modificar en la versión 1.24 del clúster o posterior.
    oidcIssuerURL URL del emisor de OpenID Connect (OIDC) para la integración con proveedores de identidad externos. Valor predeterminado: vacío. Requiere la versión 1.18 del clúster o posterior.
    Importante

    Después de establecer este parámetro, kube-apiserver accede a la dirección especificada. Si utiliza un endpoint público, enable public network access. Si el servidor de API no alcanza el endpoint, ejecute kubectl get endpoints para comprobar las direcciones IP del backend. Si se devuelven varias direcciones IP, inicie sesión en un nodo worker, acceda a oidcIssuerURL y revise la configuración de red pública y del security group. Si solo se devuelve una dirección IP, envíe un ticket.
    oidcClientId Identificador de cliente para el proveedor OIDC. Valor predeterminado: vacío. Requiere la versión 1.18 del clúster o posterior.
    oidcUsernameClaim Claim de JWT para el nombre de usuario OIDC. Valor predeterminado: sub. Requiere la versión 1.18 del clúster o posterior.
    oidcUsernamePrefix Prefijo para los nombres de usuario OIDC que evita conflictos. Valor predeterminado: vacío. Requiere la versión 1.18 del clúster o posterior.
    oidcGroupsPrefix Prefijo para los nombres de grupo OIDC. Valor predeterminado: vacío. Requiere la versión 1.18 del clúster o posterior.
    oidcGroupsClaim Claim de JWT para los grupos de usuarios OIDC. Valor predeterminado: vacío. Requiere la versión 1.18 del clúster o posterior.
    oidcRequiredClaim Pares clave-valor obligatorios en el token de ID de OIDC. Valor predeterminado: vacío. Requiere la versión 1.18 del clúster o posterior.
    oidcCAContent Contenido de la autoridad de certificación (CA) codificado en PEM para verificar el proveedor OIDC. Valor predeterminado: vacío. Requiere la versión 1.18 del clúster o posterior.
    hostAliases Asignaciones personalizadas de nombre de host a dirección IP para el archivo /etc/hosts del pod de kube-apiserver. Valor predeterminado: vacío. Requiere la versión 1.26 del clúster o posterior.
    enableTrace Habilita el rastreo distribuido para los componentes del plano de control. Valor predeterminado: vacío. Requiere la versión 1.28 del clúster o posterior. Consulte Habilitar Tracing Analysis para los componentes del plano de control.
    samplingRatePerMillion Valor predeterminado: vacío.

    kube-controller-manager

    Parámetro

    Descripción

    Rango válido / notas

    horizontalPodAutoscalerSyncPeriod

    Frecuencia con la que el controlador Horizontal Pod Autoscaler (HPA) recalcula el número deseado de réplicas.

    Valor predeterminado: vacío (utiliza el valor predeterminado de Kubernetes).

    horizontalPodAutoscalerTolerance

    Cambio mínimo de proporción necesario para que HPA active el escalado. Evita fluctuaciones constantes.

    Valor predeterminado: vacío.

    concurrentTTLAfterFinishedSyncs

    Número de workers simultáneos que limpian los trabajos finalizados cuyo TTL expiró.

    Valor predeterminado: vacío.

    concurrentHorizontalPodAutoscalerSyncs

    Número de workers de sincronización HPA simultáneos.

    Valor predeterminado: vacío. Requiere la versión 1.26 del clúster o posterior.

    largeClusterSizeThreshold

    Umbral de cantidad de nodos a partir del cual el clúster se considera "grande" para efectos de desalojo.

    Valor predeterminado: vacío.

    unhealthyZoneThreshold

    Fracción de nodos de una zona que deben estar en mal estado para activar tasas de desalojo reducidas.

    Valor predeterminado: vacío.

    secondaryNodeEvictionRate

    Tasa de desalojo de nodos en el modo secundario (reducido).

    Valor predeterminado: vacío.

    nodeEvictionRate

    Tasa normal de desalojo de nodos.

    Valor predeterminado: vacío.

    terminatedPodGCThreshold

    Cantidad de pods finalizados que activa la recolección de elementos no utilizados.

    Valor predeterminado: vacío.

    kubeAPIQPS

    Número máximo de consultas por segundo (QPS) de kube-controller-manager hacia kube-apiserver.

    De 1 a 1000. Valor predeterminado: vacío.

    kubeAPIBurst

    Ráfaga máxima de solicitudes de kube-controller-manager hacia kube-apiserver.

    De 1 a 1000. Valor predeterminado: vacío.

    concurrentCSRSyncs

    Número de workers simultáneos que procesan objetos CertificateSigningRequest (CSR).

    Valor predeterminado: vacío. Requiere la versión 1.32 del clúster o posterior.

    concurrentNodeTaintSyncs

    Número de workers simultáneos que sincronizan las condiciones de taint de los nodos.

    Valor predeterminado: vacío. Requiere la versión 1.32 del clúster o posterior.

    featureGates

    Habilita o deshabilita feature gates para el controller manager.

    Valores compatibles: TTLAfterFinished. Valor predeterminado: vacío.

    cloud-controller-manager (CCM)

    Parámetro

    Descripción

    Rango válido / notas

    routeTableIDs

    Lista separada por comas de los identificadores de tablas de enrutamiento de Virtual Private Cloud (VPC) que administra CCM.

    Valor predeterminado: vacío. Establezca este parámetro si su VPC tiene varias tablas de enrutamiento. Ejemplo: vtb-**,vtb***.

    kube-scheduler

    Para consultar los parámetros de kube-scheduler, vea Customize scheduler parameters.

    ACK serverless cluster Pro Edition

    kube-apiserver

    Parámetro Descripción Rango válido / notas
    enableAdmissionPlugins Habilita complementos adicionales del controlador de admisión. Valor predeterminado: vacío.
    requestTimeout Tiempo de espera global para las solicitudes de API sin un tiempo de espera específico. Valor predeterminado: vacío (utiliza el valor predeterminado de Kubernetes).
    defaultNotReadyTolerationSeconds Tiempo durante el cual los contenedores pueden ejecutarse en un nodo con estado NotReady antes de ser desalojados. Valor predeterminado: vacío.
    defaultUnreachableTolerationSeconds Tiempo durante el cual los contenedores pueden ejecutarse en un nodo con estado Unreachable antes de ser desalojados. Valor predeterminado: vacío.
    maxMutatingRequestsInflight Número máximo de solicitudes de API mutantes simultáneas. Las solicitudes excedentes se rechazan. De 1 a 1000. Valor predeterminado: vacío.
    maxRequestsInflight Número máximo de solicitudes de API no mutantes simultáneas. De 1 a 3000. Valor predeterminado: vacío.
    featureGates Habilita o deshabilita feature gates de Kubernetes. Valores compatibles: ServerSideApply , TTLAfterFinished , EphemeralContainers , RemoveSelfLink , HPAScaleToZero . Valor predeterminado: vacío.
    Nota

    HPAScaleToZero requiere la versión 1.18 del clúster o posterior. RemoveSelfLink no se puede modificar en la versión 1.24 del clúster o posterior.
    oidcIssuerURL URL del emisor OIDC para la integración con proveedores de identidad externos. Valor predeterminado: vacío. Requiere la versión 1.18 del clúster o posterior.
    oidcClientId Identificador de cliente para el proveedor OIDC. Valor predeterminado: vacío. Requiere la versión 1.18 del clúster o posterior.
    oidcUsernameClaim Claim de JWT para el nombre de usuario OIDC. Valor predeterminado: sub. Requiere la versión 1.18 del clúster o posterior.
    oidcUsernamePrefix Prefijo para los nombres de usuario OIDC que evita conflictos. Valor predeterminado: vacío. Requiere la versión 1.18 del clúster o posterior.
    oidcGroupsPrefix Prefijo para los nombres de grupo OIDC. Valor predeterminado: vacío. Requiere la versión 1.18 del clúster o posterior.
    oidcGroupsClaim Claim de JWT para los grupos de usuarios OIDC. Valor predeterminado: vacío. Requiere la versión 1.18 del clúster o posterior.
    oidcRequiredClaim Pares clave-valor obligatorios en el token de ID de OIDC. Valor predeterminado: vacío. Requiere la versión 1.18 del clúster o posterior.
    oidcCAContent Contenido de la CA codificado en PEM para verificar el proveedor OIDC. Valor predeterminado: vacío. Requiere la versión 1.18 del clúster o posterior.

    kube-controller-manager

    Parámetro

    Descripción

    Rango válido / notas

    horizontalPodAutoscalerSyncPeriod

    Frecuencia con la que el controlador HPA recalcula el número deseado de réplicas.

    Valor predeterminado: vacío (utiliza el valor predeterminado de Kubernetes).

    horizontalPodAutoscalerTolerance

    Cambio mínimo de proporción necesario para que HPA active el escalado.

    Valor predeterminado: vacío.

    concurrentTTLAfterFinishedSyncs

    Número de workers simultáneos que limpian los trabajos finalizados cuyo TTL expiró.

    Valor predeterminado: vacío.

    kubeAPIQPS

    Número máximo de QPS de kube-controller-manager hacia kube-apiserver.

    De 1 a 1000. Valor predeterminado: vacío.

    kubeAPIBurst

    Ráfaga máxima de solicitudes de kube-controller-manager hacia kube-apiserver.

    De 1 a 1000. Valor predeterminado: vacío.

    featureGates

    Habilita o deshabilita feature gates para el controller manager.

    Valores compatibles: TTLAfterFinished. Valor predeterminado: vacío.

    kube-scheduler

    La personalización de kube-scheduler está disponible para los usuarios incluidos en la lista de permitidos. Para consultar los parámetros compatibles, vea Customize scheduler parameters.

    ACK Edge cluster Pro Edition

    kube-apiserver

    Parámetro Descripción Rango válido / notas
    enableAdmissionPlugins Habilita complementos adicionales del controlador de admisión. Valor predeterminado: vacío.
    serviceNodePortRange Rango de puertos para los servicios NodePort. De 10000 a 65535. Valor predeterminado: vacío.
    Importante

    Este rango no debe superponerse con net.ipv4.ip_local_port_range en los nodos del clúster. Consulte How do I correctly configure the NodePort range?.
    requestTimeout Tiempo de espera global para las solicitudes de API sin un tiempo de espera específico. Valor predeterminado: vacío (utiliza el valor predeterminado de Kubernetes).
    defaultNotReadyTolerationSeconds Tiempo durante el cual los contenedores pueden ejecutarse en un nodo con estado NotReady antes de ser desalojados. Valor predeterminado: vacío.
    defaultUnreachableTolerationSeconds Tiempo durante el cual los contenedores pueden ejecutarse en un nodo con estado Unreachable antes de ser desalojados. Valor predeterminado: vacío.
    maxMutatingRequestsInflight Número máximo de solicitudes de API mutantes simultáneas. Las solicitudes excedentes se rechazan. De 1 a 1000. Valor predeterminado: vacío.
    maxRequestsInflight Número máximo de solicitudes de API no mutantes simultáneas. De 1 a 3000. Valor predeterminado: vacío.
    featureGates Habilita o deshabilita feature gates de Kubernetes. Valores compatibles: ServerSideApply , TTLAfterFinished , EphemeralContainers , RemoveSelfLink , HPAScaleToZero . Valor predeterminado: vacío.
    Nota

    HPAScaleToZero requiere la versión 1.18 del clúster o posterior. RemoveSelfLink no se puede modificar en la versión 1.24 del clúster o posterior.
    oidcIssuerURL URL del emisor OIDC para la integración con proveedores de identidad externos. Valor predeterminado: vacío. Requiere la versión 1.18 del clúster o posterior.
    oidcClientId Identificador de cliente para el proveedor OIDC. Valor predeterminado: vacío. Requiere la versión 1.18 del clúster o posterior.
    oidcUsernameClaim Claim de JWT para el nombre de usuario OIDC. Valor predeterminado: sub. Requiere la versión 1.18 del clúster o posterior.
    oidcUsernamePrefix Prefijo para los nombres de usuario OIDC que evita conflictos. Valor predeterminado: vacío. Requiere la versión 1.18 del clúster o posterior.
    oidcGroupsPrefix Prefijo para los nombres de grupo OIDC. Valor predeterminado: vacío. Requiere la versión 1.18 del clúster o posterior.
    oidcGroupsClaim Claim de JWT para los grupos de usuarios OIDC. Valor predeterminado: vacío. Requiere la versión 1.18 del clúster o posterior.
    oidcRequiredClaim Pares clave-valor obligatorios en el token de ID de OIDC. Valor predeterminado: vacío. Requiere la versión 1.18 del clúster o posterior.
    oidcCAContent Contenido de la CA codificado en PEM para verificar el proveedor OIDC. Valor predeterminado: vacío. Requiere la versión 1.18 del clúster o posterior.

    kube-controller-manager

    Parámetro

    Descripción

    Rango válido / notas

    horizontalPodAutoscalerSyncPeriod

    Frecuencia con la que el controlador HPA recalcula el número deseado de réplicas.

    Valor predeterminado: vacío (utiliza el valor predeterminado de Kubernetes).

    concurrentTTLAfterFinishedSyncs

    Número de workers simultáneos que limpian los trabajos finalizados cuyo TTL expiró.

    Valor predeterminado: vacío.

    largeClusterSizeThreshold

    Umbral de cantidad de nodos a partir del cual el clúster se considera "grande" para efectos de desalojo.

    Valor predeterminado: vacío.

    unhealthyZoneThreshold

    Fracción de nodos de una zona que deben estar en mal estado para activar tasas de desalojo reducidas.

    Valor predeterminado: vacío.

    secondaryNodeEvictionRate

    Tasa de desalojo de nodos en el modo secundario (reducido).

    Valor predeterminado: vacío.

    nodeEvictionRate

    Tasa normal de desalojo de nodos.

    Valor predeterminado: vacío.

    podEvictionTimeout

    Período de gracia antes de desalojar los pods de un nodo que no responde.

    Valor predeterminado: vacío.

    kubeAPIQPS

    Número máximo de QPS de kube-controller-manager hacia kube-apiserver.

    De 1 a 1000. Valor predeterminado: vacío.

    kubeAPIBurst

    Ráfaga máxima de solicitudes de kube-controller-manager hacia kube-apiserver.

    De 1 a 1000. Valor predeterminado: vacío.

    featureGates

    Habilita o deshabilita feature gates para el controller manager.

    Valores compatibles: TTLAfterFinished. Valor predeterminado: vacío.

    cloud-controller-manager (CCM)

    Parámetro

    Descripción

    Rango válido / notas

    routeTableIDs

    Lista separada por comas de los identificadores de tablas de enrutamiento de VPC que administra CCM.

    Valor predeterminado: vacío. Establezca este parámetro si su VPC tiene varias tablas de enrutamiento. Ejemplo: vtb-,vtb*.

    kube-scheduler

    Para consultar los parámetros de kube-scheduler, vea Customize scheduler parameters.

    ACK LINGJUN Cluster

    kube-apiserver

    Parámetro Descripción Rango válido / notas
    enableAdmissionPlugins Habilita complementos adicionales del controlador de admisión. Valor predeterminado: vacío.
    serviceNodePortRange Rango de puertos para los servicios NodePort. De 10000 a 65535. Valor predeterminado: vacío.
    Importante

    Este rango no debe superponerse con net.ipv4.ip_local_port_range en los nodos del clúster. Consulte How do I correctly configure the NodePort range?.
    requestTimeout Tiempo de espera global para las solicitudes de API sin un tiempo de espera específico. Valor predeterminado: vacío (utiliza el valor predeterminado de Kubernetes).
    defaultNotReadyTolerationSeconds Tiempo durante el cual los contenedores pueden ejecutarse en un nodo con estado NotReady antes de ser desalojados. Valor predeterminado: vacío.
    defaultUnreachableTolerationSeconds Tiempo durante el cual los contenedores pueden ejecutarse en un nodo con estado Unreachable antes de ser desalojados. Valor predeterminado: vacío.
    maxMutatingRequestsInflight Número máximo de solicitudes de API mutantes simultáneas. Las solicitudes excedentes se rechazan. De 1 a 1000. Valor predeterminado: vacío.
    maxRequestsInflight Número máximo de solicitudes de API no mutantes simultáneas. De 1 a 3000. Valor predeterminado: vacío.
    featureGates Habilita o deshabilita feature gates de Kubernetes. Valores compatibles: ServerSideApply , TTLAfterFinished , EphemeralContainers , RemoveSelfLink , HPAScaleToZero . Valor predeterminado: vacío.
    Nota

    HPAScaleToZero requiere la versión 1.18 del clúster o posterior. RemoveSelfLink no se puede modificar en la versión 1.24 del clúster o posterior.
    oidcIssuerURL URL del emisor OIDC para la integración con proveedores de identidad externos. Valor predeterminado: vacío. Requiere la versión 1.18 del clúster o posterior.
    oidcClientId Identificador de cliente para el proveedor OIDC. Valor predeterminado: vacío. Requiere la versión 1.18 del clúster o posterior.
    oidcUsernameClaim Claim de JWT para el nombre de usuario OIDC. Valor predeterminado: sub. Requiere la versión 1.18 del clúster o posterior.
    oidcUsernamePrefix Prefijo para los nombres de usuario OIDC que evita conflictos. Valor predeterminado: vacío. Requiere la versión 1.18 del clúster o posterior.
    oidcGroupsPrefix Prefijo para los nombres de grupo OIDC. Valor predeterminado: vacío. Requiere la versión 1.18 del clúster o posterior.
    oidcGroupsClaim Claim de JWT para los grupos de usuarios OIDC. Valor predeterminado: vacío. Requiere la versión 1.18 del clúster o posterior.
    oidcRequiredClaim Pares clave-valor obligatorios en el token de ID de OIDC. Valor predeterminado: vacío. Requiere la versión 1.18 del clúster o posterior.
    oidcCAContent Contenido de la CA codificado en PEM para verificar el proveedor OIDC. Valor predeterminado: vacío. Requiere la versión 1.18 del clúster o posterior.

    kube-controller-manager

    Parámetro

    Descripción

    Rango válido / notas

    horizontalPodAutoscalerSyncPeriod

    Frecuencia con la que el controlador HPA recalcula el número deseado de réplicas.

    Valor predeterminado: vacío (utiliza el valor predeterminado de Kubernetes).

    horizontalPodAutoscalerTolerance

    Cambio mínimo de proporción necesario para que HPA active el escalado.

    Valor predeterminado: vacío.

    concurrentTTLAfterFinishedSyncs

    Número de workers simultáneos que limpian los trabajos finalizados cuyo TTL expiró.

    Valor predeterminado: vacío.

    largeClusterSizeThreshold

    Umbral de cantidad de nodos a partir del cual el clúster se considera "grande" para efectos de desalojo.

    Valor predeterminado: vacío.

    unhealthyZoneThreshold

    Fracción de nodos de una zona que deben estar en mal estado para activar tasas de desalojo reducidas.

    Valor predeterminado: vacío.

    secondaryNodeEvictionRate

    Tasa de desalojo de nodos en el modo secundario (reducido).

    Valor predeterminado: vacío.

    nodeEvictionRate

    Tasa normal de desalojo de nodos.

    Valor predeterminado: vacío.

    podEvictionTimeout

    Período de gracia antes de desalojar los pods de un nodo que no responde.

    Valor predeterminado: vacío.

    kubeAPIQPS

    Número máximo de QPS de kube-controller-manager hacia kube-apiserver.

    De 1 a 1000. Valor predeterminado: vacío.

    kubeAPIBurst

    Ráfaga máxima de solicitudes de kube-controller-manager hacia kube-apiserver.

    De 1 a 1000. Valor predeterminado: vacío.

    featureGates

    Habilita o deshabilita feature gates para el controller manager.

    Valores compatibles: TTLAfterFinished. Valor predeterminado: vacío.

    cloud-controller-manager (CCM)

    Parámetro

    Descripción

    Rango válido / notas

    routeTableIDs

    Lista separada por comas de los identificadores de tablas de enrutamiento de VPC que administra CCM.

    Valor predeterminado: vacío. Establezca este parámetro si su VPC tiene varias tablas de enrutamiento. Ejemplo: vtb-,vtb*.

    kube-scheduler

    Para consultar los parámetros de kube-scheduler, vea Customize scheduler parameters.

    Siguientes pasos