# spring-cloud-base **Repository Path**: string18/spring-cloud-base ## Basic Information - **Project Name**: spring-cloud-base - **Description**: spring-cloud、spring-security - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2019-12-11 - **Last Updated**: 2020-12-19 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # spring-cloud-base 微服务基础框架，基于 SpringCloud 及 SpringBoot 开发。 使用 Oauth2 统一授权、认证, Oauth示例客户端使用 Vue 开发，具有用户管理、 资源管理、 角色管理等模块，后端包括授权中心、 基础数据中心（资源服务器）等应用，可作为微服务快速开发脚手架。 可通过 docker 快速构建部署。 Demo website：http://www.mxclass.cn username: test password: 123456 phone: 13100000000 verifyCode: 1000 ## Model 图片待续 * [api-gateway](https://github.com/fp2952/spring-cloud-base/tree/master/api-gateway)：api-gateway网关 * [auth-center](https://github.com/fp2952/spring-cloud-base/tree/master/auth-center)：OAuth2授权中心 * [common](https://github.com/fp2952/spring-cloud-base/tree/master/common)：通用脚手架 * [config-git](https://github.com/fp2952/spring-cloud-base/tree/master/config-git)：git配置中心 * [db-mybatis-pagehelper](https://github.com/fp2952/spring-cloud-base/tree/master/db-mybatis-pagehelper)：Mybatis通用Mapper、分页模块 * [docker-compose](https://github.com/fp2952/spring-cloud-base/tree/master/docker-compose)：docker-compose编排 * [main-data](https://github.com/fp2952/spring-cloud-base/tree/master/main-data)：基础数据模块 * [mc-service](https://github.com/fp2952/spring-cloud-base/tree/master/mc-service)：消息组件 * [visul/monitor](https://github.com/fp2952/spring-cloud-base/tree/master/visul/monitor/)：admin监控服务 * [visul/zipkin-db](https://github.com/fp2952/spring-cloud-base/tree/master/visul/zipkin-db)：zipkin链路追踪服务 * [web-app](https://github.com/fp2952/spring-cloud-base/tree/master/web-app)：前端vue项目 ### 项目结构 ``` ├─spring-cloud-base │ │ │ ├─api-gateway--------------网关负载中心 │ │ │ ├─auth-center-----------------OAuth2服务授权中心 │ │ ├─auth-center-api----------------授权中心公共模块 │ │ ├─auth-center-provider----------------授权中心服务端 │ │ ├─auth-spring-boot-autoconfigure----------------授权中心autoconfigure │ │ └─auth-spring-boot-starter----------------授权中心starter模块 │ │ │ ├─common----------------通用脚手架 │ │ │ ├─config-git-----------------配置中心 │ │ │ ├─db-mybatis-pagehelper---------------Mybatis通用Mapper、分页模块 │ │ ├─db-spring-boot-autoconfigure----------------autoconfigure │ │ ├─db-spring-boot-samples----------------db模块使用示例 │ │ └─db-spring-boot-starter----------------db starter │ │ │ ├─docker-compose---------------docker-compose编排 │ │ │ ├─main-data--------------基础数据模块 │ │ ├─main-data-api----------------基础数据公共模块 │ │ ├─main-data-client----------------基础数据模块客户端 │ │ └─main-data-provider----------------基础数据模块服务端 │ │ │ ├─visul---------------监控 │ │ ├─monitor----------------admin监控 │ │ └─zipkin-db----------------zipkin链路追踪 │ ├─mc-service---------------消息服务 │ │ │ └─web-app--------------vue前端应用 │ ``` ## 相关博文 * consul 注册中心 * [Spring Cloud OAuth2（一） 搭建授权服务](https://fp2952.github.io/jekyll/update/2016/05/13/Spring-cloud-oauth2.html) * [Spring Cloud OAuth2（二） 扩展登陆方式：账户密码登陆、 手机验证码登陆、 二维码扫码登陆](https://fp2952.github.io/jekyll/update/2018/06/13/Spring-cloud-oauth2-login.html) * api-gateway 网关 * main-data 基础数据模块 * common * db-spring-boot-starter * auth-spring-boot-starter ## Quick Start ### 依赖环境 JDK8、 Maven、 Mysql、 Redis、Consul、 Rabbitmq、Nodejs、 Docker(可选)、 docker-compose(可选) ### 运行步骤 1. git clone https://github.com/fp2952/spring-cloud-base.git 1. Mysql导入数据： 运行main-data/schema.sql 文件； 2. 更改配置文件，此项目默认本地配置，更改 config-git/src/main/resource/config 下的配置文件，主要需修改数据库链接、 Redis链接、 Rabbitmq链接等； 3. 启动 Consul (下载地址： https://www.consul.io/downloads.html)， window下载解压完为exe可执行文件, 进入其文件夹下 cmd -> consul agent -dev 启动，此时可访问 http://localhost:8500 查看Consul Ui页面； 4. 启动redis、 Rabbitmq； 5. 依此启动 config-git/ConfigServerApplication.main(配置中心)、auth-center/auth-center-provider/AuthCenterProviderApplication.main(服务授权中心)、 api-gateway/ApiGatewayApplication.main()(网关负载中心)、 main-data/main-data-provider/MainDataApplication.main()(基础数据模块)，注意启动顺序，配置中心必须最先启动，网关和基础数据模块依赖授权模块的 jwt/key-uri point；启动后可在Consul图形界面上即可看到已注册的服务; 6. 前端Vue项目需node环境（https://nodejs.org/en/download/), cd web-app、安装依赖 npm install、 启动项目 npm dev run , 需更改后端接口地址， /static/config.js/window.serverconf/development ### 通过 docker-compose 快速启动 1. 需要 docker-compose 环境，windows 可安装 DockerToolbox。 需先通过 Maven 插件 docker-maven-plugin 打包镜像， ``` org.springframework.boot spring-boot-maven-plugin com.spotify docker-maven-plugin ${docker.plugin.version} ${project.artifactId} src/main/docker / ${project.build.directory} ${project.build.finalName}.jar ``` 2. 分别构建 auth-center-provider、 main-data-provider、 api-gateway： ``` mvn clean mvn package docker:build ``` 构建 node-app: ``` cd /spring-cloud-base/web-app docker build -t node-app . ``` 3. 更改配置 docker-compose.yml： ``` node-app: image: node-app ports: - '8080:8080' depends_on: - 'auth-center' - 'api-gateway' # 基础路径，授权时的redirectUrl，为 宿主机IP:本容器映射端口 - BASE_URL=http://192.168.99.100:8080 # 后台接口，对于网关 - SERVER_URL=http://192.168.99.100:18000 # 授权中心 - AUTH_URL=http://192.168.99.100:18001/auth ``` 4. 运行 ``` cd /spring-cloud-base/docker-compose docker-compose up [-d] ``` ### 通过共享镜像启动 ## Preview * 登陆页： ![avatar](http://112.74.60.248:8080/image/login.png) * 用户管理： ![avatar](http://112.74.60.248:8080/image/user.png) * 角色管理： ![avatar](http://112.74.60.248:8080/image/role.png) * 应用管理： ![avatar](http://112.74.60.248:8080/image/client.png) * 系统管理： ![avatar](http://112.74.60.248:8080/image/system.png) * 模块管理： ![avatar](http://112.74.60.248:8080/image/module.png) ## 更新日志 * 2018-06 spring security登陆验证扩展 手机验证码，二维码扫码登陆、 引入i18n国际化、 集成git配置中心、admin监控、 链路追踪、Springcloud 升级为Edgware，Consul升级为最新1.2 * 2018-05 完成基础数据模块开发、 docker容器编排 * 2018-05 授权中心整和Jwt、 SpringSecurity，使用 OAuth2 授权 * 2018-03 init， 完成公共模块设计、 SpringBoot starter开发