Solo-io Gloo 项目：基于 Pet Store 示例应用的 GraphQL 服务发现入门指南

前言

在现代微服务架构中，GraphQL 作为一种强大的数据查询语言，越来越受到开发者的青睐。Solo-io Gloo 项目提供了强大的 GraphQL 功能支持，本文将带您通过 Pet Store 示例应用，了解 Gloo 中 GraphQL 服务发现的基本使用方法。

环境准备

在开始之前，请确保您已经具备以下条件：

1. 已安装 Kubernetes 集群
2. 已部署 Solo-io Gloo 网关
3. 具备基本的 kubectl 命令行工具使用知识

部署 Pet Store 示例应用

首先，我们需要部署 Pet Store 示例应用，这将作为我们 GraphQL 服务的后端数据源。

kubectl apply -f - <<EOF
apiVersion: apps/v1
kind: Deployment
metadata:
  labels:
    app: petstore
  name: petstore
  namespace: default
spec:
  selector:
    matchLabels:
      app: petstore
  replicas: 1
  template:
    metadata:
      labels:
        app: petstore
    spec:
      containers:
      - image: openapitools/openapi-petstore
        name: petstore
        env:
          - name: DISABLE_OAUTH
            value: "1"
          - name: DISABLE_API_KEY
            value: "1"
        ports:
        - containerPort: 8080
          name: http
---
apiVersion: v1
kind: Service
metadata:
  name: petstore
  namespace: default
  labels:
    service: petstore
spec:
  ports:
  - port: 8080
    protocol: TCP
  selector:
    app: petstore
EOF

注意：如果您使用的是 Apple M1 或 M2 芯片的机器，Pet Store 示例应用可能无法正常工作。

验证原始服务输出（可选）

在配置 GraphQL 服务之前，我们可以先验证原始服务的 JSON 输出：

1. 创建路由：

   glooctl add route --name default --namespace gloo-system --path-prefix / --dest-name default-petstore-8080 --dest-namespace gloo-system
   

2. 发送请求获取宠物信息：

   curl "$(glooctl proxy url)/v3/pet/10" -H 'Accept: application/json'
   

您将看到完整的 JSON 响应，包含所有宠物信息字段。

启用 GraphQL 服务发现

Gloo 会自动发现服务的 OpenAPI 规范并创建对应的 GraphQL 资源：

kubectl get graphqlapis -n gloo-system

查看生成的 GraphQL schema（可选）：

kubectl get graphqlapis default-petstore-8080 -o yaml -n gloo-system

配置 GraphQL 虚拟服务

接下来，我们需要创建一个虚拟服务，将特定路径的流量路由到 GraphQL 服务：

apiVersion: gateway.solo.io/v1
kind: VirtualService
metadata:
  name: 'default'
  namespace: 'gloo-system'
spec:
  virtualHost:
    domains:
    - '*'
    routes:
    - graphqlApiRef:
        name: default-petstore-8080
        namespace: gloo-system
      matchers:
      - prefix: /graphql

测试 GraphQL 查询

现在，我们可以发送 GraphQL 查询请求了。例如，只查询宠物名称：

curl "$(glooctl proxy url)/graphql" -H 'Content-Type: application/json' -d '{"query": "query {getPetById(petId: 10) {name}}"}'

您将看到仅包含请求字段的精简响应：

{"data":{"getPetById":{"name":"Rabbit 1"}}}

GraphQL 的优势

与直接查询上游服务相比，GraphQL 提供了以下优势：

1. 数据过滤：只返回请求的字段，减少网络传输
2. 单一端点：所有查询通过单一端点完成
3. 强类型系统：基于 schema 的类型安全查询
4. 减少请求次数：可以一次性获取多个资源

总结

通过本教程，您已经学会了如何在 Solo-io Gloo 中：

1. 部署示例应用
2. 启用 GraphQL 服务发现
3. 配置 GraphQL 路由
4. 执行 GraphQL 查询

GraphQL 的强大功能可以帮助您构建更高效、更灵活的 API 网关解决方案。接下来，您可以尝试更复杂的 GraphQL 查询，或者探索 Gloo 的其他高级功能。