# open-cloud **Repository Path**: hackor/open-cloud ## Basic Information - **Project Name**: open-cloud - **Description**: 基于springcloud、oauth2、nacos打造的微服务开放平台. 利于企业分布式开发,集中管理微服务接口,SpringSecurity深度拓展,为微服务接口资源保驾护航。 - **Primary Language**: Java - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 778 - **Created**: 2019-09-28 - **Last Updated**: 2020-12-19 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README

## 微服务开放平台 3.0.0 #### 开源不易，请随手给个Star! 感谢支持！ #### 上手难度：★★★★ #### 简介搭建基于OAuth2的开放平台、为APP端、应用服务提供统一接口管控平台、为第三方合作伙伴的业务对接提供授信可控的技术对接平台 + Nacos(服务注册+配置中心)、Fegin(RPC服务调用) + 统一API网关（参数验签、身份认证、接口鉴权、接口调试） + 微服务间身份传递.使用Oauth2协议,统一认证管理! 开发平台门户预览运营管理后台预览 + 后台默认账号:admin 123456 + 后台测试账号:test 123456 + SpringBootAdmin账号:sba 123456 #### 交流群学习交流(千人群):760809808

#### 功能介绍 ![功能介绍](/docs/功能介绍.png) #### 使用手册使用手册 #### 服务端源码码云 github #### vue后台UI源码后台UI源码 #### vue门户UI源码门户UI源码 #### 代码结构 ``` lua open-cloud ├── docs -- 文档及脚本 ├── bin -- 执行脚本 ├── config -- 公共配置,用于导入到nacos配置中心 ├── sql -- sql文件 ├── data -- 增量数据 ├── components -- 公共组件 ├── open-cloud-common-core -- 提供微服务相关依赖包、工具类、全局异常解析等 ├── open-cloud-common-starter -- SpringBoot自动配置扫描 ├── open-cloud-tenant-starter -- 多租户模块,多数据源自动切换(完善中...) ├── open-cloud-java-sdk -- 开放平台api集成SDK(完善中...) ├── platform -- 平台服务 ├── open-cloud-api-spring-server -- API开放网关-基于SpringCloudGateway[port = 8888](推荐） ├── open-cloud-api-zuul-server -- API开放网关-基于Zuul[port = 8888](功能完善） ├── open-cloud-base-client -- 平台基础服务接口 ├── open-cloud-base-server -- 平台基础服务器[port=8233] ├── open-cloud-uaa-admin-server -- 平台用户认证服务器[port = 8211] ├── open-cloud-uaa-portal-server -- 门户开发者认证服务器[port = 7211] ├── open-cloud-generator-server -- 在线代码生成服务器[port = 5555] ├── services -- 通用微服务 ├── open-cloud-msg-client -- 消息服务接口 ├── open-cloud-msg-server -- 消息服务器[port = 8266] ├── open-cloud-task-client -- 任务调度接口 ├── open-cloud-task-server -- 调度服务器[port = 8501] ├── open-cloud-bpm-client -- 工作流接口 ├── open-cloud-bpm-server -- 工作流服务器[port = 8255] ├── open-cloud-sba-server -- SpringBootAdmin监控服务[port = 8849] ├── open-cloud-sso-ui-demo -- SSO单点登录演示demo[port = 8849] ``` #### 快速开始本项目基于springCloud打造的分布式快速开发框架. 需要了解SpringCloud,SpringBoot,SpringSecurity,分布式原理。 1. 准备环境 + Java1.8 (v1.8.0_131+) + Nacos服务注册和配置中心(v1.0.0+) 阿里巴巴nacos.io + Redis (v3.2.00+) + RabbitMq (v3.7+)（需安装rabbitmq_delayed_message_exchange插件下载地址） + Mysql (v5.5.28+) + Maven (v3+) + Nodejs (v10.14.2+) 2. 执行创建数据库open-platform并执行sql脚本 + docs/sql/oauth2.sql + docs/sql/base.sql + docs/sql/gateway.sql + docs/sql/msg.sql + docs/sql/quartz.sql && task.sql ... 3. 启动nacos服务发现&配置中心,新建公共配置文件 + 访问 http://localhost:8848/nacos/index.html + 导入配置 /docs/config/DEFAULT_GROUP.zip（nacos1.0.3以上版本支持一键导入） + 新建配置文件（nacos1.0.3以下版本） + 项目目录/docs/config/db.properties > db.properties + 项目目录/docs/config/rabbitmq.properties > rabbitmq.properties + 项目目录/docs/config/redis.properties > redis.properties + 项目目录/docs/config/common.properties > common.properties 如图: ![nacos](https://gitee.com/uploads/images/2019/0425/231436_fce24434_791541.png "nacos.png") 4. 修改主pom.xml 初始化maven项目 ``` bush maven clean install ``` 本地启动,默认不用修改 ``` xml

127.0.0.1:8848

127.0.0.1:8848 ``` 5. 本地启动(按顺序启动) 1. [必需]BaseApplication(平台基础服务) 2. [必需]UaaAdminApplication(平台用户认证服务器) 3. [必需]GatewaySpringApplication(推荐)或GatewayZuulApplication ``` 访问 http://localhost:8888 ``` 4.[非必需]SpringBootAdmin(监控服务器)(非必需) ``` 访问 http://localhost:8849 ``` 6. 前端启动 ```bush npm install npm run dev ``` 访问 http://localhost:8080 7. 项目打包部署 + maven多环境打包,替换变量 ```bush mvn clean install package -P {dev|test|online} ``` + 项目启动 ```bush ./docs/bin/startup.sh {start|stop|restart|status} open-cloud-base-server.jar ./docs/bin/startup.sh {start|stop|restart|status} open-cloud-uaa-admin-server.jar ./docs/bin/startup.sh {start|stop|restart|status} open-cloud-api-spring-server.jar ``` 8.docker部署 + 配置DOCKER_HOST环境变量, 私服仓库地址 ```bush DOCKER_HOST = tcp://{registry_host}:2375 ``` + maven多环境打包,替换变量.并构建docker镜像 ```bush clean install package -P {dev|test|online} dockerfile:build ``` + 启动docker镜像 ```bush docker run -d -e JAVA_OPTS="-Xms128m -Xmx256m" -p 8233:8233 --name open-cloud-base-server 172.17.207.82:5000/platform/open-cloud-base-server:3.0.0 docker run -d -e JAVA_OPTS="-Xms128m -Xmx256m" -p 8211:8211 --name open-cloud-uaa-admin-server 172.17.207.82:5000/platform/open-cloud-uaa-admin-server:3.0.0 docker run -d -e JAVA_OPTS="-Xms128m -Xmx256m" -p 8888:8888 --name open-cloud-api-spring-server 172.17.207.82:5000/platform/open-cloud-api-spring-server:3.0.0 ``` #### 集成开发集成开发 #### OAuth2使用说明 OAuth2 #### 更新日志 v-3.0.0 2019-08-24 1. 升级springboot版本 2.1.4 > 2.1.6 2. 升级springcloud版本 Greenwich.SR1 > Greenwich.SR2 3. 升级swagger-bootstrap-ui 1.9.3 > 1.9.5 4. 修复网关签名参数获取bug v-3.0.0 2019-07-29 1. 修复springgateway已知bug 2. docs/sql/data/20190729.sql 增加字段修改语句 v-3.0.0 2019-07-19 1. 增加open-cloud-generator-server 在线代码生成器 2. docs/sql/data/日期.sql 增量数据 v-3.0.0 2019-07-11 （重大更新） 1. 新增开发者管理 2. 调整项目结构 3. 优化ui交互方式 4. 调整部分代码 5. 升级方式 + 升级前注意对老数据进行备份 + 重新导入common.propertis到配置中心 + 重新执行 2019-07-19.sql oauth2.sql gateway.sql msg.sql 并手动删除无效表名 v-2.1.0 2019-06-10 1. base_api表新增字段is_open是否公开访问: 0-内部的 1-公开的 2. 更新base_api数据 v-2.1.0 2019-05-26 （重大变更） 1. 重新梳理base表结构和权限相关接口,解决用户和客户端动态分配权。机制问题暂不支持用户动态分配角色,需重新登录获取最新角色 2. 优化页面功能 3. 升级nacos客户端版本.支持1.0.0以上版本 5. 完善权限数据,去除外键约束. 6. 升级方式更新ui和服务代码, 重新执行base.sql。手动删除无效表 7. 移除app-admin模块相关功能迁移到opencloud-auth-provider中 v-2.0.0 2019-05-01 1. 升级SpringCloud Greenwich.SR1,SpringBoot 2.1.4.RELEASE 2. 重构项目结构 3. 优化Zuul网关性能 4. 增加官方SpringCloudGateway 5. 迁移Gateway功能到base服务中 6. 增加MybatisPlus 7. 使用.yml代替.properties v-1.0.0 2019-03-18 1. 重构项目结构 2. 重构表结构 3. 重构授权逻辑 4. 提取公共配置,并迁移到Nacos配置中心 5. 优化功能