本頁列出 Google Kubernetes Engine (GKE) 提供的 GatewayClass 資源功能,以及支援的規格。
表格圖例
本頁面各個表格的圖例說明如下:
- 表示系統支援該欄位。
 -表示系統不支援該欄位。- 如果 GKE 支援欄位中的某些值,表格會說明支援的值。
 
GatewayClass 功能
下表列出 GKE 提供的 GatewayClass 資源的區別特徵。
架構
| 功能 | gke-l7-global-external-managed | 
      gke-l7-global-external-managed-mc | 
      gke-l7-regional-external-managed | 
      gke-l7-regional-external-managed-mc | 
      gke-l7-cross-regional-internal-managed-mc | 
      gke-l7-rilb | 
      gke-l7-rilb-mc | 
      gke-l7-gxlb | 
      gke-l7-gxlb-mc | 
    
|---|---|---|---|---|---|---|---|---|---|
| GKE Gateway Controller | Google 代管的 Gateway 控制器 | ||||||||
| 位置 | Google Cloud 基礎架構 | ||||||||
| 平台 | GKE | ||||||||
| 叢集類型 | GKE Autopilot 或 GKE Standard | ||||||||
| 叢集範圍 | 單一叢集 | 多叢集 | 單一叢集 | 多叢集 | 單一叢集 | 多叢集 | 單一叢集 | 多叢集 | |
| GKE 版本 | GKE Autopilot:1.26 以上版本  GKE Standard:1.24 以上版本  | 
    ||||||||
| API 類型 | CRD | ||||||||
| CRD 版本 | 新叢集和叢集升級: GKE 1.24 至 1.27.10、1.28.4、1.29.0:0.7.0 GKE 1.27.10 以上版本、1.28.4 以上版本、1.29.0 至 1.29.2:0.8.1 GKE 1.29.3 以上版本、1.30.0 至 1.30.2:1.0.0 GKE 1.30.3-gke.1225000 以上版本:1.1.0  | 
    ||||||||
| API 版本 | gateway.networking.k8s.io/v1beta1 (CRD 版本:0.7.0 以上,包括 1.0.0)gateway.networking.k8s.io/v1 (CRD 版本:1.0.0 以上) | 
    ||||||||
| API 啟用 | GKE Autopilot:預設為啟用 | ||||||||
| 推出階段 | 正式發布版 | 正式發布版 | 正式發布版 | 正式發布版 | 正式發布版 | 正式發布版 | 正式發布版 | 正式發布版 | 正式發布版 | 
多叢集 Service
| 功能 | gke-l7-global-external-managed | 
      gke-l7-global-external-managed-mc | 
      gke-l7-regional-external-managed | 
      gke-l7-regional-external-managed-mc | 
      gke-l7-cross-regional-internal-managed-mc | 
      gke-l7-rilb | 
      gke-l7-rilb-mc | 
      gke-l7-gxlb | 
      gke-l7-gxlb-mc | 
    
|---|---|---|---|---|---|---|---|---|---|
| 必填 | |||||||||
| API 版本 | net.gke.io/v1 | 
      net.gke.io/v1 | 
      net.gke.io/v1 | 
      net.gke.io/v1 | 
      net.gke.io/v1 | 
    ||||
| 資源類型 | ServiceExport | ServiceExport | ServiceExport | ServiceExport | ServiceExport | 
負載平衡器
| 功能 | gke-l7-global-external-managed | 
      gke-l7-global-external-managed-mc | 
      gke-l7-regional-external-managed | 
      gke-l7-regional-external-managed-mc | 
      gke-l7-cross-regional-internal-managed-mc | 
      gke-l7-rilb | 
      gke-l7-rilb-mc | 
      gke-l7-gxlb | 
      gke-l7-gxlb-mc | 
    
|---|---|---|---|---|---|---|---|---|---|
| 類型 | 全域外部應用程式負載平衡器 | 區域性外部應用程式負載平衡器 | 內部應用程式負載平衡器 | 傳統版應用程式負載平衡器 | |||||
| 負載平衡器範圍 | 全球 | 區域 | 地區 | 區域 | 全球 | ||||
| 容器原生負載平衡 |  (預設,使用 GCE_VM_IP_PORT 區域性 NEG) | 
    ||||||||
虛擬私有雲
| 功能 | gke-l7-global-external-managed | 
      gke-l7-global-external-managed-mc | 
      gke-l7-regional-external-managed | 
      gke-l7-regional-external-managed-mc | 
      gke-l7-cross-regional-internal-managed-mc | 
      gke-l7-rilb | 
      gke-l7-rilb-mc | 
      gke-l7-gxlb | 
      gke-l7-gxlb-mc | 
    
|---|---|---|---|---|---|---|---|---|---|
| 支援共用虛擬私有雲 | 所有叢集和機群主專案都位於同一個共用 VPC 主機或服務專案中 | ||||||||
| 多條路徑共用閘道/Ingress | |||||||||
| 自動管理虛擬私有雲防火牆生命週期 | |||||||||
| 注意:您必須在共用虛擬私有雲端環境中,手動部署閘道的防火牆規則。 詳情請參閱閘道的防火牆規則。  | 
    |||||||||
閘道 IP 位址
| 功能 | gke-l7-global-external-managed | 
      gke-l7-global-external-managed-mc | 
      gke-l7-regional-external-managed | 
      gke-l7-regional-external-managed-mc | 
      gke-l7-cross-regional-internal-managed-mc | 
      gke-l7-rilb | 
      gke-l7-rilb-mc | 
      gke-l7-gxlb | 
      gke-l7-gxlb-mc | 
    
|---|---|---|---|---|---|---|---|---|---|
| 閘道 IP 位址指派 | 靜態或動態 | ||||||||
| 網路服務級別 IP 位址 | 進階級 | 標準級或進階級 | 標準級或進階級 | 進階級 | 進階級 | ||||
| 閘道 IP 位址可連線性 | 網際網路 | 網際網路 | 虛擬私有雲內部 | 網際網路 | |||||
| 多個通訊埠 (HTTP、HTTPS) 使用相同 IP 位址 | |||||||||
轉送和流量管理
| 功能 | gke-l7-global-external-managed | 
      gke-l7-global-external-managed-mc | 
      gke-l7-regional-external-managed | 
      gke-l7-regional-external-managed-mc | 
      gke-l7-cross-regional-internal-managed-mc | 
      gke-l7-rilb | 
      gke-l7-rilb-mc | 
      gke-l7-gxlb | 
      gke-l7-gxlb-mc | 
    
|---|---|---|---|---|---|---|---|---|---|
| 全球存取 | 全域負載平衡器隱含的 | 全域負載平衡器隱含的 | 全域負載平衡器隱含的 | ||||||
| 跨區域後端負載平衡 | |||||||||
| 跨專案負載平衡 | 後端服務和 NEG 必須位於同一專案 (由 GKE Gateway 控制器管理)  | 
    ||||||||
| 跨命名空間轉送 | |||||||||
| 主機/路徑轉送 | 前置比對、完全比對 | ||||||||
| 根據標頭轉送 | 完全比對 | ||||||||
| 路徑重新導向 | |||||||||
| 網址重寫 | |||||||||
| 流量拆分 | |||||||||
| 流量鏡像 | |||||||||
| 流量切換 | |||||||||
| 根據流量自動調度資源 | 預覽 | 預覽 | 預覽 | 預覽 | |||||
| 自訂要求標頭 | |||||||||
| 自訂回應標頭 | |||||||||
| GCPRoutingExtension | 不支援 | 不支援 | 預覽 | 不支援 | 不支援 | 預覽 | 不支援 | 不支援 | 不支援 | 
| GCPTrafficExtension | 預覽 | 不支援 | 預覽 | 不支援 | 不支援 | 預覽 | 不支援 | 不支援 | 不支援 | 
前端安全性
| 功能 | gke-l7-global-external-managed | 
      gke-l7-global-external-managed-mc | 
      gke-l7-regional-external-managed | 
      gke-l7-regional-external-managed-mc | 
      gke-l7-cross-regional-internal-managed-mc | 
      gke-l7-rilb | 
      gke-l7-rilb-mc | 
      gke-l7-gxlb | 
      gke-l7-gxlb-mc | 
    
|---|---|---|---|---|---|---|---|---|---|
| SSL 政策 | |||||||||
| HTTP 至 HTTPS 的重新導向 | |||||||||
| 支援多個傳輸層安全標準 (TLS) 憑證 | |||||||||
| 以 Kubernetes Secret 為基礎的憑證 | |||||||||
| 自行管理的 Compute Engine SSL 憑證 | |||||||||
| Google 代管的 Compute Engine SSL 憑證 | |||||||||
| 透過 Certificate Manager 自行管理 SSL 憑證 | |||||||||
| 透過 Certificate Manager 使用 Google 代管的 SSL 憑證 | 
後端服務屬性
| 功能 | gke-l7-global-external-managed | 
      gke-l7-global-external-managed-mc | 
      gke-l7-regional-external-managed | 
      gke-l7-regional-external-managed-mc | 
      gke-l7-cross-regional-internal-managed-mc | 
      gke-l7-rilb | 
      gke-l7-rilb-mc | 
      gke-l7-gxlb | 
      gke-l7-gxlb-mc | 
    
|---|---|---|---|---|---|---|---|---|---|
| 連線排除逾時 | |||||||||
| 工作階段相依性 | |||||||||
| HTTP 存取記錄設定 | |||||||||
| 後端服務逾時 | |||||||||
| 自訂負載平衡器健康檢查設定 | |||||||||
| 傳輸層安全標準 (TLS) 至後端服務 | |||||||||
| 支援的後端服務通訊協定 | HTTP、HTTPS、HTTP/2 | ||||||||
| 自訂預設後端 | |||||||||
額外 Google Cloud 服務
| 功能 | gke-l7-global-external-managed | 
      gke-l7-global-external-managed-mc | 
      gke-l7-regional-external-managed | 
      gke-l7-regional-external-managed-mc | 
      gke-l7-cross-regional-internal-managed-mc | 
      gke-l7-rilb | 
      gke-l7-rilb-mc | 
      gke-l7-gxlb | 
      gke-l7-gxlb-mc | 
    
|---|---|---|---|---|---|---|---|---|---|
| Identity-Aware Proxy (IAP) | |||||||||
| Google Cloud Armor 後端安全性政策 | |||||||||
| Cloud CDN | |||||||||
| GCPRoutingExtension 支援 | |||||||||
| GCPTrafficExtension 支援 | 
支援的 Gateway API 欄位
下表列出 GKE 支援的 Gateway API 規格欄位。
閘道
spec.addresses
詳情請參閱 Gateway 說明文件中的 spec.addresses。
| 欄位 | gke-l7-global-external-managed | 
      gke-l7-global-external-managed-mc | 
      gke-l7-regional-external-managed | 
      gke-l7-regional-external-managed-mc | 
      gke-l7-cross-regional-internal-managed-mc | 
      gke-l7-rilb | 
      gke-l7-rilb-mc | 
      gke-l7-gxlb | 
      gke-l7-gxlb-mc | 
    
|---|---|---|---|---|---|---|---|---|---|
type | 
      NamedAddress | 
    ||||||||
value | 
      靜態全域外部位址 | 靜態區域外部位址 | 靜態區域內部位址 | 靜態全域外部位址 | |||||
spec.listeners
詳情請參閱 Gateway 說明文件中的 spec.listeners。
| 欄位 | gke-l7-global-external-managed | 
      gke-l7-global-external-managed-mc | 
      gke-l7-regional-external-managed | 
      gke-l7-regional-external-managed-mc | 
      gke-l7-cross-regional-internal-managed-mc | 
      gke-l7-rilb | 
      gke-l7-rilb-mc | 
      gke-l7-gxlb | 
      gke-l7-gxlb-mc | 
    
|---|---|---|---|---|---|---|---|---|---|
protocol | 
      HTTP、HTTPS | ||||||||
port | 
      1-65535 | ||||||||
name | 
      |||||||||
hostname | 
      |||||||||
tls | 
      |||||||||
allowedRoutes | 
      |||||||||
spec.listeners.tls
詳情請參閱 Gateway 說明文件中的 spec.listeners.tls。
| 欄位 | gke-l7-global-external-managed | 
      gke-l7-global-external-managed-mc | 
      gke-l7-regional-external-managed | 
      gke-l7-regional-external-managed-mc | 
      gke-l7-cross-regional-internal-managed-mc | 
      gke-l7-rilb | 
      gke-l7-rilb-mc | 
      gke-l7-gxlb | 
      gke-l7-gxlb-mc | 
    
|---|---|---|---|---|---|---|---|---|---|
mode | 
      Terminate | 
    ||||||||
certificateRefs | 
      |||||||||
spec.listeners.tls.options
詳情請參閱 Gateway 說明文件中的 spec.listeners.tls.options。
| 欄位 | gke-l7-global-external-managed | 
      gke-l7-global-external-managed-mc | 
      gke-l7-regional-external-managed | 
      gke-l7-regional-external-managed-mc | 
      gke-l7-cross-regional-internal-managed-mc | 
      gke-l7-rilb | 
      gke-l7-rilb-mc | 
      gke-l7-gxlb | 
      gke-l7-gxlb-mc | 
    
|---|---|---|---|---|---|---|---|---|---|
networking.gke.io/pre-shared-certs | 
      全域 SSL 憑證資源參照 (自行管理或 Google 代管) | 區域性自行管理 SSL 憑證資源參照 | 區域性自行管理 SSL 憑證資源參照 | 全域 SSL 憑證資源參照 (自行管理或 Google 代管) | |||||
GCPTrafficExtension (預覽版)
下表列出 GKE 支援的 GCPTrafficExtension API 規格值。
spec.targetRefs
詳情請參閱 Gateway 說明文件中的 spec.targetRefs。
| 欄位 | gke-l7-global-external-managed | 
      gke-l7-global-external-managed-mc | 
      gke-l7-regional-external-managed | 
      gke-l7-regional-external-managed-mc | 
      gke-l7-cross-regional-internal-managed-mc | 
      gke-l7-rilb | 
      gke-l7-rilb-mc | 
      gke-l7-gxlb | 
      gke-l7-gxlb-mc | 
    
|---|---|---|---|---|---|---|---|---|---|
group | 
      gateway.networking.k8s.io | 
    ||||||||
kind | 
      Gateway | 
    ||||||||
name | 
      |||||||||
spec.extensionChains.extensions.BackendRef
詳情請參閱 Gateway 說明文件中的 spec.extensionChains.extensions.BackendRef。
| 欄位 | gke-l7-global-external-managed | 
      gke-l7-global-external-managed-mc | 
      gke-l7-regional-external-managed | 
      gke-l7-regional-external-managed-mc | 
      gke-l7-cross-regional-internal-managed-mc | 
      gke-l7-rilb | 
      gke-l7-rilb-mc | 
      gke-l7-gxlb | 
      gke-l7-gxlb-mc | 
    
|---|---|---|---|---|---|---|---|---|---|
group | 
      (empty) | 
    ||||||||
kind | 
      Service, GCPWasmPlugin | 
      Service | 
      Service | 
      Service | 
      Service | 
      Service | 
      Service | 
      Service | 
    |
name | 
      |||||||||
port | 
      |||||||||
spec.extensionChains.extensions.googleAPIServiceName
| 欄位 | gke-l7-global-external-managed | 
      gke-l7-global-external-managed-mc | 
      gke-l7-regional-external-managed | 
      gke-l7-regional-external-managed-mc | 
      gke-l7-cross-regional-internal-managed-mc | 
      gke-l7-rilb | 
      gke-l7-rilb-mc | 
      gke-l7-gxlb | 
      gke-l7-gxlb-mc | 
    
|---|---|---|---|---|---|---|---|---|---|
googleAPIServiceName | 
      
GCPRoutingExtension (搶先版)
下表列出 GKE 支援的 GCPRoutingExtension API 規格值。
spec.targetRefs
詳情請參閱 Gateway 說明文件中的 spec.targetRefs。
| 欄位 | gke-l7-global-external-managed | 
      gke-l7-global-external-managed-mc | 
      gke-l7-regional-external-managed | 
      gke-l7-regional-external-managed-mc | 
      gke-l7-cross-regional-internal-managed-mc | 
      gke-l7-rilb | 
      gke-l7-rilb-mc | 
      gke-l7-gxlb | 
      gke-l7-gxlb-mc | 
    
|---|---|---|---|---|---|---|---|---|---|
group | 
      gateway.networking.k8s.io | 
    ||||||||
kind | 
      Gateway | 
    ||||||||
name | 
      |||||||||
spec.extensionChains.extensions.BackendRef
詳情請參閱 Gateway 說明文件中的 spec.extensionChains.extensions.BackendRef。
| 欄位 | gke-l7-global-external-managed | 
      gke-l7-global-external-managed-mc | 
      gke-l7-regional-external-managed | 
      gke-l7-regional-external-managed-mc | 
      gke-l7-cross-regional-internal-managed-mc | 
      gke-l7-rilb | 
      gke-l7-rilb-mc | 
      gke-l7-gxlb | 
      gke-l7-gxlb-mc | 
    
|---|---|---|---|---|---|---|---|---|---|
group | 
      (empty) | 
    ||||||||
kind | 
      Service | 
    ||||||||
name | 
      |||||||||
port | 
      |||||||||
HTTPRoute
下表列出 GKE 支援的 HTTPRoute API 規格值。
spec.parentRefs
詳情請參閱 Gateway 說明文件中的 spec.parentRefs。
| 欄位 | gke-l7-global-external-managed | 
      gke-l7-global-external-managed-mc | 
      gke-l7-regional-external-managed | 
      gke-l7-regional-external-managed-mc | 
      gke-l7-cross-regional-internal-managed-mc | 
      gke-l7-rilb | 
      gke-l7-rilb-mc | 
      gke-l7-gxlb | 
      gke-l7-gxlb-mc | 
    
|---|---|---|---|---|---|---|---|---|---|
parentRefs.group | 
      |||||||||
parentRefs.kind | 
      |||||||||
parentRefs.namespace | 
      |||||||||
parentRefs.name | 
      |||||||||
parentRefs.sectionName | 
      |||||||||
parentRefs.port | 
      
spec.hostnames
詳情請參閱 Gateway 說明文件中的 spec.hostnames。
| 欄位 | gke-l7-global-external-managed | 
      gke-l7-global-external-managed-mc | 
      gke-l7-regional-external-managed | 
      gke-l7-regional-external-managed-mc | 
      gke-l7-cross-regional-internal-managed-mc | 
      gke-l7-rilb | 
      gke-l7-rilb-mc | 
      gke-l7-gxlb | 
      gke-l7-gxlb-mc | 
    
|---|---|---|---|---|---|---|---|---|---|
precise, wildcard | 
      
spec.rules
詳情請參閱 Gateway 說明文件中的 spec.rules。
| 欄位 | gke-l7-global-external-managed | 
      gke-l7-global-external-managed-mc | 
      gke-l7-regional-external-managed | 
      gke-l7-regional-external-managed-mc | 
      gke-l7-cross-regional-internal-managed-mc | 
      gke-l7-rilb | 
      gke-l7-rilb-mc | 
      gke-l7-gxlb | 
      gke-l7-gxlb-mc | 
    
|---|---|---|---|---|---|---|---|---|---|
path.type | 
      Exact, PathPrefix | 
    ||||||||
path.value | 
      |||||||||
headers.type | 
      Exact | 
    ||||||||
headers.name | 
      |||||||||
headers.value | 
      |||||||||
queryParams | 
      |||||||||
method | 
      |||||||||
spec.rules.backendRefs
詳情請參閱 Gateway 說明文件中的 spec.rules.backendRefs。
| 欄位 | gke-l7-global-external-managed | 
      gke-l7-global-external-managed-mc | 
      gke-l7-regional-external-managed | 
      gke-l7-regional-external-managed-mc | 
      gke-l7-cross-regional-internal-managed-mc | 
      gke-l7-rilb | 
      gke-l7-rilb-mc | 
      gke-l7-gxlb | 
      gke-l7-gxlb-mc | 
    
|---|---|---|---|---|---|---|---|---|---|
backendRef.group | 
      (empty), gateway.networking.k8s.io, net.gke.io | 
    ||||||||
backendRef.kind | 
      Service | 
      ServiceImport | 
      Service | 
      ServiceImport | 
      Service | 
      ServiceImport | 
      Service | 
      ServiceImport | 
    |
backendRef.name | 
      |||||||||
backendRef.namespace | 
      |||||||||
backendRef.port | 
      |||||||||
backendRef.weight | 
      |||||||||
backendRef.filters | 
      |||||||||
spec.rules.filters
詳情請參閱 Gateway 說明文件中的 spec.rules.filters。
| 欄位 | gke-l7-global-external-managed | 
      gke-l7-global-external-managed-mc | 
      gke-l7-regional-external-managed | 
      gke-l7-regional-external-managed-mc | 
      gke-l7-cross-regional-internal-managed-mc | 
      gke-l7-rilb | 
      gke-l7-rilb-mc | 
      gke-l7-gxlb | 
      gke-l7-gxlb-mc | 
    
|---|---|---|---|---|---|---|---|---|---|
type | 
      requestHeaderModifier, responseHeaderModifier, requestMirror, requestRedirect, urlRewrite | 
      ||||||||
requestHeaderModifier.add | 
      |||||||||
requestHeaderModifier.remove | 
      |||||||||
requestHeaderModifier.set | 
      |||||||||
responseHeaderModifier.add | 
      |||||||||
responseHeaderModifier.remove | 
      |||||||||
responseHeaderModifier.set | 
      |||||||||
requestMirror.backendRef | 
      |||||||||
requestRedirect.scheme | 
      HTTP, HTTPS | 
      ||||||||
requestRedirect.hostname | 
      |||||||||
requestRedirect.path | 
      replaceFullPath, replacePrefixMatch | 
      ||||||||
requestRedirect.port | 
      |||||||||
requestRedirect.statusCode | 
      |||||||||
urlRewrite.hostname | 
      |||||||||
urlRewrite.path | 
      replacePrefixMatch | 
      ||||||||
ReferenceGrant
下表列出 GKE 支援的ReferenceGrant API 規格值。
spec.from
詳情請參閱 Gateway 說明文件中的 spec.from。
| 欄位 | gke-l7-global-external-managed | 
      gke-l7-global-external-managed-mc | 
      gke-l7-regional-external-managed | 
      gke-l7-regional-external-managed-mc | 
      gke-l7-cross-regional-internal-managed-mc | 
      gke-l7-rilb | 
      gke-l7-rilb-mc | 
      gke-l7-gxlb | 
      gke-l7-gxlb-mc | 
    
|---|---|---|---|---|---|---|---|---|---|
group | 
      (empty), gateway.networking.k8s.io, net.gke.io | 
    ||||||||
kind | 
      Gateway, HTTPRoute | 
    ||||||||
namespace | 
      |||||||||
spec.to
詳情請參閱 Gateway 說明文件中的 spec.to。
| 欄位 | gke-l7-global-external-managed | 
      gke-l7-global-external-managed-mc | 
      gke-l7-regional-external-managed | 
      gke-l7-regional-external-managed-mc | 
      gke-l7-cross-regional-internal-managed-mc | 
      gke-l7-rilb | 
      gke-l7-rilb-mc | 
      gke-l7-gxlb | 
      gke-l7-gxlb-mc | 
    
|---|---|---|---|---|---|---|---|---|---|
group | 
      (empty), gateway.networking.k8s.io, net.gke.io | 
    ||||||||
kind | 
      Secret, Service, ServiceImport | 
    ||||||||
name | 
      |||||||||