jnpf-java-cloud

特别说明：源码、JDK、MySQL、Redis、Nacos、Seata、Sentinel等存放路径禁止包含中文、空格、特殊字符等

环境要求

特别说明：JDK 1.8.25 版本无法正常使用，请使用推荐版本

软件 | 推荐版本 | 说明 -----|-------- | ------------- JDK | 1.8.151 | JAVA环境依赖(需配置环境变量) Maven | 3.6.3 | 项目构建(需配置环境变量) Redis | 3.2.100(Windows)/6.0.x(Linux、Mac) | MySQL | 5.7.x |

工具推荐

特别说明：IDEA 2019.1和Maven 3.6.3存在兼容性问题

IDEA 不得低于 2020.1 版本

服务说明

服务名称 | 默认端口 | 描述 -----|-------- | ------------- nacos | 30099 | 服务注册、发现和配置中心 sentinel-server | 30098 | 流量控制、熔断降级、系统负载保护 seata-server | 30095 | 分布式事务 boot-admin | 30097 | 管理和监控SpringBoot应用 skywalking | 30096 | 链路追踪监控 jnpf-gateway | 30000 | 网关 jnpf-oauth | 30001 | 认证服务 jnpf-system | 30002 | 系统基础服务 jnpf-visualdev | 30003 | 可视化开发(在线开发、代码生成、大屏设计、门户设计) jnpf-workflow | 30004 | 工作流 jnpf-file | 30005 | 文件服务(上传、下载、预览等) jnpf-tenant | 30006 | 租户服务 jnpf-datareport | 30007 | 报表服务 jnpf-extend | 30019 | 扩展(系统内置示例) jnpf-third | 30020 | 第三方应用(如微信公众号、微信企业等） jnpf-example | 30100 | 子系统开发模板

使用说明

创建库并导入数据库脚本

在使用Navicat等工具时，``运行SQL脚本执行jnpf_init.sql可能会报错(初始数据含有JSON数据)，建议使用新建查询执行初始化脚本

• jnpf-databae/MySQL/jnpf_init.sql（项目主库）
• jnpf-databae/java微服务/jnpf_nacos.sql（项目配置库）

开发环境配置

Nacos配置

• 打开jnpf-registry/nacos/conf/application.properties
• 修改数据库配置(第39-41行)

Seata配置

• 打开jnpf-registry/seata/conf/file.conf，修改数据源配置(第27行开始)
• 打开数据库仓库的jnpf-databae/java微服务/jnpf_seata_config.sql修改seata配置SQL脚本，并在jnpf_nacos(项目配置库)中执行脚本

Sentinel配置

• 右击jnpf-registry/sentinel-server/pom.xml 选择Add as Maven Project
• 打开sentinel-server/src/main/resoures/application.properties,修改配置nacos服务地址(第29行)(nacos为本地地址时无需修改)

Skywalking配置

• 打开skywalking/config/application.yml ,修改下数据源配置(第164-166行)
• 创建skywalking初始表
  • 运行skywalking/bin/oapServiceInit.bat(windows环境)
  • 运行skywalking/bin/oapServiceInit.sh(Linux、Mac环境)
• IDEA启动项中的VM options中添加skywalking/agent/run skywalking-agent.txt中的-javaagent:、-Dskywalking.agent.service_name即可，每个启动类都需要添加

其他子系统配置

• 启动nacos,打开配置管理-配置列表- dev,修改datasource.yaml(Redis,数据库配置)和resources.yaml(静态资源配置)

JVM配置(根据实际情况调整)

启动项 | 参考配置| 描述 -----|--------|-------- JnpfExampleApplication | -Xmx100m -Xms100m -Xmn50m -Xss1024k | 子系统开发模板 JnpfExtendApplication | -Xmx200m -Xms200m -Xmn80m -Xss1024k | 扩展服务 JnpfFileAplication | -Xmx200m -Xms200m -Xmn100m -Xss1024k | 文件服务 JnpfGatewayApplication | -Xmx400m -Xms400m -Xmn150m -Xss1024k | 网关 JnpfOauthApplication | -Xmx500m -Xms500m -Xmn150m -Xss1024k | 授权中心 JnpfSystemApplication | -Xmx500m -Xms500m -Xmn180m -Xss1024k | 系统 JnpfThirdApplication | -Xmx200m -Xms200m -Xmn80m -Xss1024k | 第三方应用 JnpfVisualdevApplication | -Xmx800m -Xms800m -Xmn300m -Xss1024k | 可视化开发 JnpfWorkflowApplication | -Xmx800m -Xms800m -Xmn300m -Xss1024k | 工作流 JnpfDataReportApplication | -Xmx800m -Xms800m -Xmn300m -Xss1024k | 报表 JnpfTenantApplication | -Xmx200m -Xms200m -Xmn80m -Xss1024k | 多租户

####　开发环境配置

在Run/Debug Configurations界面按上述表格配置

测试生成环境配置

在启动命令加上配置-Xmx500m -Xms500m -Xmn180m -Xss1024k，如

nohup java -jar -Xmx500m -Xms500m -Xmn180m -Xss1024k jnpf-system-3.1.0-SNAPSHOT.jar > Log.log & 2>&1 &

项目启动

建议按照如下顺序进行启动，注意监控注册中心，确保每个服务都启动成功

nacos服务(优先启动等级1)

• 运行jnpf-registry/nacos/bin/startup.cmd(windows环境)
• 运行jnpf-registry/nacos/bin/startup.sh(Linux、Mac环境)
• 打开http://localhost:30099/nacos/index.html，默认账号密码为nacos

sentinel服务(优先启动等级2)

• 运行jnpf-registry/sentinel-server/src/main/java/com/alibaba/csp/sentinel/dashboard/DashboardApplication.java启动类

seata服务(优先启动等级2)

• 运行jnpf-registry/seata/bin/startup.bat(windows环境)
• 运行jnpf-registry/seata/bin/startup.sh(Linux、Mac环境)

skywalking服务(非必需)

• 运行skywalking/bin/startup.bat(windows环境)
• 运行skywalking/bin/startup.sh(Linux、Mac环境)

boot-admin管理和监控SpringBoot应用(非必需)

• 运行jnpf-registry/boot-admin/src/main/java/jnpf/JnpfAdminApplication.java启动类

其他服务(不分先后顺序)

• jnpf-gateway服务(网关)：运行/jnpf-gateway/src/main/java/jnpf/system/base/JnpfGatewayApplication.java启动类

• jnpf-oauth服务(授权中心)：运行jnpf-oauth/jnpf-oauth-server/src/main/java/jnpf/JnpfOauthApplication.java启动类

• jnpf-file服务(文件)：运行jnpf-file/jnpf-file-server/src/main/java/jnpf/JnpfFileAplication.java启动类

• jnpf-system服务(系统基础)：运行jnpf-system/jnpf-system-base/jnpf-system-base-server/src/main/java/jnpf/JnpfSystemApplication.java启动类

• jnpf-visualdev服务(可视化开发)：运行jnpf-visualdev/jnpf-visualdev-server/src/main/java/jnpf/JnpfVisualdevApplication.java启动类

• jnpf-workflow服务(工作流)： 运行jnpf-workflow/jnpf-workflow-server/src/main/java/jnpf/JnpfWorkflowApplication.java启动类

• jnpf-datareport服务(报表)： 运行jnpf-report/jnpf-datareport/report-console/src/main/java/com/bstek/ureport/console/JnpfDataReportApplication.java启动类

• jnpf-tenant服务(多租户)： 运行jnpf-tenant/jnpf-tenant-server/src/main/java/jnpf/JnpfTenantApplication启动类

• jnpf-extend服务(扩展)： 运行jnpf-extend/jnpf-extend-server/src/main/java/jnpf/JnpfExtendApplication.java启动类

• jnpf-third服务(第三方应用)： 运行jnpf-extend/jnpf-third-server/src/main/java/jnpf/JnpfThirdApplication.java启动类

服务组件

• Nacos

  • 版本：1.4.0
  • 控制台URL: http://localhost:30099/nacos/index.html
  • 用户密码：nacos/nacos

• Sentinel

  • 版本：1.8.0
  • 控制台URL: http://localhost:30098
  • 用户密码：sentinel/sentinel

• Spring Boot Admin(可选)

  • 版本：2.3.0
  • 控制台URL: http://localhost:30097
  • 用户密码：admin/admin

• Skywalking(可选)

  • 版本：8.3.0
  • 控制台URL: http://localhost:30096

全局接口

• 打开http://localhost:30000/swagger-ui.html