Partager via

Installer des CRD d’API de passerelle managée sur Azure Kubernetes Service (AKS) (préversion)

L’API de passerelle Kubernetes est une spécification de la gestion du trafic sur les clusters Kubernetes. La spécification améliore l’API d’entrée, qui ne dispose pas d’une approche unifiée et indépendante du fournisseur pour le routage avancé du trafic.

L'installation de l'API de passerelle managée pour Azure Kubernetes Service (AKS) installe les définitions de ressources personnalisées (CRDs) pour l'API de passerelle de Kubernetes. Avec l'installation de l'API passerelle gérée, vous pouvez utiliser les fonctionnalités de l'API Gateway en mode complètement pris en charge sur AKS.

Prerequisites

Installer ou mettre à jour l’extension aks-preview

Important

Les fonctionnalités d’évaluation AKS sont disponibles en libre-service et font l’objet d’un abonnement. Les versions d'essai sont fournies « en l’état » et « selon disponibilité », et elles sont exclues des contrats de niveau de service et de la garantie limitée. Les versions préliminaires AKS sont, dans la mesure du possible, partiellement couvertes par le service clientèle. Par conséquent, ces fonctionnalités ne sont pas destinées à une utilisation en production. Pour plus d’informations, consultez les articles de support suivants :

  • Installez l’extension aks-preview ou mettez-la à jour vers sa dernière version en utilisant les commandes az extension add et az extension update. si vous utilisez Azure CLI. Vous devez utiliser la version aks-preview19.0.0b4 et les versions ultérieures.

    # 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

Inscrire l’indicateur de fonctionnalité en préversion de l’API de passerelle gérée

  • Inscrivez l’indicateur de fonctionnalité ManagedGatewayAPIPreview à l’aide de la commande az feature register.

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

Versions Kubernetes prises en charge pour les versions de bundle d’API Gateway

Le tableau suivant présente les versions de Kubernetes prises en charge pour votre cluster AKS pour chaque version de bundle d’API de passerelle pour le standard canal :

Version du bundle d’API de passerelle Versions Kubernetes prises en charge
v1.2.1 v1.26.0 - v1.33.x
v1.3.0 v1.34.x
v1.4.1 v1.35.0+

Note

Si vous mettez à niveau votre cluster AKS vers une nouvelle version mineure après avoir installé les CRD d’API de passerelle managée, les CRD sont automatiquement mis à niveau vers la nouvelle version prise en charge de l’offre groupée d’API de passerelle pour cette version de Kubernetes. Par exemple, si vous effectuez une mise à niveau à partir d’AKS v1.33.0 vers v1.34.0 et que l’API de Passerelle Managée a été installée pour la version de bundle v1.2.1, les CRD sont automatiquement mises à niveau vers la version v1.3.0.

Créer un cluster AKS avec les CRD de l'API de passerelle gérée installées

  • Créez un nouveau cluster AKS avec les CRD de l'API de passerelle gérée installées en utilisant la commande az aks create avec l'indicateur --enable-gateway-api. Vous pouvez également activer un module complémentaire pris en charge, tel que le module complémentaire Istio Service Mesh, dans la même commande. L’exemple de commande suivant crée un cluster AKS avec l’installation de l’API De passerelle managée et le module complémentaire Istio Service Mesh activé :

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

Installer des CRD d’API de passerelle managée sur un cluster AKS existant

  • Installez les CRD de l’API de passerelle gérée sur un cluster existant doté d'une implémentation prise en charge, activée à l’aide de la commande az aks update avec l’indicateur --enable-gateway-api.

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

Vérifier l’installation du CRD pour l’API de passerelle gérée

  1. Affichez les CRD installés sur votre cluster à l’aide de la commande suivante kubectl get crds :

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

    La sortie doit afficher les CRD installés, qui font partie de la spécification de l’API de passerelle Kubernetes. Par exemple:

    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. Vérifiez que les CRD ont les annotations attendues et que la version du bundle correspond à la version de Kubernetes attendue pour votre cluster à l’aide de la commande suivante kubectl get crds :

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

    La sortie doit afficher les annotations attendues, notamment l’annotation gateway.networking.k8s.io/bundle-version avec la version de bundle attendue pour la version Kubernetes de votre cluster. Par exemple, si votre cluster exécute Kubernetes v1.33.0, la version attendue de l’offre groupée est v1.2.1et que la sortie doit être similaire à ce qui suit :

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

Désinstaller les CRD de l'API Gateway managée sur un cluster AKS

  • Désinstallez les CRD de l’API de passerelle gérée sur un cluster existant en utilisant la commande az aks update avec l’indicateur --disable-gateway-api.

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

Contenu connexe

  • Last updated on