Delen via

Beheerde Gateway API CRD's installeren op Azure Kubernetes Service (AKS) (preview)

De Kubernetes Gateway-API is een specificatie voor verkeerbeheer op Kubernetes-clusters. De specificatie verbetert de Ingress API, die een geïntegreerde en provideragnostische benadering voor geavanceerde verkeersroutering mist.

De installatie van de Managed Gateway API voor Azure Kubernetes Service (AKS) installeert de Custom Resource Definitions (CRDs) voor de Kubernetes Gateway API. Met de installatie van de Managed Gateway-API kunt u gateway-API-functionaliteit gebruiken in een volledig ondersteunde modus op AKS.

Vereiste voorwaarden

De aks-preview extensie installeren of bijwerken

Belangrijk

AKS preview-functies zijn beschikbaar op selfservice, opt-in basis. Previews worden geleverd 'zoals het is' en 'voor zover beschikbaar' en zijn uitgesloten van de serviceovereenkomsten en beperkte garantie. AKS-previews worden gedeeltelijk gedekt door klantondersteuning naar best vermogen. Zodoende zijn deze functies niet bedoeld voor productiegebruik. Zie de volgende ondersteuningsartikelen voor meer informatie:

  • Installeer de aks-preview extensie of werk de extensie bij naar de nieuwste versie met behulp van de opdrachten az extension add en az extension update. als u Azure CLI gebruikt. U moet versie aks-preview en hoger gebruiken19.0.0b4.

    # 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

De preview-functievlag van de Managed Gateway-API registreren

  • Registreer de ManagedGatewayAPIPreview functievlag met behulp van de az feature register opdracht.

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

Ondersteunde Kubernetes-versies voor gateway-API-bundelversies

De volgende tabel bevat een overzicht van de ondersteunde Kubernetes-versies voor uw AKS-cluster voor elke gateway-API-bundelversie voor het standard kanaal:

Gateway-API-bundelversie Ondersteunde Kubernetes-versies
v1.2.1 v1.26.0 - v1.33.x
v1.3.0 v1.34.x
v1.4.1 v1.35.0+

Opmerking

Als u uw AKS-cluster upgraden naar een nieuwe kleine versie nadat u de beheerde Gateway API-CRD's hebt geïnstalleerd, upgraden de CRD's automatisch naar de nieuwe ondersteunde Gateway API-bundelversie voor die Kubernetes-versie. Als u bijvoorbeeld een upgrade uitvoert van AKS v1.33.0 naar v1.34.0 en eerder de Managed Gateway-API voor bundelversie v1.2.1had geïnstalleerd, upgraden de CRD's automatisch naar de bundelversie v1.3.0.

Een nieuw AKS-cluster maken met geïnstalleerde Managed Gateway API CRD's

  • Maak een nieuw AKS-cluster met beheerde gateway-API-CRD's die zijn geïnstalleerd met behulp van de az aks create opdracht met de --enable-gateway-api vlag. U kunt ook een ondersteunde invoegtoepassing inschakelen, zoals de Mesh-invoegtoepassing van de Istio-service, in dezelfde opdracht. Met de volgende voorbeeldopdracht maakt u een nieuw AKS-cluster met de installatie van de Managed Gateway-API en de invoegtoepassing Istio-service-mesh ingeschakeld:

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

Beheerde Gateway API CRD's installeren op een bestaand AKS-cluster

  • Installeer beheerde gateway-API-CRD's op een bestaand cluster waarvoor een ondersteunde implementatie is ingeschakeld met behulp van de az aks update opdracht met de --enable-gateway-api vlag.

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

Controleer de installatie van de beheerde gateway-API CRD

  1. Bekijk de CRD's die op uw cluster zijn geïnstalleerd met behulp van de volgende kubectl get crds opdracht:

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

    In de uitvoer moeten de geïnstalleerde CRD's worden weergegeven, die deel uitmaken van de Kubernetes Gateway-API-specificatie. Voorbeeld:

    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. Controleer of de CRD's de verwachte aantekeningen hebben en dat de bundelversie overeenkomt met de verwachte Kubernetes-versie voor uw cluster met behulp van de volgende kubectl get crds opdracht:

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

    In de uitvoer moeten de verwachte aantekeningen worden weergegeven, inclusief de gateway.networking.k8s.io/bundle-version aantekening met de verwachte bundelversie voor de Kubernetes-versie van uw cluster. Als uw cluster bijvoorbeeld Kubernetes v1.33.0 uitvoert, is de verwachte bundelversie v1.2.1 en moet de uitvoer er als volgt uitzien:

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

Beheerde gateway-API-CRD's verwijderen op een AKS-cluster

  • Verwijder beheerde gateway-API-CRD's op een bestaand cluster met behulp van de az aks update opdracht met de --disable-gateway-api vlag.

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

Verwante inhoud

  • Last updated on