Todos os produtos
Search
Central de documentação

Container Service for Kubernetes:Kube API server

Última atualização: Oct 23, 2026

O kube-apiserver é o ponto central de controle e o gateway de API de um cluster Kubernetes. Este tópico descreve o componente kube-apiserver, seu uso e suas notas de versão.

Visão geral

O kube-apiserver valida e configura dados para objetos da API, como pods, Services e ReplicationControllers. Ele atende a operações REST e fornece o frontend para o estado compartilhado do cluster, utilizado por todos os outros componentes na interação com o sistema.

Uso

O componente kube-apiserver vem instalado por padrão e não requer configuração adicional.

Notas de versão

O componente kube-apiserver é atualizado a cada nova versão do Kubernetes. Para mais informações, consulte Overview of Kubernetes versions supported by ACK.

  • Em novos clusters com Kubernetes 1.20 ou posterior criados após fevereiro de 2023, o acesso aos Services do Kubernetes no namespace padrão foi otimizado: o tráfego agora passa por uma elastic network interface (ENI) em vez de um Classic Load Balancer (CLB). Essa alteração reduz a sobrecarga de desempenho ao eliminar uma camada intermediária de encaminhamento.

    Importante

    Se o grupo de segurança dos nós e de seus contêineres for diferente do grupo de segurança do cluster — e este último restringir o tráfego de entrada na porta 6443 —, os componentes do sistema podem falhar ao se conectar ao API server.

  • Para novos clusters criados após novembro de 2024 com versão 1.20 ou posterior, quando os componentes kubelet e kube-proxy nos nós do cluster acessam o service API Server, o processo de descoberta de service para o API Server foi otimizado. Em vez de usar um endereço IP fixo de Classic Load Balancer (CLB), o sistema agora resolve o nome de domínio do API Server (apiserver.{Your Cluster ID}.{Region ID}.cs.aliyuncs.com) para o endereço IP de uma elastic network interface (ENI). Essa otimização melhora ainda mais a alta disponibilidade (HA) do cluster.

    Importante
    • Caso o grupo de segurança do cluster restrinja o tráfego de entrada na porta 6443, os nós não conseguirão se conectar ao API server.

    • O ACK fornece e gerencia o nome de domínio do API server, apiserver.{Your-Cluster-ID}.{Region-ID}.cs.aliyuncs.com, por meio do Private DNS. Visualize esse domínio na seção Cloud Service Defined Zones do console do Alibaba Cloud DNS.

    • A resolução do nome de domínio do API server depende dos endereços padrão dos resolvedores de Private DNS (100.100.2.136 e 100.100.2.138) na sua VPC da Alibaba Cloud. Se você utilizar um servidor DNS personalizado nos nós, garanta que os resolvedores padrão de Private DNS na VPC upstream continuem resolvendo o nome de domínio do API server. Caso contrário, seus nós podem falhar ao acessar o API server. Proceda com cautela.