Container Service for Kubernetes:ALB Ingress Controller

Número da versão

Data de lançamento

Alterações

Impacto

v3.2.1

20 de outubro de 2026

Novos recursos:

• Suporte à Gateway API para exibir o ID da instância ALB associada em Gateway.status.addresses.

• Inclusão de recursos da Gateway API do ALB nas verificações prévias de atualização do add-on.

• Suporte da Gateway API para configure descrições de listeners, tempos limite, Gzip, políticas de segurança TLS, autenticação mútua, X-Forwarded-For (XFF), logs e rótulos por protocolo e porta por meio de AlbInstance.spec.listeners.

• Suporte da Gateway API para configure ações de inserção de cabeçalho de requisição por meio do AlbRule.

• Suporte da Gateway API para configure o grupo de segurança associado a uma instância ALB por meio do AlbInstance.

• Suporte para configure um certificado de servidor e um certificado de CA para um listener HTTPS do Gateway por ID do certificado.

• Suporte para configure múltiplos certificados de CA para um listener HTTPS.

Otimizações:

• Hashes de reconciliação adicionados para Gateway e AlbServiceExtension. Recursos com configurações inalteradas ignoram a reconciliação repetida após a reinicialização do controller.

• Status ALBReconciled e ALBAppliedHash incluídos para visualização dos resultados da reconciliação e do hash aplicado com sucesso mais recente.

• Proteção de referência aprimorada para o ALB GatewayClass. Um GatewayClass ainda em uso por um Gateway é protegido por um finalizer.

• XFF ativado por padrão para listeners do Gateway recém-criados. Listeners existentes sem modo de processamento especificado mantêm a configuração de XFF no lado da cloud.

• Detecção de alternâncias de autenticação mútua e alterações de certificado de CA adicionada às verificações prévias de atualização do add-on.

Correções de bugs:

• Correção de um problema em que alterações de rótulo de namespace não acionavam a reconciliação do Gateway relacionado.

• Resolução de uma falha em que o Gateway originalmente associado não era reconciliado a tempo após a atualização do objeto referenciado de um ReferenceGrant ou AlbServerGroup.

• Correção de relatórios falsos de verificação prévia causados por verificações de integridade TCP, as quais não ignoravam parâmetros específicos de HTTP.

• Ajuste em relatórios falsos de verificação prévia gerados por listeners não HTTPS, os quais não ignoravam o QuicConfig.

• Correção de um problema em que o XForwardedForClientCertSubjectDNAlias era definido incorretamente como XForwardedForClientCertIssuerDNAlias.

• Resolução da reutilização incorreta de grupos de servidores de backend, causada por conflitos de ID de recurso quando o mesmo HTTPRoute referenciava Services com o mesmo nome e porta em namespaces diferentes.

Esta atualização não afeta seus serviços.

Número da versão

Data de lançamento

Alterações

Impacto

v3.1.1

3 de setembro de 2026

Correções de bugs:

• Correção de um problema em que a openapi do ALB usava incorretamente endpoints públicos, impedindo o funcionamento adequado do controller em Virtual Private Clouds (VPCs) não públicas e em determinadas regiões.

Esta atualização não afeta seus serviços.

Número da versão

Data de lançamento

Alterações

Impacto

v3.1.0

10 de agosto de 2026

Novos recursos:

• Suporte da Gateway API para gerencie declarativamente extensões de service do ALB Extended Edition por meio do recurso AlbServiceExtension e referenciá-las em regras de encaminhamento ou grupos de servidores.

• Suporte da Gateway API ao uso de AlbService para configure backends Fqdn e IpSegment no ALB Extended Edition e referenciá-los no HTTPRoute.

Otimizações:

• Lógica de atualização de regras de encaminhamento otimizada para evitar atualizações inválidas acionadas por ordem de retorno inconsistente do grupo de servidores de backend, que causava falha nas verificações prévias.

• Correção de um problema em que os códigos de status de verificação de integridade não eram analisados ou entregues conforme o protocolo em certos cenários, causando falha nas verificações prévias.

Correções de bugs:

• Resolução de uma falha em que um Service podia não acionar a reconciliação a tempo após alterações de nó, caso o externalTrafficPolicy estivesse definido como Local.

Esta atualização não afeta seus serviços.

Número da versão

Data de lançamento

Alterações

Impacto

v3.0.0

6 de julho de 2026

Novos recursos:

• Suporte para crie e gerencie instâncias do ALB Extended Edition por meio da Gateway API.

• Suporte para associar IDs de extensão de service às regras de encaminhamento de instâncias do ALB Extended Edition por meio do AlbRule.

• Suporte para associar IDs de extensão de service aos grupos de servidores de instâncias do ALB Extended Edition por meio do AlbServerGroup.

• Definição de recurso personalizado (CRD) AlbInstance implementada. Configurações de instância ALB, como tipo de endereço, zonas de disponibilidade, logs e pacotes de largura de banda, podem ser definidas por meio da referência infrastructure.parametersRef de um recurso Gateway. Algumas propriedades entram em vigor apenas na criação da instância.

• Instâncias do ALB Standard Edition criadas por meio da Gateway API têm o modo gerenciado ativado por padrão. Não é possível alterar manualmente as configurações de listener e de regra de encaminhamento dessas novas instâncias no console do ALB. Essa restrição aplica-se apenas a instâncias ALB criadas após a atualização para esta versão. Instâncias existentes não são afetadas.

Otimizações:

• Conexões persistentes de backend ativadas por padrão para grupos de servidores criados por meio da Gateway API. Grupos de servidores existentes não são afetados. Antes de atualizar, confirme se essa mudança de comportamento afeta seus serviços.

• A Gateway API passa a usar EndpointSlice em vez de Endpoints para descoberta de endpoints por padrão.

• Suporte para Services de múltiplas portas por meio da Gateway API.

• Suporte a ReadinessGate por meio da Gateway API. Apenas o plugin de rede Terway oferece suporte a este recurso; o plugin Flannel não.

Correções de bugs:

• Correção de um problema em que a Gateway API não tentava novamente de forma automática após erros de descoberta de Service.

• Resolução de uma falha em que a exclusão de um recurso Gateway associado a um HTTPRoute era bloqueada.

• Ajuste no problema em que um listener era excluído diretamente após um erro de certificado. Agora, a operação é bloqueada e um erro é relatado quando o certificado apresenta anomalia.

• Resolução da falha em que o grupo de servidores não era limpo a tempo após a exclusão de um Service em cenários da Gateway API.

Esta atualização não afeta seus serviços.

Número da versão

Data de lançamento

Alterações

Impacto

v2.20.1

8 de junho de 2026

Otimizações:

• Tempo de espera e número de novas tentativas aumentados para tarefas assíncronas.

Correções de bugs:

• Correção de um problema em que clusters na versão 1.20 ou anterior não podiam reverter de EndpointSlice para Endpoints na descoberta de endpoints.

Esta atualização não afeta seus serviços.

Número da versão

Data de lançamento

Alterações

Impacto

v2.20.0

16 de abril de 2026

Novos recursos:

• Suporte no ListenerSpec para a opção logConfig accessLogRecordCustomizedHeadersAllowDisable: true, permitindo defina accessLogRecordCustomizedHeadersEnabled como false.

• Interceptação de Webhook incluída para a exclusão de recursos Service e Secret ainda em uso pelo ALB Ingress.

• Validação de Webhook implementada para impedir que o valor de path contenha o curinga * quando o tipo de path for Prefix.

Otimizações:

• Uso de memória do controller otimizado.

• Uso de EndpointSlice em vez de Endpoints para descoberta de endpoints por padrão.

• Tempos de espera de tarefas assíncronas aprimorados para operações de grupo de servidores.

Correções de bugs:

• Correção de um problema em que a modificação do ID do grupo de recursos do ALB por meio do AlbConfig não surtia efeito.

• Resolução de uma falha em que uma configuração de encaminhamento incorreta podia causar pânico no controller ao usar regras personalizadas.

Esta atualização não afeta seus serviços.

Número da versão

Data de lançamento

Alterações

Impacto

v2.19.1

12 de fevereiro de 2026

Otimizações:

• Tratamento de chamadas openapi limitadas (throttled) otimizado, com adição de novas tentativas automáticas para certos códigos de erro.

• Suporte para Tag Value vazio e validação de Tag Keys duplicadas.

Correções de bugs:

• Correção de um problema em que a adição de ReadinessGate a um Pod não era repetida quando um evento de Ingress acionava a criação do grupo de servidores de backend.

• Resolução de uma falha em que a consulta do status do listener falhava após a atualização da configuração de log.

Esta atualização não afeta seus serviços.

Número da versão

Data de lançamento

Alterações

Impacto

v2.19.0

7 de janeiro de 2026

Novos recursos:

• Recarregamento a quente (hot reloading) para Secrets especificados por defaultCertificate.

• Suporte para configure um Ingress com as seguintes ações simultâneas: rate limiting + fixed response/redirect + forward.

Otimizações:

• Mensagens de erro aprimoradas para casos em que a criação do listener falha devido a um certificado expirado.

• Desempenho de reconciliação do controller otimizado.

• Validação de Webhook reforçada com verificações para os seguintes cenários:

  • O formato do campo SourceIP em condições de encaminhamento personalizadas.

  • Os valores do campo AclType, especificamente se o valor é black ou white.

  • Um Ingress no qual o backend especifica apenas service.name sem especifique service.port.

• Verificação de Webhook adicionada para identificar se um Ingress é um ALB Ingress.

Correções de bugs:

• Correção de um problema em que os rótulos correspondentes em uma instância ALB não podiam ser limpos ao excluir completamente o campo tags do AlbConfig.

• Resolução de uma falha em que a exclusão de um Service podia causar pânico no processo do controller em cenários extremos.

Esta atualização não afeta seus serviços.

Número da versão

Data de lançamento

Alterações

Impacto

v2.18.0-aliyun.1

4 de julho de 2025

• Modo gerenciado de instância ativado por padrão. Esse modo impede alterações manuais nas configurações de listener e de regra de encaminhamento no console do ALB para instâncias criadas automaticamente por meio do AlbConfig. A restrição aplica-se apenas a instâncias ALB criadas após a atualização para esta versão. Instâncias existentes e reutilizadas não são afetadas.

• Suporte para especifique manualmente um certificado padrão por meio de defaultCertificate no AlbConfig.

• Lógica de classificação de prioridade para regras de encaminhamento otimizada e restrição de exclusividade global em order removida.

• Suporte exclusivo para o modo reforçado (hardened) de Metadata do Elastic Compute Service (ECS).

• Correção de um problema em que o limitador (throttling) podia causar pânico no controller ao consultar operações de tarefas assíncronas.

• Resolução de uma falha em que uma lista de controle de acesso (ACL) entrava em vigor apenas em um listener quando listeners HTTPS e QUIC compartilhavam a mesma porta.

• Uso de intervalo de espera fixo quando o readinessGate aguarda Pods não prontos.

• Lógica de validação do Admission Webhook aprimorada para ações de encaminhamento sem uma ação de tipo final.

Esta atualização não afeta seus serviços.

Número da versão

Data de lançamento

Alterações

Impacto

v2.17.2-aliyun.1

31 de março de 2025

• Correção de um erro de reconciliação de porta não encontrada para grupos de servidores quando regras de Ingress em múltiplos namespaces apontavam para Services com o mesmo nome, mas portas diferentes.

• Resolução de um problema em que um parâmetro incorreto era usado para consultar endereços IPv4 em clusters dual-stack IPv6.

• Número máximo de grupos de segurança por chamada de API em lote aumentado de 4 para 9, ao adicionar ou remover grupos.

• Chamadas de API ignoradas quando nenhum rótulo adicional precisa ser adicionado.

Esta atualização não afeta seus serviços.

v2.17.1-aliyun.1

18 de março de 2025

• Suporte para Gateway API 1.1.0 e versões posteriores.

Esta atualização não afeta seus serviços.

v2.16.0-aliyun.1

4 de março de 2025

• Conexões persistentes ativadas por padrão para grupos de servidores recém-criados.

• Suporte para defina rótulos personalizados para listeners.

• Suporte para desativar o recurso cross-zone dos grupos de servidores.

• Desempenho geral de reconciliação de Service otimizado.

• Momento de atualização do status do Pod pelo ReadinessGate aprimorado. O status do Pod é atualizado apenas após a atualização bem-sucedida de todos os grupos de servidores.

• Uma versão canary deve ser dividida em dois recursos Ingress ou implementada por meio de ações de encaminhamento personalizadas. Se uma Annotation canary for adicionada diretamente a um Ingress por engano, o sistema relata um erro e retém as regras de encaminhamento originais.

Esta atualização não afeta seus serviços.