微服务文档
微服务架构相关的技术文档和示例。本文档集合涵盖了 gRPC、服务发现、异步任务处理等微服务核心技术栈的构建指南。
📚 文档列表
gRPC 服务
- Python gRPC 微服务构建指南 - 使用 Python 构建 gRPC 微服务的完整指南,包含服务器和客户端实现
- Python Flask gRPC Gateway 服务构建指南 - 使用 Flask 构建 gRPC Gateway,将 HTTP RESTful API 转换为 gRPC 调用
服务发现
- Etcd 服务发现与 Registrator 配置指南 - 使用 etcd 和 Registrator 构建基于 Docker 的自动服务发现系统(包含现代化替代方案建议)
异步任务处理
- Python Celery 微服务异步任务处理指南 - 使用 Celery 构建异步任务处理微服务,支持定时任务和任务队列
🚀 快速开始
如果你刚接触微服务架构,建议按以下顺序阅读:
- 首先阅读 Python gRPC 微服务构建指南 了解 gRPC 基础
- 然后学习 Python Flask gRPC Gateway 服务构建指南 了解 API Gateway 模式
- 如果需要异步任务处理,参考 Python Celery 微服务异步任务处理指南
- 最后了解服务发现机制,阅读 Etcd 服务发现与 Registrator 配置指南
📝 注意事项
- 所有文档已更新至 2025 年最新版本
- Python 版本要求:Python 3.9+(推荐 Python 3.11+)
- 所有依赖包版本已更新至最新稳定版
- 包含生产环境部署建议和安全配置
- 提供详细的代码示例和测试方法
🔄 技术栈更新说明
已更新的技术栈
- Python: 3.6.7 → 3.9+(推荐 3.11+)
- Django: 1.11.20 → 4.2.7
- Celery: 4.2.1 → 5.3.4
- gRPC: 1.19.0 → 1.60.0
- etcd: v3.3 → v3.5.9
- Flask: 1.0.2 → 3.0.0
- Redis: 3.2.0 → 5.0.1
重要变更
- django-celery 已废弃,改用 django-celery-beat 和 django-celery-results
- Registrator 项目已不再积极维护,文档中提供了现代化替代方案建议
- 所有配置已更新为使用环境变量和最佳实践