全部產品
Search
文件中心

Container Service for Kubernetes:Gateway API

更新時間:Jun 06, 2026

Gateway API是Kubernetes中用於對服務網路流量進行建模的一系列資源,提供了一套表現力強、易擴充、面向角色的服務網路模型。本文介紹Gateway API組件資訊、使用說明和變更記錄。

組件介紹

Gateway API是Kubernetes中用於對服務網路流量進行建模的一系列資源。它的目標是建立一套表現力強、易擴充、面向角色的服務網路模型。優勢如下。

  • 面向角色:資源抽象與使用Kubernetes的團隊組織架構保持一致。

  • 可移植:與Ingress和Ingress Controller的關係相同,Gateway API也支援多種實現。

  • 表現力強:支援結構化表達流量處理的進階能力,例如灰階發布、權重發布等,避免Ingress需要依靠Annotation來指定流量處理能力的情況。

  • 可擴充:支援將CR附加到Gateway API各層的資源中,實現細粒度的功能配置。

使用說明

請參見Gateway API管理,通過Gateway with Inference Extension或阿里雲負載平衡ALB使用Gateway API。

變更記錄

2026年05月

版本號碼

變更時間

變更內容

變更影響

v1.5.1

2025年05月25日

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

  • 棄用v1alpha2和v1alpha3版本的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組件前,優先升級相關服務和組件。

2025年06月

版本號碼

變更時間

變更內容

變更影響

v1.3.0

2025年06月05日

  • 支援基於百分比的流量鏡像能力。

  • 更多變更內容,請見社區發布說明

此次升級不會對業務造成影響。

2024年12月

版本號碼

變更時間

變更內容

變更影響

v1.2.1

2024年12月26日

  • 該組件版本僅支援1.32及以上版本的叢集。

  • GRPCRoute、ReferenceGrant棄用v1alpha2版本。

  • HTTPRoute支援設定後端逾時時間。

  • 支援通過BackendProtocol設定後端協議。

  • 更多變更內容,請見社區發布說明

v1alpha2版本API棄用可能會導致依賴該版本的組件無法正常工作。請確認組件均已使用新版API後再執行升級。

2024年05月

版本號碼

變更時間

變更內容

變更影響

v1.1.0

2024年05月23日

  • 該組件版本僅支援1.30及以上版本的叢集。

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

  • GRPCRoute、Service Mesh支援正式進入GA。

  • 更多變更內容,請見社區發布說明

v1alpha2版本API棄用可能會導致依賴該版本的組件無法正常工作。請確認組件均已使用新版API後再執行升級。

2024年02月

版本號碼

變更時間

變更內容

變更影響

v1.0.1

2024年02月01日

  • 該組件版本僅支援1.28及以上叢集。

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

  • 支援通過CEL校正配置的正確性。

  • 更多變更內容,請見社區發布說明

此次升級不會對業務造成影響。

2023年01月

版本號碼

變更時間

變更內容

變更影響

v0.6.0

2023年01月11日

組件上線。

此次升級不會對業務造成影響。