Os gateways MSE Ingress ampliam o modelo padrão de Ingress do Kubernetes integrando os gateways cloud-native do Microservices Engine (MSE) ao Container Service for Kubernetes (ACK). Isso proporciona gerenciamento avançado de tráfego, governança de serviços e recursos de segurança que vão além do que os recursos padrão de Ingress do Kubernetes oferecem.
Este tópico aborda os conceitos fundamentais, a arquitetura e os componentes dos gateways MSE Ingress. Destina-se a operadores de cluster e engenheiros de plataforma que gerenciam o tráfego de entrada em clusters ACK ou Container Compute Service (ACS).
Conceitos fundamentais
Em um cluster Kubernetes, um Ingress atua como ponto de acesso que expõe Services e distribui o tráfego de entrada para os pods de backend. Os recursos padrão de Ingress do Kubernetes tratam apenas do roteamento de tráfego HTTP — recursos avançados como algoritmos de balanceamento de carga e afinidade de sessão exigem uma implementação de controlador de Ingress.
Os gateways MSE Ingress são construídos sobre os gateways cloud-native do MSE e adicionam as seguintes capacidades além do Ingress padrão do Kubernetes:
Compatibilidade com gateways NGINX Ingress e mais de 50 anotações do NGINX Ingress, cobrindo mais de 90% dos casos de uso de gateways NGINX Ingress
Canary releases para múltiplas versões de service simultaneamente
Governança de service flexível e proteção de segurança abrangente
Recursos
Para informações detalhadas sobre os recursos disponíveis, consulte os seguintes tópicos:
Observações de uso
Os clusters gerenciados ACK, clusters ACK Serverless e clusters ACS oferecem suporte a gateways MSE Ingress para balanceamento de carga de Camada 7 do tráfego externo.
Instale o MSE Ingress Controller no cluster antes de usar os gateways MSE Ingress. O MSE Ingress Controller monitora os recursos definidos nas CustomResourceDefinitions (CRDs) do MseIngressConfig e gerencie dinamicamente os ciclos de vida, as configurações globais e os itens de escuta de Ingress dos gateways cloud-native do MSE. Em seguida, esses gateways cloud-native convertem os recursos de Ingress em configurações de gerenciamento de tráfego, expondo os Services do cluster externamente. Para mais detalhes, consulte Use MSE Ingress gateways to access services in ACK clusters and ACS clusters.
Os recursos de Ingress do Kubernetes suportam apenas o gerenciamento de tráfego HTTP, com recursos avançados implementados por meio de anotações. Os gateways MSE Ingress são compatíveis com anotações do NGINX Ingress e fornecem anotações adicionais para governança de tráfego e segurança. Para mais detalhes, consulte Advanced usage of MSE Ingress.
Como os gateways MSE Ingress funcionam
Componentes
Os gateways MSE Ingress são compostos por dois componentes principais:
MSE Ingress Controller
O MSE Ingress Controller é o plano de controle responsável por gerencie os gateways cloud-native do MSE e suas configurações. Ele não processa o tráfego de service diretamente — atua como um desvio de tráfego para coordenar os gateways cloud-native do MSE que tratam as requisições de service. Instale o MSE Ingress Controller no cluster gerenciado ACK, no cluster ACK Serverless ou no cluster ACS. Ele usa CRDs do MseIngressConfig para gerencie os gateways cloud-native por meio de anotações e configure a escuta de recursos de Ingress.
Para instruções de instalação, consulte Manage the MSE Ingress Controller component.
Gateways cloud-native do MSE
O MSE Ingress Controller cria gateways cloud-native do MSE com base nas CRDs do MseIngressConfig que você configure. Cada gateway possui dois planos:
Plano de controle: monitora Ingresses, classes de Ingress e Services no cluster, analisa as configurações e envia as regras de roteamento para o plano de dados em tempo real.
Plano de dados: recebe as requisições externas, verifica a correspondência com as regras de governança provenientes do plano de controle e encaminha as requisições para o Service de backend correto.
Fluxo de tráfego
A tabela a seguir descreve como cada componente interage quando uma requisição percorre um gateway MSE Ingress.
|
Etapa |
De → Para |
Ação |
|
1 |
MseIngressConfig CRD → MSE Ingress Controller |
O MSE Ingress Controller monitora a CRD do MseIngressConfig e mantém o ciclo de vida do gateway cloud-native correspondente e sua associação com o cluster. |
|
2 |
Servidor de API do cluster → Plano de controle do gateway cloud-native |
O plano de controle conecta-se ao servidor de API do cluster para detectar alterações nos recursos de Ingress e atualiza as regras de roteamento do gateway dinamicamente. |
|
3 |
Client → Plano de dados do gateway cloud-native |
O plano de dados recebe a requisição, verifica a correspondência com as regras de roteamento de Ingress e a encaminha para o pod do Service de backend correspondente. |
A figura a seguir ilustra a interação entre esses componentes.

Relacionamento entre recursos
Os recursos a seguir atuam em conjunto em um cluster Kubernetes para ative o gerenciamento de tráfego dos gateways MSE Ingress:
|
Recurso |
Função |
|
Service |
Abstração que representa um ou mais pods de backend idênticos. |
|
Ingress |
Conjunto de regras de proxy reverso que roteiam requisições HTTP ou HTTPS para Services com base em hostnames e URLs. |
|
Ingress class |
Declara qual implementação de controlador de Ingress processa um determinado conjunto de recursos de Ingress. Associe um MseIngressConfig ao campo |
|
MseIngressConfig |
CRD fornecida pelo MSE Ingress Controller que defina a configuração de um gateway cloud-native do MSE. |
|
MSE Ingress Controller |
Plano de controle que monitora as CRDs do MseIngressConfig e coordena os gateways cloud-native do MSE para implementar as regras de gerenciamento de tráfego extraídas dos recursos de Ingress. |
Referências
Para instruções de instalação, consulte Manage the MSE Ingress Controller component.
Para o histórico de versões, consulte Release notes for MSE Ingress gateways.