Gateway API component for the service networking model - Container Service for Kubernetes

Présentation

L'API Gateway modélise la mise en réseau des services dans Kubernetes grâce à une API expressive, extensible et orientée par rôle. Avantages :

Orientée par rôle : les ressources API s'alignent sur les rôles organisationnels au sein de Kubernetes.
Portable : tout comme Ingress, l'API Gateway est une spécification disposant de plusieurs implémentations.
Explicative : des ressources dédiées permettent une gestion avancée du trafic (déploiements canari, déploiements pondérés), remplaçant ainsi les annotations Ingress non structurées.
Extensible : attachez des ressources personnalisées à différents niveaux de l'API pour une configuration granulaire.

Utilisation

Consultez Gérer l'API Gateway pour utiliser l'API Gateway avec Gateway with Inference Extension ou Application Load Balancer (ALB).

Journal des modifications

Mai 2026

Version

Date de publication

Description

Impact

v1.5.1

25 mai 2025

TLSRoute, ListenerSet, le filtre CORS HTTPRoute, BackendTLSPolicy, SupportedFeatures et ReferenceGrant sont désormais disponibles en version générale (GA).
Les API TLSRoute v1alpha2 et v1alpha3 sont obsolètes. XListenerSet est supprimé du canal expérimental et les écouteurs TLS ne prennent plus en charge TCPRoute.
ListenerSet dissocie la configuration des écouteurs d'une passerelle, permettant ainsi à plusieurs équipes de partager une même passerelle.
Les passerelles prennent désormais en charge la validation des certificats clients et la sélection des certificats d'origine TLS.
Consultez les notes de publication de la communauté.

La dépréciation de l'API TLSRoute v1alpha2 entraîne une rupture de compatibilité pour les composants suivants après la mise à niveau : Service Mesh (ASM) 1.25 et versions antérieures, Istio antérieur à la version 1.29.2, ainsi qu'External DNS antérieur à la version 0.21.0 avec l'API Gateway activée. Mettez à niveau ces composants avant de mettre à niveau le module complémentaire Gateway API.

Juin 2025

Version	Date de publication	Description	Impact
v1.3.0	5 juin 2025	La duplication du trafic basée sur un pourcentage est désormais prise en charge. Consultez les notes de publication de la communauté.	Cette mise à niveau n'affecte pas les charges de travail existantes.

Décembre 2024

Version	Date de publication	Description	Impact
v1.2.1	26 décembre 2024	Cette version du module complémentaire nécessite Kubernetes 1.32 ou une version ultérieure. GRPCRoute et ReferenceGrant rendent obsolète la version `v1alpha2`. HTTPRoute prend désormais en charge les délais d'expiration backend. Configurez le protocole backend avec `BackendProtocol`. Consultez les notes de publication de la communauté.	Le passage en obsolescence de l'API `v1alpha2` peut entraîner des ruptures de compatibilité pour les composants dépendants. Avant la mise à niveau, assurez-vous que tous les composants utilisent la nouvelle version de l'API.

Mai 2024

Version	Date de publication	Description	Impact
v1.1.0	23 mai 2024	Cette version du module complémentaire nécessite Kubernetes 1.30 ou une version ultérieure. Gateway, GatewayClass et HTTPRoute rendent obsolète la version d'API `v1alpha2`. La prise en charge de GRPCRoute et ASM est disponible en version générale (GA). Consultez les notes de publication de la communauté.	Le passage en obsolescence de l'API `v1alpha2` peut entraîner des ruptures de compatibilité pour les composants dépendants. Avant la mise à niveau, assurez-vous que tous les composants utilisent la nouvelle version de l'API.

Février 2024

Version	Date de publication	Description	Impact
v1.0.1	1er février 2024	Cette version du module complémentaire nécessite Kubernetes 1.28 ou une version ultérieure. Gateway, GatewayClass et HTTPRoute sont disponibles en version générale (GA) avec la version d'API `v1`. Validez la configuration à l'aide de CEL. Consultez les notes de publication de la communauté.	Cette mise à niveau n'affecte pas les charges de travail existantes.

Janvier 2023

Version	Date de publication	Description	Impact
v0.6.0	11 janvier 2023	Première version du module complémentaire.	Cette mise à niveau n'affecte pas les charges de travail existantes.