# cloud

**Repository Path**: ljt0515/cloud

## Basic Information

- **Project Name**: cloud
- **Description**: spring cloud 基本框架搭建 基于 Spring Cloud Finchley 、Spring Security OAuth2 的RBAC权限管理系统
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: http://www.ljthm.cn
- **GVP Project**: No

## Statistics

- **Stars**: 5
- **Forks**: 3
- **Created**: 2018-07-13
- **Last Updated**: 2026-03-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

 <p align="center">
  <img src="https://img.shields.io/badge/Avue-1.5.0-green.svg" alt="Build Status">
   <img src="https://img.shields.io/badge/Spring%20Cloud-Finchley.SR2-blue.svg" alt="Coverage Status">
   <img src="https://img.shields.io/badge/Spring%20Boot-2.0.8.RELEASE-blue.svg" alt="Downloads">
   <img src="https://img.shields.io/badge/nacos-1.1.0-blue.svg" alt="Downloads">

 </p>  

**Cloud Microservice Architecture**   

- 基于 Spring Cloud Finchley 、Spring Security OAuth2 的RBAC权限管理系统  
- 基于数据驱动视图的理念封装 Element-ui，即使没有 vue 的使用经验也能快速上手  
- 提供对常见容器化支持 Docker 支持  
- 提供 lambda 、stream api  的生产实践   

<a target="_blank" href="http://www.ljthm.cn"> 在线体验</a> | <a target="_blank" href="https://avue.top"> 前端解决方案</a> 
    
**现版本支持eureka注册中心config配置中心 和nacos注册配置中心**   

eureka版本[eureka](https://gitee.com/ljt0515/spring-cloud-demo/tree/eureka/)

nacos版本[nacos](https://gitee.com/ljt0515/spring-cloud-demo/tree/master/)

![](https://images.gitee.com/uploads/images/2019/0731/173117_6a426f08_140698.png)   

#### 核心依赖 

| 依赖                   | 版本          |
| ---------------------- | ------------- |
| Spring Boot            | 2.0.8.RELEASE |
| Spring Cloud           | Finchley.SR2  |
| Spring Security OAuth2 | 2.3.3         |
| Mybatis Plus           | 3.0.6         |
| hutool                 | 4.3.3         |
| Avue                   | 1.5.0         |



#### 模块说明

```lua
cloud
├── cloud-ui -- 前端工程[8080]
├── auth-server -- 授权服务[8764]
├── gateway-server -- 网关服务[8765]
├── upms-server -- 用户权限管理系统业务处理模块[8766]
├── message-service -- 消息服务[8767]
├── zipkin-server -- 链路调用监控[9411]
├── common -- 公共工具类核心包
├── common-security -- 安全工具类
├── upms-api -- 用户权限管理系统公共api模块
└── admin-monitor -- Spring Boot Admin监控 [5001]
	 
```

#### 快速开始
上手难度：★★★★

本项目基于springCloud打造的分布式快速开发框架. 需要了解SpringCloud,SpringBoot开发,分布式原理。

1. 准备环境
    + Java1.8  (v1.8.0_131+)
    + Nacos服务发现和注册中心(v1.1.0+) <a href="https://nacos.io/zh-cn/">阿里巴巴nacos.io</a>
    + Redis (v3.2.00+)
    + RabbitMq (v3.7+)
    + Mysql (v5.5.28+)
    + Maven (v3+)
    + Nodejs (v10.14.2+)
    
2. 执行创建数据库cloud并执行sql脚本
    + docs/cloud.sql
      ...
    
3.  启动nacos服务发现&配置中心,新建公共配置文件 
    + 访问 http://localhost:8848/nacos/index.html 
    + 添加配置 ```
        + doc/config/admin-monitor-dev.yml
        + doc/config/application-dev.yml
        + doc/config/auth-server-dev.yml
        + doc/config/gateway-server-dev.yml
        + doc/config/upms-server-dev.yml
        + doc/config/zipkin-server-dev.yml

     如图:
     ![nacos](docs/nacos.png "nacos.png")
4.  启动sentinel-dashboard
4. 修改主pom.xml  

    初始化maven项目
    ``` bush
        maven clean package -DskipTests
    ```
    本地启动,默认不用修改
    ``` xml
        <!--Nacos配置中心地址-->
        <config.server-addr>127.0.0.1:8848</config.server-addr>
        <!--Nacos配置中心命名空间,用于支持多环境.这里必须使用ID，不能使用名称,默认为空-->
        <config.namespace></config.namespace>
        <!--Nacos服务发现地址-->
        <discovery.server-addr>127.0.0.1:8848</discovery.server-addr>
        <!--Sentinel服务发现地址-->
        <sentinel.server-addr>127.0.0.1:8848</sentinel.server-addr>
    ```
    
5. 本地启动(按顺序启动)
     1. [必需]UpmsServerApplication(用户权限系统)
     2. [必需]AuthServerApplication(用户认证系统)
     3. [必需]ApiGatewaySpringApplication(网关服务)
     ```
        访问 http://localhost:8765
     ```
     4.[非必需]SpringBootAdmin(监控服务器)(非必需)
      ```
          访问 http://localhost:5001
      ```
     5.[非必需]ZipkinServerApplication(链路详情)(非必需)
       ```
           访问 http://localhost:9411
       ``` 
6. 前端启动
    ```bush
        npm install 
        npm run dev
    ``` 
    访问 http://localhost:8080
    
7. 项目打包部署  
     maven多环境打包,并替换相关变量
   ```bush
     mvn clean install package -P {dev|test|online}
   ```
    项目启动
    ```bush
    ./docs/startup.sh {start|stop|restart|status} gateway-server.jar
    ./docs/startup.sh {start|stop|restart|status} upms-server.jar
    ./docs/startup.sh {start|stop|restart|status} auth-server.jar
    ```
#### 提交反馈

1. 欢迎提交 issue，请写清楚遇到问题的原因，开发环境，复显步骤。
2. 不接受`功能请求`的 issue，功能请求可能会被直接关闭。  
3. <a href="mailto:ljt_0515@163.com">ljt_0515@163.com</a>  
4. <a target="_blank" href="https://jq.qq.com/?_wv=1027&k=5q5BKL8">交流群 659692945</a>   

#### 鸣谢 

avue [@smallwei](https://avue.top)    
mica-auto [@dreamlu](https://dreamlu.net)   
bladex [@smallc](http://bladex.vip)  
mybatis-plus [@青苗](http://mp.baomidou.com)     
hutool [@路小磊](https://dreamlu.net)