Installera MANAGED Gateway API CRD på Azure Kubernetes Service (AKS) (förhandsversion)

Kubernetes Gateway-API:et är en specifikation för trafikhantering i Kubernetes-kluster. Specifikationen förbättrar ingress-API:et, som saknar en enhetlig och leverantörsagnostisk metod för avancerad trafikroutning.

Api-installationen för Managed Gateway för Azure Kubernetes Service (AKS) installerar anpassade resursdefinitioner (CRD) för Kubernetes Gateway-API:et. Du kan installera dessa CRD:er oberoende av en specifik gateway-API-implementering.

Förutsättningar

• Om du redan har en befintlig installation av GATEWAY API CRD:er i klustret måste du uppfylla följande krav:

  • Endast standard kanal-CRD:er kan installeras i klustret. Experimental kanal-CRD:er tillåts inte, och du måste avinstallera dem innan du aktiverar Managed Gateway-API.
  • Gateway API-paketversionen måste vara kompatibel med klustrets Kubernetes-version. Mer information finns i avsnittet Kubernetes-versioner som stöds för gateway-API-paketversioner .

• Du kan också distribuera ett AKS-tillägg eller -tillägg som implementerar Gateway-API:et, till exempel Istio-tillägget. Om du använder Istio-tillägget måste du ha en mindre revision asm-1-26 eller senare för att säkerställa kompatibilitet med api-installationen för Managed Gateway. Information om hur du distribuerar Istio-tillägget finns i Distribuera Istio-baserat service mesh-tillägg för Azure Kubernetes Service (AKS).

• Tilläggetaks-preview har installerats och uppdaterats till version 19.0.0b4 eller senare.

• FunktionsflagganManagedGatewayAPIPreview som är kopplad till din prenumeration.

Installera eller uppdatera aks-preview tillägget

• aks-preview Installera tillägget eller uppdatera till den senaste versionen av tillägget med hjälp av kommandona az extension add ochaz extension update. om du använder Azure CLI. Du måste använda aks-preview version 19.0.0b4 och senare.

  # 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
  

Registrera funktionsflaggan för förhandsversionen av Api:et för Managed Gateway

• Registrera funktionsflaggan ManagedGatewayAPIPreview med az feature register-kommandot.

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

Kubernetes-versioner som stöds för gateway-API-paketversioner

I följande tabell beskrivs vilka Kubernetes-versioner som stöds för aks-klustret för varje gateway-API-paketversion för standard kanalen:

Skapa ett nytt AKS-kluster med MANAGED Gateway API CRD installerat

• Skapa ett nytt AKS-kluster med Managed Gateway API CRD:er installerade genom att använda kommandot az aks create med flaggan --enable-gateway-api. Du kan också aktivera ett tillägg som stöds, till exempel tillägget Istio Service Mesh, i samma kommando. Följande exempelkommando skapar ett nytt AKS-kluster med API-installationen för Managed Gateway och tillägget Istio Service Mesh aktiverat:

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

Installera CRD:erna för Managed Gateway-API:erna i ett befintligt AKS-kluster

• Installera CRDer för Managed Gateway APIer i ett befintligt kluster med az aks update-kommandot och --enable-gateway-api-flaggan.

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

Verifiera installationen av API CRD för Managed Gateway

1. Visa crd:erna som är installerade i klustret med hjälp av följande kubectl get crds kommando:

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

   Utdata ska visa de installerade CRD:erna, som ingår i Kubernetes Gateway API-specifikationen. Till exempel:

   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. Kontrollera att CRD:erna har de förväntade anteckningarna och att paketversionen matchar den förväntade Kubernetes-versionen för klustret med hjälp av följande kubectl get crds kommando:

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

   Utdata bör visa de förväntade annotationerna, inklusive gateway.networking.k8s.io/bundle-version-annotationen med den förväntade paketversionen för din klusters Kubernetes-version. Om klustret till exempel kör Kubernetes v1.33.0är v1.2.1den förväntade paketversionen , och utdata bör likna följande:

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

Avinstallera CRD:erna för Managed Gateway-API:erna i ett AKS-kluster

• Avinstallera Managed Gateway API CRDs i ett befintligt kluster med kommandot az aks update och flaggan --disable-gateway-api.

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

Relaterat innehåll

• Konfigurera ingress för Istio Service Mesh-tillägg med Kubernetes Gateway-API:et