Install Managed Gateway API CRDs on Azure Kubernetes Service (AKS) (pré-visualização)

A API do Kubernetes Gateway é uma especificação para gerenciamento de tráfego em clusters Kubernetes. A especificação reforça a Ingress API, que carece de uma abordagem unificada e independente do fornecedor para o encaminhamento avançado do tráfego.

A Instalação da API do Gateway Gerenciado para o Serviço Kubernetes do Azure (AKS) instala as Definições de Recursos Personalizados (CRDs) para a API do Gateway do Kubernetes. Pode instalar estes CRDs independentemente de qualquer implementação específica da API do Gateway.

Pré-requisitos

• Se já tiver uma instalação existente dos CRDs da API Gateway no seu cluster, deve cumprir os seguintes requisitos:

  • Só standard os CRDs de canal podem ser instalados no seu cluster. Experimental os CRDs do canal são proibidos, e deverá desinstalá-los antes de ativar a API de Gateway Gerido.
  • A versão do pacote Gateway API deve ser compatível com a versão Kubernetes do seu cluster. Para mais informações, consulte a secção Versões Kubernetes Suportadas para versões do pacote de API Gateway .

• Opcionalmente, pode implementar um complemento ou extensão do AKS que implemente a API do Gateway, como o add-on Istio. Se usar o complemento Istio, deve estar em revisão menor asm-1-26 ou superior para garantir compatibilidade com a instalação da API da Porta de Entrada Gerida. Para implementar o suplemento Istio, veja Implementar o suplemento de malha de serviços baseado em Istio para o Azure Kubernetes Service (AKS).

• A aks-preview extensão instalada e atualizada para uma versão 19.0.0b4 ou posterior.

• O ManagedGatewayAPIPreview flag de funcionalidade está registado na sua subscrição.

Instale ou atualize a aks-preview extensão

• Instale a aks-preview extensão ou atualize para a versão mais recente da extensão usando os az extension add comandos e az extension update . se você estiver a usar o Azure CLI. Deve usar aks-preview versão 19.0.0b4 e posteriores.

  # Install the aks-preview extension
  az extension add --name aks-preview
  
  # Update the aks-preview extension to the latest version
  az extension update --name aks-preview
  

Registar o indicador de funcionalidade de pré-visualização da API do Gateway Gerido

• Registe o sinalizador de funcionalidade ManagedGatewayAPIPreview com o comando az feature register.

  az feature register --namespace "Microsoft.ContainerService" --name "ManagedGatewayAPIPreview"
  

Versões Kubernetes suportadas para versões do pacote Gateway API

A tabela seguinte descreve as versões Kubernetes suportadas para o seu cluster AKS para cada versão do pacote Gateway API para o standard canal:

Crie um novo cluster AKS com CRDs de API do Gateway gerido instalados

• Crie um novo cluster AKS com CRDs da API de Gateway Gerido instalados usando o az aks create comando com a --enable-gateway-api bandeira. Também pode, opcionalmente, ativar um complemento suportado, como o complemento de malha de serviços Istio, no mesmo comando. O seguinte comando de exemplo cria um novo cluster AKS com a instalação da API do Gateway Gerenciado e o complemento de malha de serviço Istio ativado.

  az aks create --resource-group myResourceGroup --name myAKSCluster --enable-gateway-api --enable-azure-service-mesh
  

Instalar os CRDs da API de Gateway Gerenciado num cluster AKS existente

• Instale os CRDs da API de Gateway Geridos num cluster existente usando o comando az aks update com a opção --enable-gateway-api.

  az aks update --resource-group myResourceGroup --name myAKSCluster --enable-gateway-api
  

Verificar a instalação do CRD da API de Gateway Gerenciado

1. Veja os CRDs instalados no seu cluster usando o seguinte kubectl get crds comando:

   kubectl get crds | grep "gateway.networking.k8s.io"
   

   A saída deve mostrar os CRDs instalados, que fazem parte da especificação da API do Kubernetes Gateway. Por exemplo:

   gatewayclasses.gateway.networking.k8s.io                           2025-08-29T17:52:36Z
   gateways.gateway.networking.k8s.io                                 2025-08-29T17:52:36Z
   grpcroutes.gateway.networking.k8s.io                               2025-08-29T17:52:36Z
   httproutes.gateway.networking.k8s.io                               2025-08-29T17:52:37Z
   referencegrants.gateway.networking.k8s.io                          2025-08-29T17:52:37Z
   

2. Verifique se os CRDs têm as anotações esperadas e que a versão do bundle corresponde à versão Kubernetes esperada para o seu cluster usando o seguinte kubectl get crds comando:

   kubectl get crd gateways.gateway.networking.k8s.io -ojsonpath={.metadata.annotations} | jq
   

   O resultado deve mostrar as anotações esperadas, incluindo a anotação gateway.networking.k8s.io/bundle-version com a versão bundle esperada para a versão Kubernetes do seu cluster. Por exemplo, se o seu cluster estiver a correr Kubernetes v1.33.0, a versão esperada do bundle é v1.2.1, e a saída deve ser semelhante à seguinte:

   {
   "api-approved.kubernetes.io": "https://github.com/kubernetes-sigs/gateway-api/pull/3328",
   "app.kubernetes.io/managed-by": "aks",
   "app.kubernetes.io/part-of": <hash>,
   "gateway.networking.k8s.io/bundle-version": "v1.2.1",
   "gateway.networking.k8s.io/channel": "standard"
   }
   

Desinstalar CRDs da API de Gateway Gerenciada em um cluster AKS

• Desinstale os CRDs da API Gerida de Gateway num cluster existente usando o comando az aks update com a opção --disable-gateway-api.

  az aks update --resource-group myResourceGroup --name myAKSCluster --disable-gateway-api
  

Conteúdo relacionado

• Configurar a entrada para o complemento de malha de serviço Istio com a API do Kubernetes Gateway