Ajuste as configurações do kube-apiserver, kube-controller-manager, CCM e kube-scheduler pelo console do ACK.
Personalize os parâmetros seguindo as etapas abaixo e consulte os parâmetros disponíveis por tipo de cluster.
Antes de começar
Verifique se você tem:
Um cluster ACK Pro (gerenciado, serverless, Edge ou LINGJUN)
Permissões para modifique add-ons do cluster no Container Service Management Console
Notas de uso
Tipos de cluster compatíveis: Somente os clusters ACK managed Pro, ACK Serverless Pro, ACK Edge Pro e ACK Lingjun são compatíveis com a personalização de parâmetros do plano de controle.
Reinicialização do plano de controle: O plano de controle reinicia após salvar as alterações de parâmetros. Agende as alterações fora dos horários de pico.
Parâmetros substituem os padrões: Os parâmetros personalizados substituem completamente os valores padrão. Verifique a completude antes de salvar — parâmetros incorretos podem impedir a inicialização do plano de controle.
Restrições de versão: Alguns parâmetros exigem versões específicas do cluster, conforme indicado em cada tabela de parâmetros. Para fazer upgrade, consulte Manually upgrade a cluster.
Console como fonte oficial: O console exibe a lista atual de parâmetros personalizáveis. As tabelas abaixo refletem os valores padrão documentados.
Personalizar um parâmetro de componente do plano de controle
As etapas são idênticas para todos os componentes. Este exemplo usa o kube-apiserver.
Acesse o Container Service Management Console. No painel de navegação à esquerda, clique em Clusters.
Na página Clusters, clique no nome do cluster. No painel de navegação à esquerda, clique em Add-ons.
Na seção Core Components, localize o componente desejado e clique em Configuration.
Na caixa de diálogo Parameters, insira os parâmetros personalizados. Verifique a configuração e siga as instruções na tela para envie.
Parâmetros padrão
As tabelas abaixo listam os parâmetros personalizáveis por tipo de cluster. Para conhecer a semântica dos parâmetros e os valores válidos, consulte a documentação do Kubernetes: kube-apiserver, kube-controller-manager e kube-scheduler.
ACK managed cluster Pro Edition
kube-apiserver
| Parâmetro | Descrição | Intervalo válido / notas |
|---|---|---|
enableAdmissionPlugins |
Ativa plugins adicionais de controlador de admissão. | Padrão: em branco. Exige versão do cluster 1,28 ou posterior. |
serviceNodePortRange |
Intervalo de portas para serviços NodePort. |
10000–65535. Padrão: em branco.
Importante
Este intervalo não deve se sobrepor ao |
requestTimeout |
Timeout global para requisições de api sem timeout específico. | Padrão: em branco (usa o padrão do Kubernetes). |
defaultNotReadyTolerationSeconds |
Tempo que containers podem permanecer em execução em um nó no estado NotReady antes da remoção. | Padrão: em branco. |
defaultUnreachableTolerationSeconds |
Tempo que containers podem permanecer em execução em um nó no estado Unreachable antes da remoção. | Padrão: em branco. |
maxMutatingRequestsInflight |
Número máximo de requisições de api mutantes simultâneas. Requisições excedentes são rejeitadas. | 1–1000. Padrão: em branco. |
maxRequestsInflight |
Número máximo de requisições de api não mutantes simultâneas. | 1–3000. Padrão: em branco. |
featureGates |
Ativa ou desativa feature gates do Kubernetes. |
Valores suportados:
ServerSideApply
,
TTLAfterFinished
,
EphemeralContainers
,
RemoveSelfLink
,
HPAScaleToZero
. Padrão: em branco.
Nota
|
oidcIssuerURL |
URL do emissor OpenID Connect (OIDC) para integração com provedor de identidade externo. |
Padrão: em branco. Exige versão do cluster 1,18 ou posterior.
Importante
Após definir este parâmetro, o kube-apiserver acessa o endereço especificado. Para um endpoint público, ative public network access. Se o servidor de api não conseguir alcançar o endpoint, execute |
oidcClientId |
id do cliente para o provedor OIDC. | Padrão: em branco. Exige versão do cluster 1,18 ou posterior. |
oidcUsernameClaim |
Claim JWT para o nome de usuário OIDC. | Padrão: sub. Exige versão do cluster 1,18 ou posterior. |
oidcUsernamePrefix |
Prefixo para nomes de usuário OIDC a fim de evitar conflitos. | Padrão: em branco. Exige versão do cluster 1,18 ou posterior. |
oidcGroupsPrefix |
Prefixo para nomes de grupos OIDC. | Padrão: em branco. Exige versão do cluster 1,18 ou posterior. |
oidcGroupsClaim |
Claim JWT para grupos de usuários OIDC. | Padrão: em branco. Exige versão do cluster 1,18 ou posterior. |
oidcRequiredClaim |
Pares chave-valor obrigatórios no token id do OIDC. | Padrão: em branco. Exige versão do cluster 1,18 ou posterior. |
oidcCAContent |
Conteúdo da autoridade certificadora (CA) codificado em PEM para verificar o provedor OIDC. | Padrão: em branco. Exige versão do cluster 1,18 ou posterior. |
hostAliases |
Mapeamentos personalizados de hostname para ip no arquivo /etc/hosts do pod do kube-apiserver. |
Padrão: em branco. Exige versão do cluster 1,26 ou posterior. |
enableTrace |
Ativa o rastreamento distribuído para componentes do plano de controle. | Padrão: em branco. Exige versão do cluster 1,28 ou posterior. Consulte Enable Tracing Analysis for control plane components. |
samplingRatePerMillion |
Padrão: em branco. |
kube-controller-manager
|
Parâmetro |
Descrição |
Intervalo válido / notas |
|
|
Frequência com que o controlador HPA recalcula a quantidade desejada de réplicas. |
Padrão: em branco (usa o padrão do Kubernetes). |
|
|
Variação mínima na proporção antes de o HPA acionar o dimensionamento. Evita oscilações. |
Padrão: em branco. |
|
|
Número de workers simultâneos que limpam jobs concluídos com TTL expirado. |
Padrão: em branco. |
|
|
Número de workers de sincronização HPA simultâneos. |
Padrão: em branco. Exige versão do cluster 1,26 ou posterior. |
|
|
Limiar de contagem de nós acima do qual o cluster é tratado como "grande" para fins de remoção. |
Padrão: em branco. |
|
|
Fração de nós em uma zona que deve estar não saudável para acionar taxas de remoção reduzidas. |
Padrão: em branco. |
|
|
Taxa de remoção de nós no modo de remoção secundário (reduzido). |
Padrão: em branco. |
|
|
Taxa normal de remoção de nós. |
Padrão: em branco. |
|
|
Número de pods encerrados que aciona a coleta de lixo. |
Padrão: em branco. |
|
|
Máximo de queries por segundo (QPS) do kube-controller-manager para o kube-apiserver. |
1–1000. Padrão: em branco. |
|
|
Burst máximo de requisições do kube-controller-manager para o kube-apiserver. |
1–1000. Padrão: em branco. |
|
|
Número de workers simultâneos que processam objetos CertificateSigningRequest (CSR). |
Padrão: em branco. Exige versão do cluster 1.32 ou posterior. |
|
|
Número de workers simultâneos que sincronizam condições de taint de nós. |
Padrão: em branco. Exige versão do cluster 1.32 ou posterior. |
|
|
Ativa ou desativa feature gates para o controller manager. |
Valores suportados: |
cloud-controller-manager (CCM)
|
Parâmetro |
Descrição |
Intervalo válido / notas |
|
|
Lista separada por vírgulas de ids de tabelas de rotas da VPC que o CCM deve gerencie. |
Padrão: em branco. Defina este parâmetro se sua VPC tiver múltiplas tabelas de rotas. Exemplo: |
kube-scheduler
Para os parâmetros do kube-scheduler, consulte Customize scheduler parameters.
ACK serverless cluster Pro Edition
kube-apiserver
| Parâmetro | Descrição | Intervalo válido / notas |
|---|---|---|
enableAdmissionPlugins |
Ativa plugins adicionais de controlador de admissão. | Padrão: em branco. |
requestTimeout |
Timeout global para requisições de api sem timeout específico. | Padrão: em branco (usa o padrão do Kubernetes). |
defaultNotReadyTolerationSeconds |
Tempo que containers podem permanecer em execução em um nó no estado NotReady antes da remoção. | Padrão: em branco. |
defaultUnreachableTolerationSeconds |
Tempo que containers podem permanecer em execução em um nó no estado Unreachable antes da remoção. | Padrão: em branco. |
maxMutatingRequestsInflight |
Número máximo de requisições de api mutantes simultâneas. Requisições excedentes são rejeitadas. | 1–1000. Padrão: em branco. |
maxRequestsInflight |
Número máximo de requisições de api não mutantes simultâneas. | 1–3000. Padrão: em branco. |
featureGates |
Ativa ou desativa feature gates do Kubernetes. |
Valores suportados:
ServerSideApply
,
TTLAfterFinished
,
EphemeralContainers
,
RemoveSelfLink
,
HPAScaleToZero
. Padrão: em branco.
Nota
|
oidcIssuerURL |
URL do emissor OIDC para integração com provedor de identidade externo. | Padrão: em branco. Exige versão do cluster 1,18 ou posterior. |
oidcClientId |
id do cliente para o provedor OIDC. | Padrão: em branco. Exige versão do cluster 1,18 ou posterior. |
oidcUsernameClaim |
Claim JWT para o nome de usuário OIDC. | Padrão: sub. Exige versão do cluster 1,18 ou posterior. |
oidcUsernamePrefix |
Prefixo para nomes de usuário OIDC a fim de evitar conflitos. | Padrão: em branco. Exige versão do cluster 1,18 ou posterior. |
oidcGroupsPrefix |
Prefixo para nomes de grupos OIDC. | Padrão: em branco. Exige versão do cluster 1,18 ou posterior. |
oidcGroupsClaim |
Claim JWT para grupos de usuários OIDC. | Padrão: em branco. Exige versão do cluster 1,18 ou posterior. |
oidcRequiredClaim |
Pares chave-valor obrigatórios no token id do OIDC. | Padrão: em branco. Exige versão do cluster 1,18 ou posterior. |
oidcCAContent |
Conteúdo da CA codificado em PEM para verificar o provedor OIDC. | Padrão: em branco. Exige versão do cluster 1,18 ou posterior. |
kube-controller-manager
|
Parâmetro |
Descrição |
Intervalo válido / notas |
|
|
Frequência com que o controlador HPA recalcula a quantidade desejada de réplicas. |
Padrão: em branco (usa o padrão do Kubernetes). |
|
|
Variação mínima na proporção antes de o HPA acionar o dimensionamento. |
Padrão: em branco. |
|
|
Número de workers simultâneos que limpam jobs concluídos com TTL expirado. |
Padrão: em branco. |
|
|
Máximo de QPS do kube-controller-manager para o kube-apiserver. |
1–1000. Padrão: em branco. |
|
|
Burst máximo de requisições do kube-controller-manager para o kube-apiserver. |
1–1000. Padrão: em branco. |
|
|
Ativa ou desativa feature gates para o controller manager. |
Valores suportados: |
kube-scheduler
A personalização do kube-scheduler está disponível para usuários na lista de permissões. Para os parâmetros suportados, consulte Customize scheduler parameters.
ACK Edge cluster Pro Edition
kube-apiserver
| Parâmetro | Descrição | Intervalo válido / notas |
|---|---|---|
enableAdmissionPlugins |
Ativa plugins adicionais de controlador de admissão. | Padrão: em branco. |
serviceNodePortRange |
Intervalo de portas para serviços NodePort. |
10000–65535. Padrão: em branco.
Importante
Este intervalo não deve se sobrepor ao |
requestTimeout |
Timeout global para requisições de api sem timeout específico. | Padrão: em branco (usa o padrão do Kubernetes). |
defaultNotReadyTolerationSeconds |
Tempo que containers podem permanecer em execução em um nó no estado NotReady antes da remoção. | Padrão: em branco. |
defaultUnreachableTolerationSeconds |
Tempo que containers podem permanecer em execução em um nó no estado Unreachable antes da remoção. | Padrão: em branco. |
maxMutatingRequestsInflight |
Número máximo de requisições de api mutantes simultâneas. Requisições excedentes são rejeitadas. | 1–1000. Padrão: em branco. |
maxRequestsInflight |
Número máximo de requisições de api não mutantes simultâneas. | 1–3000. Padrão: em branco. |
featureGates |
Ativa ou desativa feature gates do Kubernetes. |
Valores suportados:
ServerSideApply
,
TTLAfterFinished
,
EphemeralContainers
,
RemoveSelfLink
,
HPAScaleToZero
. Padrão: em branco.
Nota
|
oidcIssuerURL |
URL do emissor OIDC para integração com provedor de identidade externo. | Padrão: em branco. Exige versão do cluster 1,18 ou posterior. |
oidcClientId |
id do cliente para o provedor OIDC. | Padrão: em branco. Exige versão do cluster 1,18 ou posterior. |
oidcUsernameClaim |
Claim JWT para o nome de usuário OIDC. | Padrão: sub. Exige versão do cluster 1,18 ou posterior. |
oidcUsernamePrefix |
Prefixo para nomes de usuário OIDC a fim de evitar conflitos. | Padrão: em branco. Exige versão do cluster 1,18 ou posterior. |
oidcGroupsPrefix |
Prefixo para nomes de grupos OIDC. | Padrão: em branco. Exige versão do cluster 1,18 ou posterior. |
oidcGroupsClaim |
Claim JWT para grupos de usuários OIDC. | Padrão: em branco. Exige versão do cluster 1,18 ou posterior. |
oidcRequiredClaim |
Pares chave-valor obrigatórios no token id do OIDC. | Padrão: em branco. Exige versão do cluster 1,18 ou posterior. |
oidcCAContent |
Conteúdo da CA codificado em PEM para verificar o provedor OIDC. | Padrão: em branco. Exige versão do cluster 1,18 ou posterior. |
kube-controller-manager
|
Parâmetro |
Descrição |
Intervalo válido / notas |
|
|
Frequência com que o controlador HPA recalcula a quantidade desejada de réplicas. |
Padrão: em branco (usa o padrão do Kubernetes). |
|
|
Número de workers simultâneos que limpam jobs concluídos com TTL expirado. |
Padrão: em branco. |
|
|
Limiar de contagem de nós acima do qual o cluster é tratado como "grande" para fins de remoção. |
Padrão: em branco. |
|
|
Fração de nós em uma zona que deve estar não saudável para acionar taxas de remoção reduzidas. |
Padrão: em branco. |
|
|
Taxa de remoção de nós no modo de remoção secundário (reduzido). |
Padrão: em branco. |
|
|
Taxa normal de remoção de nós. |
Padrão: em branco. |
|
|
Período de tolerância antes que os pods em um nó sem resposta sejam removidos. |
Padrão: em branco. |
|
|
Máximo de QPS do kube-controller-manager para o kube-apiserver. |
1–1000. Padrão: em branco. |
|
|
Burst máximo de requisições do kube-controller-manager para o kube-apiserver. |
1–1000. Padrão: em branco. |
|
|
Ativa ou desativa feature gates para o controller manager. |
Valores suportados: |
cloud-controller-manager (CCM)
|
Parâmetro |
Descrição |
Intervalo válido / notas |
|
|
Lista separada por vírgulas de ids de tabelas de rotas da VPC que o CCM deve gerencie. |
Padrão: em branco. Defina este parâmetro se sua VPC tiver múltiplas tabelas de rotas. Exemplo: vtb-,vtb*. |
kube-scheduler
Para os parâmetros do kube-scheduler, consulte Customize scheduler parameters.
ACK LINGJUN Cluster
kube-apiserver
| Parâmetro | Descrição | Intervalo válido / notas |
|---|---|---|
enableAdmissionPlugins |
Ativa plugins adicionais de controlador de admissão. | Padrão: em branco. |
serviceNodePortRange |
Intervalo de portas para serviços NodePort. |
10000–65535. Padrão: em branco.
Importante
Este intervalo não deve se sobrepor ao |
requestTimeout |
Timeout global para requisições de api sem timeout específico. | Padrão: em branco (usa o padrão do Kubernetes). |
defaultNotReadyTolerationSeconds |
Tempo que containers podem permanecer em execução em um nó no estado NotReady antes da remoção. | Padrão: em branco. |
defaultUnreachableTolerationSeconds |
Tempo que containers podem permanecer em execução em um nó no estado Unreachable antes da remoção. | Padrão: em branco. |
maxMutatingRequestsInflight |
Número máximo de requisições de api mutantes simultâneas. Requisições excedentes são rejeitadas. | 1–1000. Padrão: em branco. |
maxRequestsInflight |
Número máximo de requisições de api não mutantes simultâneas. | 1–3000. Padrão: em branco. |
featureGates |
Ativa ou desativa feature gates do Kubernetes. |
Valores suportados:
ServerSideApply
,
TTLAfterFinished
,
EphemeralContainers
,
RemoveSelfLink
,
HPAScaleToZero
. Padrão: em branco.
Nota
|
oidcIssuerURL |
URL do emissor OIDC para integração com provedor de identidade externo. | Padrão: em branco. Exige versão do cluster 1,18 ou posterior. |
oidcClientId |
id do cliente para o provedor OIDC. | Padrão: em branco. Exige versão do cluster 1,18 ou posterior. |
oidcUsernameClaim |
Claim JWT para o nome de usuário OIDC. | Padrão: sub. Exige versão do cluster 1,18 ou posterior. |
oidcUsernamePrefix |
Prefixo para nomes de usuário OIDC a fim de evitar conflitos. | Padrão: em branco. Exige versão do cluster 1,18 ou posterior. |
oidcGroupsPrefix |
Prefixo para nomes de grupos OIDC. | Padrão: em branco. Exige versão do cluster 1,18 ou posterior. |
oidcGroupsClaim |
Claim JWT para grupos de usuários OIDC. | Padrão: em branco. Exige versão do cluster 1,18 ou posterior. |
oidcRequiredClaim |
Pares chave-valor obrigatórios no token id do OIDC. | Padrão: em branco. Exige versão do cluster 1,18 ou posterior. |
oidcCAContent |
Conteúdo da CA codificado em PEM para verificar o provedor OIDC. | Padrão: em branco. Exige versão do cluster 1,18 ou posterior. |
kube-controller-manager
|
Parâmetro |
Descrição |
Intervalo válido / notas |
|
|
Frequência com que o controlador HPA recalcula a quantidade desejada de réplicas. |
Padrão: em branco (usa o padrão do Kubernetes). |
|
|
Variação mínima na proporção antes de o HPA acionar o dimensionamento. |
Padrão: em branco. |
|
|
Número de workers simultâneos que limpam jobs concluídos com TTL expirado. |
Padrão: em branco. |
|
|
Limiar de contagem de nós acima do qual o cluster é tratado como "grande" para fins de remoção. |
Padrão: em branco. |
|
|
Fração de nós em uma zona que deve estar não saudável para acionar taxas de remoção reduzidas. |
Padrão: em branco. |
|
|
Taxa de remoção de nós no modo de remoção secundário (reduzido). |
Padrão: em branco. |
|
|
Taxa normal de remoção de nós. |
Padrão: em branco. |
|
|
Período de tolerância antes que os pods em um nó sem resposta sejam removidos. |
Padrão: em branco. |
|
|
Máximo de QPS do kube-controller-manager para o kube-apiserver. |
1–1000. Padrão: em branco. |
|
|
Burst máximo de requisições do kube-controller-manager para o kube-apiserver. |
1–1000. Padrão: em branco. |
|
|
Ativa ou desativa feature gates para o controller manager. |
Valores suportados: |
cloud-controller-manager (CCM)
|
Parâmetro |
Descrição |
Intervalo válido / notas |
|
|
Lista separada por vírgulas de ids de tabelas de rotas da VPC que o CCM deve gerencie. |
Padrão: em branco. Defina este parâmetro se sua VPC tiver múltiplas tabelas de rotas. Exemplo: vtb-,vtb*. |
kube-scheduler
Para os parâmetros do kube-scheduler, consulte Customize scheduler parameters.