Partilhar via

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. Com a instalação da API do Managed Gateway, você pode usar a funcionalidade da API do Gateway em um modo totalmente suportado no AKS.

Pré-requisitos

Instale ou atualize a aks-preview extensão

Importante

Os recursos de pré-visualização do AKS estão disponíveis numa base de autosserviço e adesão voluntária. As visualizações prévias são fornecidas "como estão" e "conforme disponíveis" e são excluídas dos contratos de nível de serviço e da garantia limitada. As versões de teste do AKS são parcialmente cobertas pelo suporte ao cliente numa base de melhor esforço. Assim sendo, estas funcionalidades não se destinam ao uso em produção. Para obter mais informações, consulte os seguintes artigos de suporte:

  • 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:

Versão do pacote da API Gateway Versões do Kubernetes suportadas
v1.2.1 v1.26.0 - v1.33.x
v1.3.0 v1.34.x
v1.4.1 v1.35.0+

Observação

Se atualizar o seu cluster AKS para uma nova versão menor após instalar os CRDs da API Managed Gateway, os CRDs atualizam automaticamente para a nova versão suportada do pacote Gateway API para essa versão Kubernetes. Por exemplo, se atualizar do AKS v1.33.0 para v1.34.0 e anteriormente tenha a API de Gateway Gerido instalada para a versão bundle v1.2.1, os CRDs atualizam automaticamente para a versão bundle v1.3.0.

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 ativar um add-on suportado, como o add-on Istio Service Mesh, 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 CRDs da API do Gateway Gerido num cluster existente com implementação suportada ativada, usando um comando az aks update com o parâmetro --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

  • Last updated on