使用Docker Compose在本地运行Solo.io Gloo Gateway
前言
Solo.io Gloo Gateway是一个功能强大的API网关,通常部署在Kubernetes环境中。然而,对于开发测试场景或学习目的,开发者可能希望在本地环境中快速启动Gloo Gateway。本文将详细介绍如何使用Docker Compose在本地机器上运行Gloo Gateway,无需Kubernetes集群。
核心概念解析
在深入部署之前,我们需要理解几个关键概念:
-
Gloo Gateway架构:由控制平面(Gloo)和数据平面(Envoy)组成,控制平面负责配置管理,数据平面处理实际流量
-
Upstream:代表Gloo Gateway可以路由到的目标服务,包含服务地址和可用API信息
-
Virtual Service:定义路由规则,指定如何将入站请求映射到Upstream
-
本地文件存储:当不使用Kubernetes时,Gloo Gateway可以使用本地文件系统替代Kubernetes的ConfigMap和Secret
环境准备
软件要求
在开始之前,请确保您的系统已安装:
- Docker 18.06或更高版本
- Docker Compose 1.25.0或更高版本
获取部署文件
部署所需的文件结构如下:
docker-compose-file/
├── source_data/ # 初始配置文件
│ ├── config/ # 网关配置
│ ├── envoy-config.yaml # Envoy配置
│ └── gloo-system/ # 系统配置
├── docker-compose.yaml # 容器编排定义
└── prepare-directories.sh # 目录准备脚本
详细部署步骤
1. 初始化目录结构
运行准备脚本创建必要的目录结构:
./prepare-directories.sh
该脚本会创建data
目录,其中包含:
config/
:存储所有Gloo配置secret/
:存储敏感信息artifact/
:存储运行时生成的文件
2. 关键配置文件解析
gloo-system/default.yaml:定义Gloo Gateway的基本配置,包括:
- 配置存储位置
- 密钥存储位置
- 监控设置
envoy-config.yaml:配置Envoy代理的行为,包括:
- 监听端口
- 访问日志
- 管理接口
3. 启动服务
使用Docker Compose启动服务:
docker-compose up
这会启动三个核心服务:
- petstore:示例应用,提供REST API
- gloo:Gloo控制平面
- gateway-proxy:基于Envoy的数据平面
配置详解
Upstream配置
Petstore的Upstream配置(petstore.yaml
)定义了:
- 服务地址(petstore:8080)
- Swagger API文档位置
- REST接口转换规则
static:
hosts:
- addr: petstore
port: 8080
serviceSpec:
rest:
swaggerInfo:
url: http://petstore:8080/swagger.json
transformations:
# 各API端点定义
Virtual Service配置
默认Virtual Service(default.yaml
)定义了路由规则:
virtualHost:
domains: ['*']
routes:
- matchers: [{exact: /petstore}]
options: {prefixRewrite: /api/pets}
routeAction:
single: {upstream: {name: petstore, namespace: gloo-system}}
这条规则表示:
- 匹配精确路径
/petstore
- 重写前缀为
/api/pets
- 路由到petstore upstream
功能验证
测试基本路由
curl http://localhost:8080/petstore
预期响应:
[{"id":1,"name":"Dog","status":"available"},{"id":2,"name":"Cat","status":"pending"}]
测试函数路由
curl http://localhost:8080/petstore/findWithId/1
预期响应:
{"id":1,"name":"Dog","status":"available"}
生产环境注意事项
本文描述的部署方式适合本地开发和测试,生产环境应考虑:
- 使用更可靠的存储后端(如Consul/Vault)
- 配置高可用架构
- 实施适当的监控和日志收集
- 加强安全配置
进阶学习建议
掌握基础部署后,可以进一步探索:
- 添加身份验证和授权
- 配置流量控制和限流
- 实现金丝雀发布
- 设置监控和告警
通过本地Docker Compose部署,开发者可以快速体验Gloo Gateway的核心功能,为后续在生产环境中的部署奠定基础。
- DDeepSeek-V3.1-BaseDeepSeek-V3.1 是一款支持思考模式与非思考模式的混合模型Python00
- QQwen-Image-Edit基于200亿参数Qwen-Image构建,Qwen-Image-Edit实现精准文本渲染与图像编辑,融合语义与外观控制能力Jinja00
GitCode-文心大模型-智源研究院AI应用开发大赛
GitCode&文心大模型&智源研究院强强联合,发起的AI应用开发大赛;总奖池8W,单人最高可得价值3W奖励。快来参加吧~050CommonUtilLibrary
快速开发工具类收集,史上最全的开发工具类,欢迎Follow、Fork、StarJava04GitCode百大开源项目
GitCode百大计划旨在表彰GitCode平台上积极推动项目社区化,拥有广泛影响力的G-Star项目,入选项目不仅代表了GitCode开源生态的蓬勃发展,也反映了当下开源行业的发展趋势。06GOT-OCR-2.0-hf
阶跃星辰StepFun推出的GOT-OCR-2.0-hf是一款强大的多语言OCR开源模型,支持从普通文档到复杂场景的文字识别。它能精准处理表格、图表、数学公式、几何图形甚至乐谱等特殊内容,输出结果可通过第三方工具渲染成多种格式。模型支持1024×1024高分辨率输入,具备多页批量处理、动态分块识别和交互式区域选择等创新功能,用户可通过坐标或颜色指定识别区域。基于Apache 2.0协议开源,提供Hugging Face演示和完整代码,适用于学术研究到工业应用的广泛场景,为OCR领域带来突破性解决方案。00openHiTLS
旨在打造算法先进、性能卓越、高效敏捷、安全可靠的密码套件,通过轻量级、可剪裁的软件技术架构满足各行业不同场景的多样化要求,让密码技术应用更简单,同时探索后量子等先进算法创新实践,构建密码前沿技术底座!C0305- WWan2.2-S2V-14B【Wan2.2 全新发布|更强画质,更快生成】新一代视频生成模型 Wan2.2,创新采用MoE架构,实现电影级美学与复杂运动控制,支持720P高清文本/图像生成视频,消费级显卡即可流畅运行,性能达业界领先水平Python00
- GGLM-4.5-AirGLM-4.5 系列模型是专为智能体设计的基础模型。GLM-4.5拥有 3550 亿总参数量,其中 320 亿活跃参数;GLM-4.5-Air采用更紧凑的设计,拥有 1060 亿总参数量,其中 120 亿活跃参数。GLM-4.5模型统一了推理、编码和智能体能力,以满足智能体应用的复杂需求Jinja00
Yi-Coder
Yi Coder 编程模型,小而强大的编程助手HTML013
热门内容推荐
最新内容推荐
项目优选









