Installare le CRD dell'API del gateway gestito sul servizio Azure Kubernetes (anteprima)

L'API del gateway Kubernetes è una specifica per la gestione del traffico nei cluster Kubernetes. La specifica migliora l'API in ingresso, che non dispone di un approccio unificato e indipendente dal provider per il routing del traffico avanzato.

L'installazione della Managed Gateway API per il servizio Azure Kubernetes Service (AKS) installa le definizioni delle risorse personalizzate (CRD) per l'API del gateway Kubernetes. Con l'installazione dell'API Gateway gestito, è possibile utilizzare la funzionalità dell'API Gateway in una modalità completamente supportata nel servizio Azure Kubernetes (AKS).

Prerequisiti

• È necessario utilizzare un componente aggiuntivo o un'estensione del servizio Azure Kubernetes che implementa l'API del gateway, ad esempio il componente aggiuntivo Istio. Se si usa il componente aggiuntivo Istio, è necessario essere su revisione minore asm-1-26 o successiva per assicurare la compatibilità con l'installazione dell'API del gateway gestito. Per distribuire questo componente aggiuntivo, consultare Distribuire il componente aggiuntivo Istio-based service mesh per Azure Kubernetes Service (AKS).

  • Se nel cluster è già presente un'installazione esistente dei CRD dell'API Gateway, è necessario soddisfare i seguenti requisiti:

    • Solo le CRD del canale standard possono essere installate nel cluster. Experimental I CDR del canale non sono consentiti ed è necessario disinstallarli prima di abilitare l'API del gateway gestito.
    • La versione del bundle dell'API gateway deve essere compatibile con la versione kubernetes del cluster. Per altre informazioni, vedere la sezione Versioni del bundle dell'API gateway supportate per Kubernetes .

• Estensione aks-preview installata e aggiornata alla versione 19.0.0b4 o successiva.

• Il flag della funzionalità ManagedGatewayAPIPreview registrato nella sottoscrizione.

Installare o aggiornare l'estensione aks-preview

• Installare l'estensione aks-preview o eseguire l'aggiornamento alla versione più recente dell'estensione usando i comandi az extension add e az extension update. Se stai utilizzando l'interfaccia della riga di comando di Azure. È necessario usare la aks-preview versione 19.0.0b4 e versioni successive.

  # 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
  

Registrare l'indicatore di funzionalità in anteprima dell'API del gateway gestito

• Registrare il flag della funzionalità ManagedGatewayAPIPreview usando il comando az feature register.

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

Versioni di Kubernetes supportate per le versioni del bundle dell'API gateway

La tabella seguente illustra le versioni di Kubernetes supportate per il proprio cluster AKS per ogni versione del bundle Gateway API per il canale standard.

Crea un nuovo cluster AKS con i CRD dell'API del gateway gestito installati

• Creare un nuovo cluster del servizio Azure Kubernetes con le CRD dell'API del gateway gestito installate usando il comando az aks create con il flag --enable-gateway-api. È anche possibile abilitare un componente aggiuntivo supportato, ad esempio il componente aggiuntivo Mesh del servizio Istio, nello stesso comando. Il seguente comando di esempio crea un nuovo cluster AKS con l'installazione dell'API del gateway gestito e il componente aggiuntivo Istio service mesh abilitato.

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

Installare i CRD dell'API del gateway gestito su un cluster AKS esistente.

• Installare le CRD dell'API del gateway gestito in un cluster esistente con un'implementazione supportata abilitata, usando il comando az aks update con il flag --enable-gateway-api.

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

Verificare l'installazione CRD dell'API del gateway gestito

1. Visualizzare i CRL installati nel cluster usando il comando seguente kubectl get crds :

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

   L'output dovrebbe mostrare le CDR installate, che fanno parte della specifica dell'API del gateway Kubernetes. Per esempio:

   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. Verificare che i CRL abbiano le annotazioni previste e che la versione del bundle corrisponda alla versione di Kubernetes prevista per il cluster usando il comando seguente kubectl get crds :

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

   L'output dovrebbe mostrare le annotazioni previste, inclusa l'annotazione gateway.networking.k8s.io/bundle-version con la versione del bundle prevista per la versione Kubernetes del cluster. Ad esempio, se il cluster esegue Kubernetes v1.33.0, la versione prevista del bundle è v1.2.1e l'output dovrebbe essere simile al seguente:

   {
   "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"
   }
   

Disinstallare i CRD dell'API del Gateway gestito su un cluster AKS

• Disinstallare le CRD dell'API del gateway gestito in un cluster esistente usando il comando az aks update con il flag --disable-gateway-api.

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

Contenuti correlati

• Configurare l'ingresso per il componente aggiuntivo Mesh del servizio Istio con l'API del gateway Kubernetes