Solo.io Gloo 静态上游(Static Upstream)配置指南

什么是静态上游

在 Solo.io Gloo 项目中，静态上游(Static Upstream)是一种明确且静态定义的上游服务目标。它允许管理员手动配置路由规则，将流量导向特定的后端服务端点。与动态发现的上游不同，静态上游需要管理员显式定义所有目标主机的地址和端口。

静态上游的应用场景

静态上游特别适用于以下场景：

1. 路由到外部服务（如第三方API）
2. 指向特定IP地址或域名的服务
3. 测试环境中的固定后端服务
4. 不需要自动发现的服务端点

配置静态上游的注意事项

当创建指向Kubernetes服务地址的静态上游资源时，Gloo Gateway会依赖kube-proxy进行负载均衡，这可能会影响性能。为避免性能问题，可以考虑：

• 使用动态上游(Dynamic Upstreams)
• 手动创建使用标签选择器(Label Selectors)的上游资源

实战：配置JSON测试API的上游

下面我们通过一个具体示例，展示如何配置Gloo Gateway将请求路由到JSON测试API(http://jsonplaceholder.typicode.com/)。

第一步：创建静态上游

我们可以通过两种方式创建名为json-upstream的静态上游：

方式一：使用YAML文件

apiVersion: gloo.solo.io/v1
kind: Upstream
metadata:
  name: json-upstream
  namespace: gloo-system
spec:
  static:
    hosts:
    - addr: jsonplaceholder.typicode.com
      port: 80

方式二：使用命令行工具

glooctl create upstream static --static-hosts jsonplaceholder.typicode.com:80 --name json-upstream

第二步：创建虚拟服务

接下来，我们需要创建一个虚拟服务(Virtual Service)，将所有发往foo域的请求路由到我们刚创建的上游。

apiVersion: gateway.solo.io/v1
kind: VirtualService
metadata:
  name: test-static
  namespace: gloo-system
spec:
  virtualHost:
    domains:
    - foo
    routes:
    - matchers:
      - prefix: /
      routeAction:
        single:
          upstream:
            name: json-upstream
            namespace: gloo-system

第三步：测试路由配置

配置完成后，我们可以使用curl命令测试路由是否生效：

curl -H "Host: foo" $(glooctl proxy url)/posts

如果配置正确，将会返回JSON测试API的响应数据，包含一系列模拟的博客文章内容。

性能优化建议

对于生产环境，特别是当上游是Kubernetes服务时，建议：

1. 考虑使用动态上游而非静态上游
2. 如果必须使用静态上游，确保配置了正确的端口和协议
3. 对于大规模部署，监控上游服务的性能指标
4. 考虑使用连接池配置优化性能

清理测试资源

完成测试后，记得删除创建的测试资源：

方式一：使用kubectl

kubectl delete vs -n gloo-system test-static
kubectl delete upstream -n gloo-system json-upstream

方式二：使用glooctl

glooctl delete vs test-static
glooctl delete upstream json-upstream

总结

本文详细介绍了在Solo.io Gloo中配置静态上游的完整流程。通过这个示例，我们学习了如何：

1. 定义静态上游资源
2. 创建虚拟服务并配置路由规则
3. 测试路由配置
4. 清理测试环境

静态上游是Gloo Gateway中基础但重要的功能，掌握它的配置方法对于构建稳定的服务网格架构至关重要。