Todos os produtos
Search
Central de documentação

Container Compute Service:ALB Ingress Controller

Última atualização: Sep 25, 2026

O ALB Ingress Controller usa o Application Load Balancer (ALB) da Alibaba Cloud para gerencie o tráfego de Ingress. Este tópico apresenta uma visão geral do componente, instruções de uso e notas de versão.

Visão geral do componente

O ALB Ingress Controller é baseado no Application Load Balancer (ALB) da Alibaba Cloud e oferece gerenciamento robusto de tráfego de Ingress. Ele é compatível com o Nginx Ingress, suporta roteamento de negócios complexo e descoberta automática de certificados, além de lidar com os protocolos HTTP, https e QUIC. Essas características o tornam ideal para aplicações cloud que exigem alta elasticidade e processamento de tráfego da camada 7 em grande escala.

O ALB Ingress Controller monitora o servidor de api em busca de alterações nos recursos de Ingress, gera dinamicamente um AlbConfig e, em seguida, crie ou atualize as instâncias de ALB, os listeners, as regras de encaminhamento e os grupos de servidores de back-end necessários. Implante este componente no seu cluster do Container Service for Kubernetes (ACK) para gerencie o tráfego de Ingress configure recursos do ALB Ingress.

Instruções de uso

Para instruções de uso do ALB Ingress Controller, consulte Gerencie ALB Ingresses.

Notas de versão

Setembro de 2026

Versão

Data

Alterações

Impacto

v3.1.1

3 de setembro de 2026

Correções de bugs:

  • Correção de um bug no qual a OpenAPI do Application Load Balancer (ALB) usava incorretamente endpoints de rede pública, o que causava falha nos controllers em VPCs não públicas e em algumas regiões.

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

Agosto de 2026

Versão

Data

Alterações

Impacto

v3.1.0

10 de agosto de 2026

Novos recursos:

  • Suporte à Gateway API para gerenciar declarativamente extensões de Service para o Application Load Balancer (ALB) Extended Edition usando o recurso AlbServiceExtension. Essas extensões podem ser referenciadas em regras de encaminhamento ou grupos de servidores de back-end.

  • Suporte para configure back-ends do tipo Fqdn e IpSegment para o ALB Extended Edition usando o recurso AlbService. Esses back-ends podem ser referenciados em uma HTTPRoute.

Otimizações:

  • Otimização da lógica de atualização das regras de encaminhamento para evitar atualizações inválidas acionadas por uma ordem de retorno inconsistente dos grupos de servidores de back-end. Anteriormente, esse problema causava falha nos dry runs.

  • Correção de um problema de análise e entrega incorreta dos códigos de status de health check em alguns cenários, o que causava falha nos dry runs.

Correções de bugs:

  • Correção de um problema no qual um Service poderia não ser reconciliado prontamente após a alteração de um nó se o externalTrafficPolicy estivesse definido como o modo Local.

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

Julho de 2026

Versão

Data

Alterações

Impacto

v3.0.0

06 de julho de 2026

Novos recursos:

  • Suporte para crie e gerencie instâncias do ALB Extended Edition usando a Gateway API.

  • Suporte para associar IDs de extensão de Service a regras de encaminhamento de instâncias do ALB Extended Edition usando o AlbRule.

  • Suporte para associar IDs de extensão de Service a grupos de servidores de instâncias do ALB Extended Edition usando o AlbServerGroup.

  • Suporte ao CRD personalizado AlbInstance. Esse CRD permite defina configurações de instância do ALB, como tipo de endereço, zona de disponibilidade, logs e pacotes de largura de banda, referenciando infrastructure.parametersRef nos recursos do Gateway. Algumas propriedades entram em vigor apenas durante a criação da instância.

  • As instâncias do ALB Standard Edition criadas com a Gateway API têm o modo de instância gerenciada ativado por padrão. Para essas instâncias, as configurações de listener e de regra de encaminhamento não podem ser modificadas manualmente no console do ALB. Essa restrição se aplica apenas às instâncias do ALB criadas após a atualização para esta versão. As instâncias existentes não são afetadas.

Otimizações:

  • As conexões persistentes de back-end agora são ativadas por padrão ao criar um grupo de servidores com a Gateway API. Os grupos de servidores existentes não são afetados. Antes de atualize, confirme se essa mudança de comportamento afeta seus serviços.

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

  • Suporte para usar Services de múltiplas portas com a Gateway API.

  • Suporte para usar o ReadinessGate com a Gateway API. Esse recurso é compatível apenas com o plugin de rede Terway. O plugin de rede Flannel ainda não é compatível.

Correções de bugs:

  • Correção de um problema no qual a Gateway API falhava ao tentar repetir automaticamente após um erro de descoberta de Service.

  • Correção de um problema que bloqueava a exclusão de recursos do Gateway associados a uma HTTPRoute.

  • Correção de um problema no qual um listener era excluído imediatamente após um erro de certificado. Agora, a operação é bloqueada e um erro é relatado quando ocorre um erro de certificado.

  • Correção de um problema no qual o grupo de servidores não era limpo prontamente após a exclusão de um Service em cenários da Gateway API.

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

Junho de 2026

Versão

Data

Alterações

Impacto

v2.20.1

8 de junho de 2026

Otimizações:

  • Aumento do tempo de espera e da contagem de tentativas para tarefas assíncronas.

Correções de bugs:

  • Correção de um bug no qual clusters executando a versão 1.20 ou anterior falhavam ao reverter de EndpointSlice para Endpoints na descoberta de endpoints.

Sem impacto nos serviços.

Abril de 2026

Versão

Data

Alterações

Impacto

v2.20.0

16 de abril de 2026

Novos recursos:

  • Suporte para defina accessLogRecordCustomizedHeadersEnabled como falso especifique accessLogRecordCustomizedHeadersAllowDisable: true no logConfig do ListenerSpec.

  • O webhook agora impede a exclusão de um Service ou Secret usado por um ALB Ingress.

  • Adição de uma verificação de validação aos webhooks para garantir que, quando o tipo de path for Prefix, o path não possa conter o caractere curinga *.

Melhorias:

  • Redução do consumo de memória do controller.

  • O controller agora usa o EndpointSlice em vez de Endpoints para a descoberta de endpoints por padrão.

  • Otimização do tempo de espera para tarefas assíncronas de grupos de servidores.

Correções de bugs:

  • Correção de um problema no qual as alterações no ID do grupo de recursos do ALB no AlbConfig não entravam em vigor.

  • Correção de um problema no qual uma configuração de encaminhamento inválida para uma regra de encaminhamento personalizada poderia causar pânico no controller.

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

Janeiro de 2026

Versão

Data

Alterações

Impacto

v2.19.0

7 de janeiro de 2026

Novos recursos:

  • Suporte a recarregamento a quente do Secret especificado em defaultCertificate.

  • Suporte à configuração de um Ingress com as ações rate limiting + fixed response/redirect + forward.

Melhorias:

  • Aprimoramento da mensagem de erro exibida quando a criação do listener falha devido a um certificado expirado.

  • Aprimoramento do desempenho de reconciliação do controller.

  • Aprimoramento da validação do webhook para verificar os seguintes itens:

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

    • Se o campo AclType é black ou white.

    • Os backends do Ingress que especificam service.name sem service.port.

  • Adição de uma verificação no webhook para determinar se um Ingress é um ALB Ingress.

Correções de bugs:

  • Correção de um problema no qual as tags não eram removidas de uma instância do ALB quando o campo tags era excluído do AlbConfig.

  • Correção de um pânico raro do controller na exclusão de Service.

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

Julho de 2025

Versão

Data

Alterações

Impacto

v2.18.0-aliyun.1

4 de julho de 2025

  • O modo de instância gerenciada é ativado por padrão. As configurações de listener e de regra de encaminhamento para instâncias do ALB criadas automaticamente usando um AlbConfig não podem mais ser modificadas manualmente no console do ALB. Essa restrição se aplica apenas a novas instâncias do ALB criadas após esta atualização; as instâncias existentes e reutilizadas não são afetadas.

  • Agora é possível especifique um certificado padrão em um AlbConfig usando o campo defaultCertificate.

  • Otimização da lógica de classificação de prioridade para regras de encaminhamento e remoção do requisito de exclusividade global para o campo order.

  • Correção de um problema no qual o controller poderia entrar em pânico devido ao controle de fluxo ao consultar a api de tarefas assíncronas.

  • Correção de um problema no qual uma ACL seria aplicada a apenas um listener quando os listeners HTTPS e QUIC compartilhassem a mesma porta.

  • O readinessGate agora usa um intervalo fixo ao aguardar Pods não prontos.

  • Otimização da lógica de validação do webhook de admissão para regras de encaminhamento que não incluem uma ação de encerramento.

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

Março de 2025

Versão

Data

Alterações

Impacto

v2.17.2-aliyun.1

31 de março de 2025

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

  • Correção de um erro de parâmetro inválido ao consultar endereços IPv4 em um cluster dual-stack IPv6.

  • Aumento do número máximo de grupos de segurança que podem ser adicionados ou removidos em uma única chamada de API em lote de 4 para 9.

  • Chamadas de API ignoradas quando nenhuma tag adicional é necessária.

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

v2.17.1-aliyun.1

18 de março de 2025

  • Suporte para a Gateway API v1.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

Importante

A partir desta versão, as conexões persistentes de back-end são ativadas por padrão para novos grupos de servidores. Os grupos de servidores existentes não são afetados. Antes de atualize, confirme se essa alteração afeta seus serviços.

  • Conexão persistente ativada por padrão para novos grupos de servidores.

  • Os listeners agora suportam tags personalizadas.

  • Adição de uma opção para desativar o recurso de cross-zone para grupos de servidores.

  • Aprimoramento do desempenho geral de reconciliação do Service.

  • Aprimoramento do tempo das atualizações de status do ReadinessGate para Pods. O status do Pod é atualizado somente após a conclusão bem-sucedida de cada atualização do grupo de servidores associado.

  • As implantações canário agora exigem dois Ingresses separados ou ações de encaminhamento personalizadas. Se uma anotação canário for adicionada incorretamente a um Ingress, o sistema relata um erro e mantém as regras de encaminhamento originais.

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

Janeiro de 2025

Versão

Data

Alterações

Impacto

v2.15.2-aliyun.1

24 de janeiro de 2025

  • No XForwardedForConfig de um listener, é possível configure o XForwardedForProcessingMode para defina o modo de processamento do cabeçalho X-Forwarded-For e defina o XForwardedForHostEnabled para ative o cabeçalho de requisição X-Forwarded-Host.

  • Correção de um problema no qual o componente falhava ao iniciar quando o ValidatingWebhookConfiguration não existia.

  • Correção de um problema no qual a validação do Webhook falhava quando o alb.ingress.kubernetes.io/healthcheck-httpcode era configurado com múltiplos valores.

  • Adição de uma verificação para ações de encaminhamento que não incluem o tipo FinalType.

  • Otimização do cálculo do clientToken ao criar uma instância do ALB.

v2.15.0-aliyun.1

6 de janeiro de 2025

  • O ValidatingWebhook agora é ativado por padrão para pré-verificar as configurações do AlbConfig e do Ingress.

  • Suporte a scripts programáveis AScript.

  • O recurso de limitação de taxa agora suporta respostas fixas.

  • Os recursos ssl-redirect e limitação de taxa agora são compatíveis.

  • A persistência de sessão para grupos de servidores agora suporta cookies personalizados.

  • Suporte à configuração de grupos de segurança para novas instâncias do ALB. (Válido a partir de 00:00:00 de 25 de fevereiro de 2025, UTC+8)

  • Aprimoramento das mensagens de erro para conflitos de listener.

  • O controller agora envia notificações de eventos para inconsistências entre as configurações de certificado TLS e os certificados de regra de encaminhamento.

  • O controller agora valida recursos associados, como pacotes de largura de banda.

  • O protocolo gRPC agora suporta a configuração de certificado no AlbConfig.

  • Correção de um problema no qual o recurso de tag no AlbConfig não podia ser usado após a ativação do recurso de tag do criador.

  • Correção de um problema no qual a reconciliação do Service relatava erros continuamente em alguns cenários.

  • Correção de um problema no qual uma configuração incorreta do AlbConfig causava a falha do componente.

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

Maio de 2024

Versão

Data

Alterações

Impacto

v2.13.1-aliyun.1

10 de maio de 2024

  • O controller agora envia um evento quando um AlbConfig não está associado a um Ingress.

  • Correção de uma falha na criação do grupo de servidores causada por um namespace começando com um número ou por um nome de namespace ou Service muito longo.

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