Gateway API

更新时间:
复制 MD 格式

Gateway APIKubernetes中用于对服务网络流量进行建模的一系列资源,提供了一套表现力强、易扩展、面向角色的服务网络模型。本文介绍Gateway API组件信息、使用说明和变更记录。

组件介绍

Gateway APIKubernetes中用于对服务网络流量进行建模的一系列资源。它的目标是建立一套表现力强、易扩展、面向角色的服务网络模型。优势如下。

  • 面向角色:资源抽象与使用Kubernetes的团队组织架构保持一致。

  • 可移植:与IngressIngress Controller的关系相同,Gateway API也支持多种实现。

  • 表现力强:支持结构化表达流量处理的高级能力,例如灰度发布、权重发布等,避免Ingress需要依靠Annotation来指定流量处理能力的情况。

  • 可扩展:支持将CR附加到Gateway API各层的资源中,实现细粒度的功能配置。

使用说明

请参见Gateway API管理,通过Gateway with Inference Extension或阿里云负载均衡ALB使用Gateway API。

变更记录

202605

版本号

变更时间

变更内容

变更影响

v1.5.1

20250525

  • TLSRoute、ListenerSet、HTTPRoute CORS Filter、BackendTLSPolicy、SupportedFeatures、ReferenceGrant正式进入GA。

  • 弃用v1alpha2v1alpha3版本的TLSRoute API,XListenerSet已从Experimental通道移除,TLS Listener不再支持TCPRoute。

  • 新增ListenerSet资源,支持将Listener配置与Gateway解耦,便于多团队共享Gateway。

  • Gateway支持客户端证书校验及TLS Origination证书选择。

  • 更多变更内容,请见社区发布说明

由于v1alpha2版本TLSRoute API弃用,1.25及以下版本的服务网格ASM、1.29.2以下版本的Istio、0.21.0以下启用了Gateway API能力的External DNS,在升级到该版本后将会无法正常工作。请您在升级Gateway API组件前,优先升级相关服务和组件。

202506

版本号

变更时间

变更内容

变更影响

v1.3.0

20250605

  • 支持基于百分比的流量镜像能力。

  • 更多变更内容,请见社区发布说明

此次升级不会对业务造成影响。

202412

版本号

变更时间

变更内容

变更影响

v1.2.1

20241226

  • 该组件版本仅支持1.32及以上版本的集群。

  • GRPCRoute、ReferenceGrant弃用v1alpha2版本。

  • HTTPRoute支持设置后端超时时间。

  • 支持通过BackendProtocol设置后端协议。

  • 更多变更内容,请见社区发布说明

v1alpha2版本API弃用可能会导致依赖该版本的组件无法正常工作。请确认组件均已使用新版API后再执行升级。

202405

版本号

变更时间

变更内容

变更影响

v1.1.0

20240523

  • 该组件版本仅支持1.30及以上版本的集群。

  • Gateway、GatewayClass、HTTPRoute弃用v1alpha2版本API。

  • GRPCRoute、Service Mesh支持正式进入GA。

  • 更多变更内容,请见社区发布说明

v1alpha2版本API弃用可能会导致依赖该版本的组件无法正常工作。请确认组件均已使用新版API后再执行升级。

202402

版本号

变更时间

变更内容

变更影响

v1.0.1

20240201

  • 该组件版本仅支持1.28及以上集群。

  • Gateway、GatewayClass、HTTPRoute正式进入GA,提供v1版本的API。

  • 支持通过CEL校验配置的正确性。

  • 更多变更内容,请见社区发布说明

此次升级不会对业务造成影响。

202301

版本号

变更时间

变更内容

变更影响

v0.6.0

20230111

组件上线。

此次升级不会对业务造成影响。