Todos os produtos
Search
Central de documentação

Container Service for Kubernetes:APIG Ingress management

Última atualização: Sep 12, 2026

O APIG Ingress é um gateway de nível empresarial desenvolvido com base no projeto open-source Higress. Compatível com o Nginx Ingress, ele oferece suporte a cenários de gerenciamento de API e microsserviços.

Conceitos de Ingress

Em um cluster Kubernetes, o Ingress fornece balanceamento de carga na camada 7 para expor serviços internos. As regras de encaminhamento direcionam as requisições aos pods do Service de backend com base no conteúdo da requisição. Os recursos padrão de Ingress suportam apenas regras HTTP e não incluem funcionalidades avançadas, como algoritmos de balanceamento de carga e afinidade de sessão. Para obter esses recursos, utilize uma implementação de Ingress como o Nginx Ingress ou o APIG Ingress.

Recursos do APIG Ingress

Como usar o APIG Ingress

Desenvolvido sobre o gateway de API nativo da cloud, o APIG Ingress representa uma evolução do MSE Cloud Native Gateway. Ele suporta mais de 50 anotações do Nginx Ingress, cobrindo mais de 90% dos casos de uso, além de oferecer liberações canário, governança de tráfego e proteção de segurança para aplicações nativas da cloud em grande escala. O APIG Ingress também disponibiliza anotações que vão além da compatibilidade com o Nginx Ingress. Advanced usage of APIG Ingress.

Após a implantação do APIG Controller, ele passa a monitorar recursos ApigConfig e a gerenciar instâncias de gateway, configurações globais e opções de listener de Ingress. O gateway converte os recursos de Ingress em configurações de governança de tráfego que expõem os services internos. Crie e use um APIG Ingress para expor services.

Importante

O APIG Ingress substitui o MSE Ingress. Nas regiões onde ambos são suportados, o console do ACK exibe apenas as opções do APIG Ingress. Usuários existentes do MSE Ingress podem continuar criando e gerenciando seus MSE Ingresses normalmente. Para utilizar o MSE Ingress, envie um ticket para entrar em contato com a equipe do APIG.

Funcionamento do APIG Ingress

Componentes

  • APIG Controller:

    • O APIG Controller gerencia instâncias e configurações do gateway de API nativo da cloud. Ele opera em modo bypass e não processa o tráfego de service — as instâncias de gateway lidam com todo o tráfego do plano de dados.

    • No cluster, instale o componente APIG Controller. Utilize seu CRD ApigConfig para gerenciar instâncias de gateway de forma declarativa e configurar opções de listener de Ingress.

  • Gateway de API nativo da cloud:

    O APIG Controller cria o gateway a partir do recurso ApigConfig. O gateway possui um plano de controle e um plano de dados.

    • Plano de controle: Monitora recursos Ingress, IngressClass e Service no cluster associado, realiza a análise e envia as configurações para o plano de dados em tempo real.

    • Plano de dados: Processa requisições externas com base nas regras do plano de controle e as encaminha para os services de backend.

Como funciona

O APIG Controller monitora recursos ApigConfig no cluster e mantém o ciclo de vida e a associação de cluster de cada instância de gateway.

O plano de controle do gateway obtém alterações de Ingress do servidor de API e atualiza as regras de roteamento. Quando uma requisição chega, o gateway a compara com as regras de Ingress e a encaminha para os pods do Service de backend.

Os principais recursos e componentes do Kubernetes envolvidos são:

  • Service: Uma abstração que representa uma ou mais instâncias idênticas de service de backend.

  • Ingress: Regras de proxy reverso que roteiam requisições HTTP/HTTPS para Services com base no host e no caminho da URL.

  • IngressClass: Identifica uma implementação de controlador de Ingress. Use o campo Parameter para associar um ApigConfig que implementa as regras de tráfego dos recursos de Ingress.

  • ApigConfig: Um CRD fornecido pelo APIG Controller que define uma instância de gateway de API nativo da cloud.

  • APIG Controller: Gerencia instâncias e configurações de gateway ao monitorar recursos ApigConfig e coordenar o gateway para implementar as regras de tráfego de Ingress.

O diagrama a seguir ilustra o funcionamento do APIG Controller.

image

Referências