# Spring-Cloud-Demo

**Repository Path**: openjc/spring-cloud-demo

## Basic Information

- **Project Name**: Spring-Cloud-Demo
- **Description**: Spring-Cloud 最佳实践整合测试
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-12-03
- **Last Updated**: 2025-12-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Spring-Cloud-Demo

#### 介绍
这是一个用于整合和测试 Spring-Cloud 最佳实践的项目。它旨在为开发者提供一个完整的 Spring-Cloud 示例，包括常见的微服务组件和集成方案，方便学习和参考。

#### 软件架构
本项目基于 Spring-Cloud 构建，主要使用了以下技术栈：
- Spring Boot 2.x
- Spring Cloud Gateway
- Spring Cloud Alibaba Nacos
- Spring Cloud Sleuth + Zipkin 实现分布式链路追踪
- Feign 与 OpenFeign
- Spring Cloud LoadBalancer
- Spring Cloud Config
- Spring Cloud Stream RocketMQ/Kafka
- Spring Cloud Bus
- OAuth2 + JWT 认证授权机制
- 熔断器 Hystrix（可选）

项目分为多个模块，每个模块代表一个独立的微服务组件，便于单独运行和测试。

#### 安装教程
1. 下载项目：`git clone https://gitee.com/openjc/spring-cloud-demo`
2. 安装依赖：确保已安装 Maven 3.x 和 JDK 1.8 或以上版本，运行 `mvn install` 安装依赖
3. 启动 Nacos 服务（本地或远程），或使用 Docker 命令启动：
   ```bash
   docker run -d -p 8848:8848 -p 9555:9555 -e MODE=standalone nacos/nacos-server
   ```
4. 启动其他中间件（如 RocketMQ、Zipkin、Kafka）根据需要进行配置
5. 分别运行各个微服务模块，建议使用 IDE（如 IntelliJ IDEA 或 Eclipse）导入项目并运行

#### 使用说明
1. 启动所有服务后，访问 `http://localhost:8080`（默认网关地址）查看路由配置
2. 通过 RESTful API 调用各个服务接口，示例：
   - 用户服务：`GET /api/user/{id}`
   - 订单服务：`GET /api/order/{id}`
   - 网关服务：`GET /actuator/gateway/routes` 查看当前路由信息
3. 使用 Zipkin 查看链路追踪信息：`http://localhost:9411`
4. 使用 Nacos 管理配置信息和注册中心：`http://localhost:8848/nacos`

#### 参与贡献
1. Fork 本仓库
2. 创建新的分支（如 `feat/your-feature-name`）
3. 提交代码并确保测试通过
4. 提交 Pull Request 并描述修改内容
5. 等待审核和合并

#### 特技
1. 支持多语言文档，如 `README_en.md` 和 `README_zh.md`
2. 集成 Gitee Pages，可生成项目文档站点
3. 支持一键部署脚本（部署脚本见 `scripts/` 目录）
4. 提供 Dockerfile 支持容器化部署
5. 支持本地调试 + 云部署的无缝切换
6. 集成 Gitee Actions 实现 CI/CD 流程自动化

#### 许可证
本项目遵循 Apache-2.0 License，详情请参见 LICENSE 文件。