Cloud Controller Manager: Visão geral e changelog - Container Compute Service: Central de Documentação do Alibaba Cloud

O Cloud Controller Manager (CCM) gerencia serviços de balanceamento de carga em clusters Kubernetes. Este tópico apresenta o CCM e descreve suas notas de uso e notas de versão.

Introdução

O CCM integra o Kubernetes aos serviços de infraestrutura da Alibaba Cloud e gerencia serviços de balanceamento de carga em clusters ACS, incluindo Classic Load Balancer (CLB) e Network Load Balancer (NLB).

Quando o tipo de um Service é definido como Type=LoadBalancer, o CCM cria ou configura um CLB ou NLB para esse Service, incluindo recursos como instâncias de CLB ou NLB, listeners e servidores de backend.
Se os endpoints de um Service ou os nós do cluster forem alterados, o CCM atualiza automaticamente os grupos de servidores de backend da instância de CLB ou NLB criada para o Service.

Notas de uso

Para obter mais informações sobre como usar o CCM no gerenciamento de serviços de balanceamento de carga, consulte os seguintes tópicos:
- Antes de configurar o balanceamento de carga, observe as considerações importantes. Para mais detalhes, consulte Considerações para configurar um Service LoadBalancer.
- Para saber mais sobre a configuração de balanceamento de carga, consulte Usar uma instância SLB criada automaticamente para expor uma aplicação e Usar uma instância SLB existente para expor uma aplicação.
- Também é possível personalizar o balanceamento de carga adicionando anotações às configurações do Service. O Cloud Controller Manager suporta configurações personalizadas. Para mais informações, consulte Adicionar anotações ao arquivo YAML de um Service para configurar instâncias CLB.
Caso o CCM falhe na pré-verificação de atualização, consulte Como resolver o problema de falha na pré-verificação de atualização do CCM para solucionar o problema.

Notas de versão

Abril de 2026

Versão

Endereço da imagem

Data

Alterações

Impacto

v2.14.0

registry-cn-hangzhou.ack.aliyuncs.com/acs/cloud-controller-manager:v2.14.0

13 de abril de 2026

Novos recursos:

O NLB agora suporta a anotação service.beta.kubernetes.io/alibaba-cloud-loadbalancer-ip-version: "DualStack" para associar backends IPv4 e IPv6 a um grupo de servidores com afinidade automática de versão de IP.
O NLB agora suporta o campo spec.loadBalancerSourceRanges para especificar quais intervalos de source podem acessar o Service.
A anotação service.beta.kubernetes.io/alibaba-cloud-loadbalancer-default-weight agora configura ou atualiza o peso padrão de um grupo de servidores.

Esta atualização não afeta suas cargas de trabalho.

Janeiro de 2026

Versão

Endereço da imagem

Data

Descrição

Impacto

v2.13.0

registry-cn-hangzhou.ack.aliyuncs.com/acs/cloud-controller-manager:v2.13.0

30 de janeiro de 2026

Novos recursos:

O CLB agora permite adicionar certificados de domínio adicionais a listeners HTTPS por meio da anotação service.beta.kubernetes.io/alibaba-cloud-loadbalancer-domain-extensions.
O NLB agora permite adicionar certificados adicionais a listeners TCPSSL usando a anotação service.beta.kubernetes.io/alibaba-cloud-loadbalancer-additional-cert-ids.
O NLB agora suporta a configuração de encaminhamento entre zonas (ativado por padrão) por meio da anotação service.beta.kubernetes.io/alibaba-cloud-loadbalancer-cross-zone-enabled.

Otimizações:

A lógica de anexação de ENI foi aprimorada para que uma falha em um pod não bloqueie outras anexações.
O controlador agora seleciona automaticamente um vSwitch ao criar um CLB privado sem que nenhum seja especificado.

Esta atualização não tem impacto nas suas cargas de trabalho.

Dezembro de 2025

Versão

Endereço da imagem

Data de lançamento

Descrição

Impacto

v2.12.4

registry-cn-hangzhou.ack.aliyuncs.com/acs/cloud-controller-manager:v2.12.4

11 de dezembro de 2025

Novo recurso:

Adicionado suporte a webhook de readiness gate para Pods, ativado por padrão em novos clusters. Consulte Configurar readiness gates para garantir atualizações suaves de Pods.

Problema corrigido:

Corrigido um problema em que a exclusão de um Service do tipo NLB não limpava automaticamente o grupo de servidores associado.

Esta atualização não tem impacto nas cargas de trabalho.

Novembro de 2025

Versão

Endereço da imagem

Data de lançamento

Descrição

Impacto

v2.12.3

registry-cn-hangzhou.ack.aliyuncs.com/acs/cloud-controller-manager:v2.12.3

19 de novembro de 2025

Melhoria:

O log de erros do CLB agora inclui o nome do pod (targetRef) e informações do nó quando o CCM não consegue encontrar a elastic network interface (ENI) para um IP de pod de backend.

Problema corrigido:

Corrigido um possível panic durante a sincronização de Services ao consultar informações do NLB ou quando uma chamada de tarefa assíncrona falha.

Esta atualização não impacta suas cargas de trabalho.

Setembro de 2025

Versão	Endereço da imagem	Data de lançamento	Descrição	Impacto
v2.12.1	registry-cn-hangzhou.ack.aliyuncs.com/acs/cloud-controller-manager:v2.12.1	11 de setembro de 2025	Importante A partir desta versão, o método de faturamento padrão para instâncias CLB recém-criadas muda de Pay-By-Spec para Pay-By-CLCU. As instâncias CLB existentes não são afetadas. Consulte [Alterações no Produto] Mudança no tipo padrão de balanceador de carga e método de faturamento para novos Services e Nginx Ingress Controller. Novos recursos: Altera o método de faturamento padrão para instâncias CLB recém-criadas de Pay-By-Spec para Pay-By-CLCU. Melhorias: Aumenta a velocidade e o desempenho do processamento de CLB e NLB. Adiciona um número limitado de tentativas de espera e nova tentativa quando as chamadas da OpenAPI do NLB sofrem limitação de taxa. Otimiza métricas relacionadas à latência de sincronização para Services, rotas e nós. Altera o tempo de espera para nova tentativa de `readinessGate` de backoff exponencial para um valor fixo. Problemas corrigidos: Corrige um problema em que o `targetPort` do backend não era usado corretamente como porta de verificação de integridade em configurações de NLB que utilizam tanto um intervalo de portas de listener quanto uma verificação de integridade configurada manualmente.	Esta atualização não tem impacto nas suas cargas de trabalho.

Julho de 2025

Versão	Endereço da imagem	Data de lançamento	Descrição	Impacto
v2.11.4	registry-cn-hangzhou.ack.aliyuncs.com/acs/cloud-controller-manager:v2.11.4	17 de julho de 2025	Correções de bugs Corrigido um problema em que a criação de um intervalo de portas de listener NLB usando `service.beta.kubernetes.io/alibaba-cloud-loadbalancer-listener-port-range` falhava.	Esta atualização não tem impacto nos serviços existentes.

Junho de 2025

Versão	Endereço da imagem	Data de atualização	Alterações	Impacto
v2.11.3	registry-cn-hangzhou.ack.aliyuncs.com/acs/cloud-controller-manager:v2.11.3	27 de junho de 2025	Melhoria: Ignora a chamada da OpenAPI para adicionar servidores quando o grupo de servidores está vazio no momento da criação. Correção de bug: Corrigido um problema em que falha ao adicionar servidores quando `targetPort` estava definido como uma porta nomeada e apenas um subconjunto de pods era selecionado na configuração do Service.	Esta atualização não tem impacto nas suas cargas de trabalho.

Maio de 2025

Versão	Endereço da imagem	Data	Alterações	Impacto
v2.11.2	registry-cn-hangzhou.ack.aliyuncs.com/acs/cloud-controller-manager:v2.11.2	29 de maio de 2025	Otimizações: A lógica de sincronização do grupo de servidores foi otimizada para reduzir chamadas à OpenAPI.	Esta atualização não tem impacto nas suas cargas de trabalho.
v2.11.1	registry-cn-hangzhou.ack.aliyuncs.com/acs/cloud-controller-manager:v2.11.1	15 de maio de 2025	Novos recursos: A anotação `service.beta.kubernetes.io/alibaba-cloud-loadbalancer-ignore-weight-update` ignora atualizações de peso dos servidores de backend. O CLB agora permite atribuir múltiplos IDs de controle de acesso (ACL) para aplicar várias políticas de controle de acesso. A anotação `service.beta.kubernetes.io/alibaba-cloud-loadbalancer-listener-port-range` agora configura um intervalo de portas de listener para NLB. A variável de ambiente `NLB_ENDPOINT` agora configura um endpoint personalizado da OpenAPI para NLB. Otimizações: Velocidade de entrada de nós e adição de rotas melhorada com menos chamadas à OpenAPI. Operações de listener e grupo de servidores paralelizadas durante a sincronização de Services para reduzir o tempo de sincronização de um único Service. Ao criar uma instância NLB via OpenAPI, IDs de instância EIP ou endereços privados IPv4 não especificados agora passam null em vez de uma string vazia. A chamada da API DescribeNetworkInterfaces agora usa `NextToken` para paginação em vez de `PageSize`. Correções de bugs: Corrigido um problema no NLB onde um Service usando ReadinessGate falhava em tentar novamente se seu Pod não estivesse pronto.	Esta atualização não tem impacto nas suas cargas de trabalho.

Janeiro de 2025

Número da versão	Data de lançamento	Descrição	Impacto
v2.10.2	20/01/2024	Novos recursos: Adiciona suporte para incluir o rótulo `node.alibabacloud.com/spot-strategy` aos nós para identificá-los como instâncias preemptíveis. Otimizações: O grupo de servidores é sincronizado apenas uma vez quando múltiplos listeners de um Service estão associados a ele. Problemas corrigidos: Corrigido um problema que impedia a criação da instância de balanceador de carga se um Service fosse alterado do tipo `LoadBalancer` para outro tipo e depois retornasse ao tipo `LoadBalancer`. Corrigido o problema em que o sistema falhava ao localizar o pod ao tentar atualizar seu status de readiness. Ao atualizar as tags de uma instância de balanceador de carga, as tags do sistema com o prefixo `acs:` são ignoradas.	Sem impacto nas cargas de trabalho.

Dezembro de 2024

Número da versão	Data de lançamento	Descrição	Impacto
v2.10.0	02/12/2024	Importante A partir desta versão, alterações no valor da anotação `service.beta.kubernetes.io/alibaba-cloud-loadbalancer-additional-resource-tags` afetam instâncias de balanceador de carga criadas e reutilizadas. Ao usar esta anotação, não modifique as tags do balanceador de carga no console. Antes de atualizar para esta versão, certifique-se de que as tags na instância do balanceador de carga correspondem à anotação. Novos recursos: Suporte ao feature gate de readiness adicionado. Adiciona suporte para modificar tags após a criação da instância usando a anotação `service.beta.kubernetes.io/alibaba-cloud-loadbalancer-additional-resource-tags`. Adiciona suporte para incluir os rótulos `node.alibabacloud.com/node-pool-id` e `node.alibabacloud.com/instance-charge-type` aos nós. O NLB agora permite especificar a política ALPN para listeners `TCPSSL` usando as anotações `service.beta.kubernetes.io/alibaba-cloud-loadbalancer-alpn` e `service.beta.kubernetes.io/alibaba-cloud-loadbalancer-alpn-policy`. Otimizações: A versão da imagem base foi atualizada para Alpine 3.18. Saída de logs otimizada com a adição de um `reconcileID`. Problemas corrigidos: Corrigido o problema em que Services associados a instâncias NLB poderiam ser gerenciados pelo controlador CLB.	Sem impacto nas cargas de trabalho.

Junho de 2024

Número da versão	Data de lançamento	Descrição	Impacto
v2.8.3	30/06/2024	Novos recursos: Suporte ao modo de autorização Addon Token adicionado. O NLB agora permite criar grupos de servidores baseados em IP usando a anotação `service.beta.kubernetes.io/alibaba-cloud-loadbalancer-server-group-type`. Para mais informações sobre grupos de servidores NLB, consulte Grupos de servidores NLB. Otimizações: Suporte a acesso direto de clientes ao servidor de API do Kubernetes para evitar dados obsoletos gerados por cache. A lógica de criação de grupos de servidores NLB foi otimizada para impedir que o sistema crie grupos repetidamente. A verificação de endereços IP é realizada ao adicionar endereços IP de elastic network interfaces (ENIs) alocadas a pods em instâncias CLB. Essa verificação garante que os endereços IP estejam dentro do bloco CIDR da VPC onde o cluster reside.	Sem impacto nas cargas de trabalho.