Udostępnij przez

Instalowanie CRD dla API Managed Gateway (wersja zapoznawcza)

Ważne

Funkcje usługi AKS w wersji zapoznawczej są dostępne na zasadzie samoobsługi i wymagają zapisania się. Wersje zapoznawcze są udostępniane w wersji "as is" i "jako dostępne" i są wykluczone z umów dotyczących poziomu usług i ograniczonej gwarancji. Wersje zapoznawcze usługi AKS są częściowo objęte pomocą techniczną dla klientów, świadczoną w miarę możliwości. W związku z tym te funkcje nie są przeznaczone do użytku produkcyjnego. Aby uzyskać więcej informacji, zobacz następujące artykuły pomocy technicznej:

API Gateway Kubernetes to specyfikacja zarządzania ruchem w klastrach Kubernetes. Został zaprojektowany jako następca i ulepszenie Ingress API, któremu brakowało ujednoliconego i niezależnego od dostawcy podejścia do zaawansowanego routingu ruchu.

Instalacja interfejsu API usługi Managed Gateway dla usługi Azure Kubernetes Service (AKS) instaluje niestandardowe definicje zasobów (CRD) dla interfejsu API bramy Kubernetes. Po zainstalowaniu Managed Gateway API można użyć funkcjonalności interfejsu API Gateway w pełni obsługiwanym trybie na AKS. Należy jednak również użyć dodatku usługi AKS lub rozszerzenia, które implementuje interfejs API Gateway, na przykład dodatek Istio.

Mapowanie wersji pakietu Gateway API i wersji AKS Kubernetes

W poniższej tabeli przedstawiono obsługiwane wersje Kubernetes dla klastra AKS dla każdej wersji pakietu Gateway API dla kanału standard. Experimental Identyfikatory CRD kanału są niedozwolone i należy je odinstalować przed włączeniem instalacji interfejsu API usługi Managed Gateway.

Wersja pakietu interfejsu API bramy Obsługiwane wersje rozwiązania Kubernetes
v1.2.1 wersja 1.26.0 — wersja 1.33.x
Wersja 1.3.0 Wersja 1.34.0+

Uwaga / Notatka

Jeśli uaktualnisz klaster usługi AKS do nowej wersji pomocniczej po zainstalowaniu identyfikatorów CRD interfejsu API bramy zarządzanej, pliki CRD zostaną automatycznie uaktualnione do nowej obsługiwanej wersji pakietu interfejsu API bramy dla tej wersji rozwiązania Kubernetes. Jeśli na przykład uaktualnisz usługę AKS v1.33.0 do v1.34.0, a wcześniej zainstalowano interfejs API Managed Gateway dla wersji v1.2.1 pakietu, pliki CRD zostaną automatycznie uaktualnione do wersji v1.3.0 pakietu.

Wymagania wstępne

Upewnij się, że w klastrze masz zainstalowaną i włączoną co najmniej jedną z poniższych implementacji Gateway API.

  • Dodatek Istio — wersja asm-1-26 pomocnicza lub nowsza.

  • Zainstaluj rozszerzenie przy użyciu polecenia aks-preview, jeśli używasz Azure CLI az extension add. Musisz użyć wersji aks-preview19.0.0b4 lub nowszej.

    az extension add --name aks-preview

    Przeprowadź aktualizację do najnowszej wersji rozszerzenia przy użyciu az extension update polecenia :

    az extension update --name aks-preview

Zarządzanie funkcją interfejsu API usługi Managed Gateway w wersji zapoznawczej

Flagę ManagedGatewayAPIPreview funkcji można zarejestrować przy użyciu az feature register polecenia :

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

Następnie można zainstalować lub odinstalować identyfikatory CRD interfejsu API usługi Managed Gateway.

  1. Możesz uruchomić az aks create polecenie , aby zainstalować identyfikatory CRD interfejsu API usługi Managed Gateway w nowo utworzonym klastrze. Należy również włączyć implementację Gateway API, aby umożliwić zarządzaną instalację CRD.

    # Example: enable the managed Gateway API installation with the Istio service mesh add-on
az aks create -g $RESOURCE_GROUP -n $CLUSTER_NAME --enable-gateway-api --enable-azure-service-mesh

  2. Aby zainstalować CRD interfejsu API Managed Gateway w istniejącym klastrze z aktywną obsługiwaną implementacją, uruchom następujące polecenie:

    az aks update -g $RESOURCE_GROUP -n $CLUSTER_NAME --enable-gateway-api

  3. Aby wyświetlić dyski CRD zainstalowane w klastrze, uruchom następujące polecenie:

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

    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

  4. Sprawdź, czy identyfikatory CRD mają oczekiwane adnotacje i czy wersja pakietu jest zgodna z oczekiwaną wersją rozwiązania Kubernetes dla klastra.

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

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

Dalsze kroki

  • Konfigurowanie ingressu dla dodatku Istio service mesh przy użyciu API bramy Kubernetes
  • Last updated on