Instalace CRD rozhraní API spravované brány ve službě Azure Kubernetes Service (AKS) (Preview)

Rozhraní Kubernetes Gateway API je specifikace pro řízení provozu v clusterech Kubernetes. Specifikace vylepšuje Ingress API, které postrádá jednotný a na poskytovateli nezávislý přístup pro pokročilé směrování síťového provozu.

Instalace rozhraní API Kubernetes Gateway pro službu Azure Kubernetes Service (AKS) nainstaluje vlastní definice prostředků (CRD) pro toto rozhraní. Tyto identifikátory CRD můžete nainstalovat nezávisle na jakékoli konkrétní implementaci rozhraní API brány.

Poznámka:

Instalace spravovaného rozhraní API brány nainstaluje a spravuje pouze CRD API brány. Tyto identifikátory CRD můžete použít s vlastní implementací rozhraní API brány, ale podpora AKS platí jenom v případě, že používáte instalaci rozhraní API spravované brány s podporovaným doplňkem nebo rozšířením AKS, které implementuje rozhraní API brány. AKS nepodporuje proxy servery BYO ani jiné implementace rozhraní API samoobslužné brány.

Požadavky

Instalace nebo aktualizace aks-preview rozšíření

Důležité

Funkce AKS ve verzi Preview jsou k dispozici na bázi samoobsluhy a dobrovolného přihlášení. Ukázky jsou poskytovány "jak jsou" a "podle aktuální dostupnosti" a jsou vyloučené ze smluv o úrovni služeb a omezené záruky. Předběžné verze AKS jsou částečně pokryty zákaznickou podporou podle možností. Proto tyto funkce nejsou určené pro produkční použití. Další informace najdete v následujících článcích podpory:

  • aks-preview Nainstalujte rozšíření nebo aktualizujte na nejnovější verzi rozšíření pomocí příkazů az extension add a az extension update. pokud používáte Azure CLI. Musíte použít aks-preview verzi 19.0.0b4 a novější.

    # 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

Zaregistrujte příznak funkce pro rozhraní API spravované brány ve fázi Preview

  • Příznak funkce ManagedGatewayAPIPreview zaregistrujte pomocí příkazu az feature register.

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

Podporované verze Kubernetes pro verze balíčku Gateway API

Následující tabulka popisuje podporované verze Kubernetes pro váš cluster AKS pro každou verzi sady rozhraní API brány pro standard kanál:

Verze sady rozhraní API brány Podporované verze Kubernetes
v1.2.1 v1.26.0 – v1.33.x
v1.3.0 v1.34.x
v1.4.1 v1.35.0+

Poznámka:

Pokud upgradujete cluster AKS na novou podverzi po instalaci CRD rozhraní API spravované brány, CRD se automaticky upgraduje na novou podporovanou verzi sady API brány pro danou verzi Kubernetes. Pokud například upgradujete z AKS v1.33.0 na v1.34.0 a předtím jste měli nainstalované rozhraní Managed Gateway API pro verzi balíčku v1.2.1, CRD se automaticky upgraduje na verzi balíčku v1.3.0.

Vytvořte nový cluster AKS s nainstalovanými CRD rozhraní API pro spravované brány.

  • Pomocí příkazu s az aks create příznakem vytvořte nový cluster AKS s nainstalovanými --enable-gateway-api identifikátory CRD rozhraní API spravované brány. Volitelně můžete také povolit podporovaný doplněk, například doplněk Istio service mesh, ve stejném příkazu. Následující ukázkový příkaz vytvoří nový cluster AKS s instalací rozhraní API spravované brány a povoleným doplňkem Istio Service Mesh:

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

Instalace CRD rozhraní API spravované brány v existujícím clusteru AKS

  • Nainstalujte spravované brány API CRD do existujícího clusteru pomocí příkazu az aks update s příznakem --enable-gateway-api.

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

Ověřte instalaci CRD pro API spravované brány

  1. Pomocí následujícího kubectl get crds příkazu zobrazte disky CRD nainstalované v clusteru:

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

    Výstup by měl zobrazit nainstalované CRD, které jsou součástí specifikace rozhraní API brány Kubernetes. Například:

    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. Pomocí následujícího příkazu ověřte, že identifikátory CRD mají očekávané poznámky a verze sady odpovídá kubectl get crds pro váš cluster:

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

    Výstup by měl zobrazit očekávané poznámky, včetně poznámky gateway.networking.k8s.io/bundle-version s očekávanou verzí balíčku pro verzi Kubernetes vašeho clusteru. Pokud například váš cluster používá Kubernetes v1.33.0, očekávaná verze sady je v1.2.1a výstup by měl vypadat nějak takto:

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

Odinstalace CRD rozhraní API spravované brány v clusteru AKS

  • Odinstalujte CRD API spravované brány v existujícím clusteru pomocí příkazu az aks update s příznakem --disable-gateway-api.

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

Související obsah

  • Last updated on