Megjegyzés
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhat bejelentkezni vagy módosítani a címtárat.
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhatja módosítani a címtárat.
A Kubernetes Gateway API a Kubernetes-fürtök forgalomkezelésének specifikációja. A specifikáció javítja az Ingress API-t, amely nem rendelkezik egységes és szolgáltatói agnosztikus megközelítéssel a fejlett forgalomirányításhoz.
Az Azure Kubernetes Service (AKS) felügyelt átjáró API-telepítése telepíti a Kubernetes Gateway API egyéni erőforrás-definícióit (CRD-ket). Ezeket a CRD-ket bármely konkrét Gateway API-implementációtól függetlenül telepítheti.
Megjegyzés:
A Felügyelt átjáró API telepítése csak az átjáró API-crD-k telepítését és kezelését végzi. Ezeket a CRD-ket használhatja saját Gateway API-implementációval, de az AKS-támogatás csak akkor érvényes, ha a Felügyelt átjáró API-telepítést egy támogatott AKS-bővítményrel vagy -bővítménysel használja, amely implementálja az Átjáró API-t. Az AKS nem támogatja a BYO-proxykat vagy más, ön által felügyelt Átjáró API-implementációkat.
Előfeltételek
Ha már telepítette az Átjáró API CRD-jait a fürtön, az alábbi követelményeknek kell megfelelnie:
- Csak
standardcsatorna CRD-k telepíthetők a klaszterre.ExperimentalA csatorna CRD-k nem engedélyezettek, és a Managed Gateway API engedélyezése előtt el kell távolítania őket. - A Gateway API csomagverziójának kompatibilisnek kell lennie a fürt Kubernetes-verziójával. További információkért lásd a Gateway API csomagverzióinak támogatott Kubernetes-verzióit ismertető szakaszt .
- Csak
Szükség esetén üzembe helyezhet egy AKS-bővítményt vagy -bővítményt, amely implementálja az Átjáró API-t, például az Istio bővítményt. Ha az Istio bővítményt használja, a
asm-1-26vagy újabb verziófrissítést kell alkalmaznia a Felügyelt Átjáró API telepítésével való kompatibilitás biztosítása érdekében. Az Istio bővítmény üzembe helyezéséhez lásd: Istio-alapú service mesh bővítmény üzembe helyezése az Azure Kubernetes Service-hez (AKS).
Az Azure CLI verziójának frissítése
A azure-cli2.86.0 verziót vagy újabbat kell használnia. Futtassa a az --version parancsot a azure-cli verzió ellenőrzéséhez, és futtassa a az upgrade parancsot a frissítéshez.
A Gateway API csomagverzióihoz támogatott Kubernetes-verziók
Az alábbi táblázat az AKS-fürt támogatott Kubernetes-verzióit ismerteti a standard csatorna egyes Gateway API-csomagverzióihoz:
| Átjáró API-csomag verziója | Támogatott Kubernetes-verziók |
|---|---|
| v1.2.1 | v1.26.0 – 1.33.x |
| 1.3.0-s verzió | v1.34.x |
| 1.4.1-s verzió | v1.35.x |
| 1.5.1-s verzió | v1.36.x |
| 1.6.1-s verzió | 1.37.0+-os verzió |
Megjegyzés:
Ha az AKS-fürtöt egy új alverzióra frissíti a Managed Gateway API CRD-k telepítése után, a CRD-k automatikusan az adott Kubernetes-verzióhoz tartozó új támogatott Gateway API-csomagverzióra frissülnek. Ha például az AKS v1.33.0 rendszerről v1.34.0 verzióra frissít, és korábban telepítve volt a Managed Gateway API a v1.2.1 csomagverzióhoz, akkor a CRD-k automatikusan frissülnek a v1.3.0 csomagverzióra.
Új AKS-fürt létrehozása a Managed Gateway API CRD-kkel
Hozzon létre egy új AKS-fürtöt a
az aks createparanccsal és a--enable-gateway-apijelölővel, amelyre a Managed Gateway API CRD-k vannak telepítve. Egy támogatott bővítményt, például az Istio service mesh bővítményt is engedélyezheti ugyanahhoz a parancshoz. Az alábbi példaparancs létrehoz egy új AKS-fürtöt a Managed Gateway API telepítésével és az Istio service mesh bővítmény engedélyezésével:az aks create --resource-group myResourceGroup --name myAKSCluster --enable-gateway-api --enable-azure-service-mesh
Meglévő AKS-fürtön felügyelt átjáró API CRD-k telepítése
Telepítse a Managed Gateway API CRD-jait egy meglévő fürtre a
az aks updatejelölővel ellátott--enable-gateway-apiparanccsal.az aks update --resource-group myResourceGroup --name myAKSCluster --enable-gateway-api
Felügyelt átjáró API CRD-telepítésének ellenőrzése
Tekintse meg a fürtre telepített CRD-ket az alábbi
kubectl get crdsparanccsal:kubectl get crds | grep "gateway.networking.k8s.io"A kimenetnek meg kell jelenítenie a telepített CRD-ket, amelyek a Kubernetes Gateway API specifikációjának részét képezik. Például:
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:37ZEllenőrizze, hogy a CRD-k rendelkeznek-e a várt annotációkkal, és a csomag verziója illeszkedik a várt Kubernetes-verzióval a fürtön az alábbi paranccsal:
kubectl get crd gateways.gateway.networking.k8s.io -ojsonpath={.metadata.annotations} | jqA kimenetnek a várt széljegyzeteket kell megjelenítenie, beleértve a
gateway.networking.k8s.io/bundle-versionfürt Kubernetes-verziójának várt csomagverziójával rendelkező széljegyzetet is. Ha például a klaszter a Kubernetesv1.33.0futtatja, a várt csomagverzió azv1.2.1, és a kimenetnek a következőhöz hasonlónak kell lennie:{ "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" }
Egyéni erőforrás-definíciók eltávolítása a Felügyelt Átjáró API esetében egy AKS-fürtön
Távolítsa el a meglévő fürtön a Managed Gateway API CRD-ket a
az aks updateparanccsal és a--disable-gateway-apijelölővel.az aks update --resource-group myResourceGroup --name myAKSCluster --disable-gateway-api