Gateway API 支持矩阵
Nantian Gateway 目标对齐 Kubernetes Gateway API v1.5.1 规范。本页汇总当前对所有上游功能的支持情况,包括实验性功能与扩展功能。
- 默认支持 — 当
enableExperimentalGateway=false时声明的功能。 - 实验性运行时支持 — 当
enableExperimentalGateway=true时声明的功能。 - 当前状态 — Nantian Gateway 在运行时按条件启用的支持状态,数据来源为
internal/gatewayapi/supported_features.go和一致性工作流。
Gateway 扩展功能
Section titled “Gateway 扩展功能”| 功能 | 通道 | 默认 | 实验性 | 状态 |
|---|---|---|---|---|
| GatewayPort8080 | standard | Yes | Yes | 已支持 |
| GatewayStaticAddresses | standard | Yes | Yes | 已支持 |
| GatewayHTTPListenerIsolation | standard | Yes | Yes | 已支持 |
| GatewayHTTPSListenerDetectMisdirectedRequests | standard | Yes | Yes | 已支持 |
| GatewayInfrastructurePropagation | standard | Yes | Yes | 已支持 |
| GatewayAddressEmpty | standard | Yes | Yes | 已支持 |
| ListenerSet | standard | No | Yes | 仅实验性运行时 |
| GatewayBackendClientCertificate | standard | Yes | Yes | 已支持 |
| GatewayFrontendClientCertificateValidation | standard | No | No | 不支持 |
| GatewayFrontendClientCertificateValidationInsecureFallback | standard | No | No | 不支持 |
HTTPRoute 扩展功能
Section titled “HTTPRoute 扩展功能”| 功能 | 通道 | 默认 | 实验性 | 状态 |
|---|---|---|---|---|
| HTTPRouteDestinationPortMatching | experimental | Yes | Yes | 已支持 |
| HTTPRouteBackendRequestHeaderModification | standard | Yes | Yes | 已支持 |
| HTTPRouteQueryParamMatching | standard | Yes | Yes | 已支持 |
| HTTPRouteMethodMatching | standard | Yes | Yes | 已支持 |
| HTTPRouteResponseHeaderModification | standard | Yes | Yes | 已支持 |
| HTTPRoutePortRedirect | standard | Yes | Yes | 已支持 |
| HTTPRouteSchemeRedirect | standard | Yes | Yes | 已支持 |
| HTTPRoutePathRedirect | standard | Yes | Yes | 已支持 |
| HTTPRouteHostRewrite | standard | Yes | Yes | 已支持 |
| HTTPRoutePathRewrite | standard | Yes | Yes | 已支持 |
| HTTPRouteRequestMirror | standard | Yes | Yes | 已支持 |
| HTTPRouteRequestMultipleMirrors | experimental | Yes | Yes | 已支持 |
| HTTPRouteRequestPercentageMirror | experimental | Yes | Yes | 已支持 |
| HTTPRouteRequestTimeout | standard | Yes | Yes | 已支持 |
| HTTPRouteBackendTimeout | standard | Yes | Yes | 已支持 |
| HTTPRouteParentRefPort | standard | Yes | Yes | 已支持 |
| HTTPRouteNamedRouteRule | standard | Yes | Yes | 已支持 |
| HTTPRouteCORS | experimental | Yes | Yes | 已支持 |
| HTTPRoute303RedirectStatusCode | experimental | Yes | Yes | 已支持 |
| HTTPRoute307RedirectStatusCode | experimental | Yes | Yes | 已支持 |
| HTTPRoute308RedirectStatusCode | experimental | Yes | Yes | 已支持 |
| HTTPRouteBackendProtocolH2C | experimental | Yes | Yes | 已支持 |
| HTTPRouteBackendProtocolWebSocket | experimental | Yes | Yes | 已支持 |
| HTTPRouteBackendProtocolGRPC | experimental | No | No | 不支持 |
GRPCRoute 扩展功能
Section titled “GRPCRoute 扩展功能”| 功能 | 通道 | 默认 | 实验性 | 状态 |
|---|---|---|---|---|
| GRPCRouteNamedRouteRule | standard | Yes | Yes | 已支持 |
TLSRoute 扩展功能
Section titled “TLSRoute 扩展功能”| 功能 | 通道 | 默认 | 实验性 | 状态 |
|---|---|---|---|---|
| TLSRouteModeTerminate | experimental | No | Yes | 仅实验性运行时 |
| TLSRouteModeMixed | experimental | No | Yes | 仅实验性运行时 |
UDPRoute 扩展功能
Section titled “UDPRoute 扩展功能”| 功能 | 通道 | 默认 | 实验性 | 状态 |
|---|---|---|---|---|
| UDPRoute | experimental | No | Yes | 仅实验性运行时 |
Mesh 功能
Section titled “Mesh 功能”| 功能 | 通道 | 默认 | 实验性 | 状态 |
|---|---|---|---|---|
| Mesh | experimental | Yes | Yes | 已支持 |
| MeshConsumerRoute | experimental | Yes | Yes | 已支持 |
| MeshClusterIPMatching | experimental | Yes | Yes | 已支持 |
| MeshConsumerNamespaceMatching | experimental | No | No | 不支持 |
BackendLBPolicy 功能
Section titled “BackendLBPolicy 功能”| 功能 | 通道 | 默认 | 实验性 | 状态 |
|---|---|---|---|---|
| BackendLBSessionPersistence | standard | Yes | Yes | 已支持 |
BackendTLSPolicy 功能
Section titled “BackendTLSPolicy 功能”| 功能 | 通道 | 默认 | 实验性 | 状态 |
|---|---|---|---|---|
| BackendTLSPolicySANValidation | experimental | Yes | Yes | 已支持 |
Nantian Gateway 自有声明
Section titled “Nantian Gateway 自有声明”除上游 Gateway API 功能集外,Nantian Gateway 额外声明:
| 功能 | 描述 |
|---|---|
TCPRoute | TCP 路由支持 |
BackendLBSessionPersistence | 后端负载均衡的会话保持 |
UDPRoute | UDP 路由支持 |
启用实验性功能
Section titled “启用实验性功能”要启用实验性运行时功能,设置以下 Helm 值:
gatewayAPI: enableExperimentalGateway: true进行含实验性功能的一致性测试:
CONFORMANCE_EXPERIMENTAL=true ALL_FEATURES=true make conformance- 功能支持声明:
gateway/internal/gatewayapi/supported_features.go - 全功能一致性测试:
gateway/conformance/conformance_test.go - CI 工作流:
gateway/.github/workflows/conformance.yml