Entrada no AKS (Serviço do Kubernetes do Azure)

Cuidado

A Rede SIG do Kubernetes e o Comitê de Resposta à Segurança anunciaram a próxima desativação do projeto NGINX de entrada, com a manutenção terminando em março de 2026. Não é necessária nenhuma ação imediata hoje para clusters AKS que utilizam o complemento de roteamento de aplicativos com NGINX.. A Microsoft fornecerá suporte oficial para patches de segurança críticos para recursos de entrada NGINX de complemento de roteamento de aplicativos até Novembro de 2026.

O AKS está se alinhando ao Kubernetes upstream ao mover-se para a Gateway API como o padrão de longo prazo para o gerenciamento de entrada e tráfego L7. Recomendamos que você comece a planejar seu caminho de migração com base na configuração atual:

A entrada no AKS é um recurso do Kubernetes que gerencia o acesso de tráfego externo semelhante a HTTP para serviços em um cluster. Uma entrada do AKS pode fornecer serviços como balanceamento de carga, terminação SSL e hospedagem virtual baseada em nome. Para obter mais informações sobre a Entrada do Kubernetes, consulte a documentação de Entrada no Kubernetes.

Para a maioria das cargas de trabalho de produção, comece com AKS Automatic. O AKS Automatic é o padrão pronto para produção recomendado no AKS e fornece padrões gerenciados para redes, dimensionamento, segurança, monitoramento e atualizações. Para entrada, isso significa que você pode começar com o caminho de entrada gerenciado e apenas passar para opções mais especializadas quando precisar de controle mais profundo sobre topologia, comportamento de roteamento ou integração de malha de serviço.

Use o AKS Standard quando precisar de um controle mais explícito sobre a seleção do controlador de entrada, a topologia de implantação ou a integração de rede avançada.

Modos de cluster e entrada do AKS

O AKS dá suporte a dois modos de cluster:

  • AKS Automático: ponto de partida recomendado para a maioria das cargas de trabalho de produção. Ele reduz a sobrecarga operacional e fornece padrões gerenciados para entrada e componentes de rede relacionados.
  • AKS Standard: melhor quando você precisa de controle explícito sobre a hospedagem do controlador de entrada, exposição de serviço e padrões avançados de gerenciamento de tráfego.

As diretrizes de entrada neste artigo se aplicam a ambos os modos. A principal diferença é quem possui mais dos padrões da plataforma e a quantidade de personalização que você precisa gerenciar diretamente.

Controladores de entrada

Ao gerenciar o tráfego do aplicativo, os controladores de entrada fornecem funcionalidades avançadas operando na camada 7. Eles podem rotear o tráfego HTTP para diferentes aplicativos com base na URL de entrada, permitindo regras de distribuição de tráfego mais inteligentes e flexíveis. Por exemplo, um controlador de entrada pode direcionar o tráfego para microsserviços diferentes, dependendo do caminho da URL, aumentando a eficiência e a organização de seus serviços.

Por outro lado, um Serviço do tipo LoadBalancer, quando criado, configura um recurso subjacente do balanceador de carga do Azure. Esse balanceador de carga funciona na camada 4, distribuindo o tráfego para os pods em seu Serviço em uma porta especificada. No entanto, os serviços de camada 4 não estão cientes dos aplicativos reais e não podem implementar esses tipos de regras de roteamento complexas.

Entender a distinção entre essas duas abordagens ajuda na seleção da ferramenta certa para suas necessidades de gerenciamento de tráfego.

Se você estiver usando o AKS Automatic, comece com o caminho de entrada gerenciado primeiro e use opções mais especializadas somente quando sua carga de trabalho exigir. No AKS Standard, você tem mais flexibilidade para escolher o controlador de entrada e a topologia que melhor correspondem à sua arquitetura.

Diagrama mostrando o fluxo de tráfego de ingresso em um cluster AKS

Comparar opções de entrada

Comparação de funcionalidades

A tabela a seguir lista as diferenças de recursos entre as diferentes opções do controlador de entrada. Para a maioria das cargas de trabalho do AKS de produção, o caminho padrão recomendado é a abordagem de entrada gerenciada no AKS Automatic, a menos que você precise especificamente de roteamento personalizado, integração de malha de serviço ou entrada hospedada em Azure.

Recurso Complemento Roteamento de Aplicativos Gateway de Aplicativos para contêineres Malha de serviços do Azure / malha de serviços do Istio
Controlador de entrada/gateway Controlador de entrada NGINX Gateway de Aplicativo do Azure para contêineres Gateway de entrada do Istio
API API da entrada API de Entrada e API de Gateway API de Entrada do Istio
Hosting No cluster Hospedado pelo Azure No cluster
Dimensionamento Dimensionamento automático Dimensionamento automático Dimensionamento automático
Balanceamento de carga Interno/Externo Externo Interno/Externo
Terminação TLS/SSL No cluster Sim: Descarregamento e E2E SSL No cluster
mTLS N/D Sim: front-end e back-end Sim
Endereço IP estático Sim FQDN (sem IP estático) N/D
Certificados SSL armazenados do Azure Key Vault Sim Sim N/D
Integração de DNS do Azure para gerenciamento de zona DNS Sim Sim N/D

Quando usar cada controlador de entrada

A tabela a seguir lista os diferentes cenários em que você pode usar cada controlador de entrada:

Opção de entrada Quando usar
NGINX Gerenciado – Complemento de Roteamento de Aplicativos • Controladores de entrada NGINX hospedados no cluster, personalizáveis e escalonáveis.
• Recursos básicos de balanceamento de carga e roteamento.
• Configuração do balanceador de carga interno e externo.
• Configuração de endereço IP estático.
• Integração com Azure Key Vault para gerenciamento de certificados.
• Integração com DNS do Azure Zones para gerenciamento de DNS público e privado.
• Compatível com a API Ingress.
Gateway de Aplicativo para contêineres • Gateway de entrada hospedado no Azure.
• Estratégias de implantação flexíveis gerenciadas pelo controlador ou traga seu próprio Gateway de Aplicativo para Contêineres.
• Recursos avançados de gerenciamento de tráfego, como repetições automáticas, resiliência de zona de disponibilidade, autenticação mútua (mTLS) para o destino de back-end, divisão de tráfego/round robin ponderado e dimensionamento automático.
• Integração com Azure Key Vault para gerenciamento de certificados.
• Integração com DNS do Azure Zones para gerenciamento de DNS público e privado.
• Oferece suporte às APIs Ingress e Gateway.
Gateway de entrada do Istio • Com base no Envoy, ao usar o Istio para uma malha de serviço.
• Recursos avançados de gerenciamento de tráfego, como limitação de taxa e interrupção de circuito.
• Suporte para mTLS.

Observação

Atualmente, o complemento Istio não oferece suporte à Gateway API para tráfego de entrada do Istio.

Criar um recurso de entrada

O complemento Roteamento de Aplicativos é a forma recomendada de configurar um controlador de entrada no AKS; este é o caminho de entrada gerenciado para iniciar no AKS Automático para a maioria das cargas de trabalho. O complemento de roteamento de aplicativos é um controlador de entrada totalmente gerenciado para AKS que fornece os seguintes recursos:

  • Configuração fácil de controladores de entrada NGINX gerenciados com base no controlador de entrada NGINX do Kubernetes.
  • Integração ao DNS do Azure para gerenciamento de zona pública e privada
  • Terminação SSL com certificados armazenados no Azure Key Vault.

Para a maioria das cargas de trabalho de produção, esta é a opção padrão mais adequada para iniciar. Se você precisar de topologia de entrada personalizada, entrada hospedada em Azure ou comportamento de malha de serviço, poderá mover para uma das outras opções de entrada.

Para obter mais informações sobre o complemento de Roteamento de Aplicativos, consulte a entrada NGINX gerenciada com o complemento de Roteamento de Aplicativos.

Preservação de IP de origem do cliente

Configure o controlador de entrada para preservar o IP de origem do cliente em solicitações para contêineres no cluster AKS. Quando o controlador de entrada roteia a solicitação de um cliente para um contêiner no cluster AKS, o IP de origem dessa solicitação fica indisponível para o contêiner de destino. Quando você habilita a preservação de IP de origem do cliente, o IP de origem do cliente fica disponível no cabeçalho da solicitação em X-Forwarded-For.

Se você estiver usando a preservação de IP de origem do cliente em seu controlador de entrada, não poderá usar passagem TLS. A preservação de IP de origem do cliente e a passagem de TLS podem ser usadas com outros serviços, como o tipo Balanceador de carga.

Essa continua sendo uma escolha de design importante no AKS Automatic e no AKS Standard, pois o tratamento de IP de origem afeta a observabilidade, a auditabilidade e o comportamento do aplicativo, independentemente do modo de cluster.

Para saber mais sobre a preservação do IP de origem do cliente, confira Como funciona a preservação do IP de origem do cliente para o LoadBalancer Services no AKS.