Envoy Gateway 部署模式详解

概述

Envoy Gateway 作为 Kubernetes 上的 API 网关解决方案，提供了多种灵活的部署模式，以满足不同场景下的需求。本文将深入解析 Envoy Gateway 的各种部署模式及其适用场景，帮助您根据实际业务需求选择合适的部署方式。

基础部署模式

单一 GatewayClass 模式

这是最简单的部署方式，每个 Envoy Gateway 控制器仅关联一个 GatewayClass 资源。这种模式适合以下场景：

• 每个网关需要独立的资源配置
• 业务逻辑简单，不需要复杂的多租户隔离
• 资源消耗不是主要考虑因素

特点：

• 配置简单直接
• 资源隔离性好
• 适合小型应用或测试环境

多 GatewayClass 模式

单个 Envoy Gateway 控制器可以关联多个 GatewayClass 资源，这种模式提供了更大的灵活性：

• 允许在同一控制器下管理多个网关配置
• 减少了控制器实例数量
• 适合中等规模的应用场景

高级部署模式

多租户隔离部署

在实际生产环境中，不同团队或部门（租户）通常需要独立的网关资源。Envoy Gateway 支持通过命名空间实现多租户隔离：

1. 部署架构：

   • 每个租户在独立的命名空间中部署 Envoy Gateway 控制器
   • 控制器仅监控所属命名空间内的资源
   • 为每个租户配置唯一的控制器名称

2. 实现步骤：

   • 为每个团队创建独立命名空间（如 marketing、product）
   • 在每个命名空间部署独立的 Envoy Gateway 实例
   • 配置专属的 GatewayClass 和关联资源

3. 优势：

   • 资源完全隔离，避免相互影响
   • 各团队可自主管理自己的网关配置
   • 安全性更高，减少误操作风险

网关合并部署模式

默认情况下，每个 Gateway 都会创建独立的 Envoy Proxy 实例。但在某些场景下，合并多个 Gateway 的监听器到单个 Envoy Proxy 集群更为合适：

1. 适用场景：

   • 需要集中管理所有流量
   • 希望减少基础设施资源消耗
   • 需要为所有监听器提供单一入口点

2. 配置方法：

   • 在 EnvoyProxy 资源中设置 mergeGateways: true
   • 确保所有监听器的端口、协议和主机名组合唯一

3. 优势：

   • 资源利用率更高
   • 管理更集中
   • 减少 IP 地址消耗

Kubernetes 部署实践

默认监控模式

Envoy Gateway 默认会：

• 监控所有命名空间中的资源（如 Service 和 HTTPRoute）
• 在 Envoy Gateway 运行的命名空间中创建数据平面资源（如 EnvoyProxy Deployment）

命名空间限定模式

可以通过配置实现只监控特定命名空间：

• 设置 EnvoyGateway.provider.kubernetes.watch.namespaces 指定监控的命名空间列表
• 或使用 namespaceSelector 基于标签选择命名空间

实战示例

多租户部署示例

1. 为营销团队部署：

helm install \
--set config.envoyGateway.gateway.controllerName=gateway.envoyproxy.io/marketing-gatewayclass-controller \
--set config.envoyGateway.provider.kubernetes.watch.namespaces={marketing} \
eg-marketing -n marketing --create-namespace

2. 为产品团队部署：

helm install \
--set config.envoyGateway.gateway.controllerName=gateway.envoyproxy.io/product-gatewayclass-controller \
--set config.envoyGateway.provider.kubernetes.watch.namespaces={product} \
eg-product -n product --create-namespace

网关合并部署验证

1. 检查网关状态：

kubectl get gateways -n default

2. 测试路由：

curl --header "Host: www.merged1.com" http://$GATEWAY_HOST:8080/example

最佳实践建议

1. 小型项目：采用单一 GatewayClass 模式，简化管理
2. 中型项目：考虑多 GatewayClass 模式，平衡灵活性与复杂度
3. 大型企业：
   • 使用多租户隔离部署，确保团队间资源隔离
   • 对公共入口考虑网关合并部署，提高资源利用率
4. 性能关键型应用：根据流量模式选择是否合并网关，权衡资源消耗与隔离性

常见问题排查

1. 端口冲突：在合并部署时，确保监听器端口不冲突
2. 路由失效：检查 GatewayClass 的 controllerName 是否与部署配置匹配
3. 资源隔离问题：确认命名空间配置正确，特别是多租户场景

通过理解这些部署模式的特点和适用场景，您可以根据实际业务需求选择最合适的 Envoy Gateway 部署策略，实现高效、安全的 API 网关管理。