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

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

2025-06-12 05:04:16作者:邵娇湘

前言

在现代微服务架构中,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 的其他高级功能。

登录后查看全文
热门项目推荐

项目优选

收起
kernelkernel
deepin linux kernel
C
22
6
docsdocs
OpenHarmony documentation | OpenHarmony开发者文档
Dockerfile
197
2.17 K
ohos_react_nativeohos_react_native
React Native鸿蒙化仓库
C++
208
285
pytorchpytorch
Ascend Extension for PyTorch
Python
59
94
RuoYi-Vue3RuoYi-Vue3
🎉 (RuoYi)官方仓库 基于SpringBoot,Spring Security,JWT,Vue3 & Vite、Element Plus 的前后端分离权限管理系统
Vue
974
574
nop-entropynop-entropy
Nop Platform 2.0是基于可逆计算理论实现的采用面向语言编程范式的新一代低代码开发平台,包含基于全新原理从零开始研发的GraphQL引擎、ORM引擎、工作流引擎、报表引擎、规则引擎、批处理引引擎等完整设计。nop-entropy是它的后端部分,采用java语言实现,可选择集成Spring框架或者Quarkus框架。中小企业可以免费商用
Java
9
1
ops-mathops-math
本项目是CANN提供的数学类基础计算算子库,实现网络在NPU上加速计算。
C++
549
81
openHiTLSopenHiTLS
旨在打造算法先进、性能卓越、高效敏捷、安全可靠的密码套件,通过轻量级、可剪裁的软件技术架构满足各行业不同场景的多样化要求,让密码技术应用更简单,同时探索后量子等先进算法创新实践,构建密码前沿技术底座!
C
1.02 K
399
communitycommunity
本项目是CANN开源社区的核心管理仓库,包含社区的治理章程、治理组织、通用操作指引及流程规范等基础信息
393
27
MateChatMateChat
前端智能化场景解决方案UI库,轻松构建你的AI应用,我们将持续完善更新,欢迎你的使用与建议。 官网地址:https://matechat.gitcode.com
1.2 K
133