目录
- 示例项目详情
- 模块构建
- 部署 Mysql
- 部署 Redis
- 部署 pig-ui
- 依赖与端口梳理
- 最终成果
示例项目详情
本文档以Pig 快速开发框架为例,演示如何在Rainbond上部署一套完整的Spring Cloud项目。
Pig Microservice Architecture V2.1.0:
基于 Spring Cloud Finchley 、Spring Security OAuth2 的RBAC权限管理系统
基于数据驱动视图的理念封装 Element-ui,即使没有 vue 的使用经验也能快速上手
提供对常见容器化支持 Docker、Kubernetes、Rancher2 支持
提供 lambda 、stream api 、webflux 的生产实践
模块说明:
pig
├── pig-ui -- 前端工程[80]
├── pig-auth -- 授权服务提供[3000]
└── pig-common -- 系统公共模块
├── pig-common-core -- 公共工具类核心包
├── pig-common-log -- 日志服务
└── pig-common-security -- 安全工具类
├── pig-config -- 配置中心[8888]
├── pig-eureka -- 服务注册与发现[8761]
├── pig-gateway -- Spring Cloud Gateway网关[9999]
└── pig-upms -- 通用用户权限管理模块
└── pigx-upms-api -- 通用用户权限管理系统公共api模块
└── pigx-upms-biz -- 通用用户权限管理系统业务处理模块[4000]
└── pigx-visual -- 图形化模块
├── pigx-monitor -- Spring Boot Admin监控 [5001]
└── pigx-codegen -- 图形化代码生成[5003]
└── pigx-zipkin -- 微服务链路跟踪[5002]
上述的模块,可以分为类库与服务两类,读者可以对比自己的Spring Cloud项目:
构建后产生jar包,用来实现各种功能的类的集合,即是类库,如Pig中的pig-common模块
构建后产生jar包或者war包,通过 java -jar 或者tomcat等方式启动,开放某个端口提供服务的,即是服务,如Pig中的pig-eureka模块
只需要将服务模块在Rainbond中构建出来即可。
经过梳理,该项目需要构建的服务组件包括:
启动顺序 |
服务组件名称 |
运行端口 |
组件功能 |
1 |
pig-eureka |
8761 |
spring cloud 服务发现注册与发现 |
2 |
pig-config |
8888 |
spring cloud 配置中心 |
3 |
pig-gateway |
9999 |
spring cloud 微服务网关 |
4 |
pig-auth |
3000 |
授权服务提供 |
5 |
pig-upms-biz |
4000 |
通用用户权限管理系统业务处理模块 |
6 |
pig-monitor |
5001 |
Spring Boot Admin监控 |
7 |
pig-codegen |
5003 |
图形化代码生成 |
8 |
pig-zipkin |
5002 |
微服务链路跟踪 |
9 |
pig-ui |
80 |
前端项目(vue项目) |
部署环境说明:
部署pig,需要以下环境支持:
中间件或环境要求 |
版本要求 |
备注 |
JDK |
1.8 |
强制要求版本 |
MySQL |
5.7+ |
强制要求版本 |
Redis |
3.2 + |
强制要求版本 |
node |
8.0 + |
用于运行前端项目 |
npm |
6.0 + |
用于构建前端项目 |
模块构建
新建应用,并命名为 spring-cloud
获取项目克隆/下载地址: https://gitee.com/log4j/pig
以pig-eureka为例,演示从源码开始构建流程:
为 spring-cloud 添加服务组件 —— 从源码开始 —— 自定义仓库:

点击 新建服务,Rainbond会自动拉取代码,并根据代码根目录下的 pom.xml 自动将代码语言识别为 Java-maven。取消 并构建启动 选项:

点击 创建,进入服务组件未部署的页面。编辑 端口 选项卡,开放 pig-eureka 自身端口 8761:
pig-eureka 需要被其它微服务组件访问以进行注册,所以打开对内服务,以便之后创建依赖关系。该组件也提供web页面,显示微服务组件的注册情况与健康情况,所以打开对外服务,以便外部访问。

编辑 构建源 选项卡,指定 pig-eureka 构建参数:
由于 Pig 本身是一个多模块的项目,所以需要指定当前服务组件构建的模块。指定的方式是在 构建运行环境设置 中的 Maven构建全局参数:
clean dependency:list install -pl pig-eureka -am
上述的参数指定了普通的子模块构建方式,对于另一种子模块中的子模块,比如 pig-codegen 模块,参数指定的方式为:
clean dependency:list install -pl pig-visual/pig-codegen -am
在v5.1+版本的Rainbond中,可以指定当前服务组件的启动命令。指定的方式是在 构建运行环境设置 中的 启动命令:
web: java $JAVA_OPTS -Djava.security.egd=file:/dev/./urandom -jar /app/pig-eureka/target/*.jar
命令格式与 Procfile 一致。

编辑 依赖 选项卡,指定当前服务组件依赖其它服务组件:
各个服务组件之间的依赖关系,可以在创建时指定。所有的 spring cloud 微服务组件都需要依赖 pig-eureka,以 pig-gateway为例,应添加依赖关系如下:

所有的设置完成后,即可点击 构建 ,构建完成后,服务组件将自动运行起来。
将所有服务组件依次部署完成。
部署 Mysql
Pig 微服务项目需要部署 Mysql 5.7+ 作为数据源。并在代码仓库中提供了数据库初始化脚本:
https://gitee.com/log4j/pig/blob/master/db/pig.sql
为了能够在数据库启动时即加载初始化脚本,制作了一份 Dockerfile:
FROM percona:5.7.23-stretch
LABEL creater="barnett"
ENV MYSQL_VERSION=5.7.23
ENV TZ=Asia/Shanghai
ADD docker-entrypoint.sh /run/docker-entrypoint.sh
ADD ./run/docker-entrypoint.sh /usr/local/bin/docker-entrypoint.sh
ADD ./run/mysqld.cnf /etc/mysql/percona-server.conf.d/mysqld.cnf
RUN fetchDeps=' \
ca-certificates \
wget \
'; \
sed -i 's/deb.debian.org/mirrors.ustc.edu.cn/g' /etc/apt/sources.list; \
apt-get update; \
apt-get install -y --no-install-recommends $fetchDeps; \
rm -rf /var/lib/apt/lists/*; \
wget -O /usr/local/bin/env2file -q https://github.com/barnettZQG/env2file/releases/download/v0.1/env2file-linux; \
chmod +x /run/docker-entrypoint.sh && chmod +x /usr/local/bin/env2file; \
apt-get purge -y --auto-remove $fetchDeps
EXPOSE 3306
VOLUME ["/var/lib/mysql", "/var/log/mysql"]
# 将代码仓库中 sql 目录下的脚本放到对应的初始化目录下
COPY sql/*.sql /docker-entrypoint-initdb.d/
# change ENTRYPOINT exec some custom command
ENTRYPOINT [ "/run/docker-entrypoint.sh" ]
CMD [ "mysqld" ]
为 spring-cloud 添加服务组件 —— 从源码开始 —— 自定义仓库:
将服务组件命名为 pig-db,并指定代码分支 pig。
在代码仓库地址url的最后添加 ?dir=5.7 可以让Rainbond将构建目录指定为代码仓库根目录下的 5.7 文件夹。

为了让数据库正常工作,并且可以被其它依赖的本数据库的应用获取连接信息,需要设置若干环境变量:
环境变量名称 |
环境变量值 |
设置位置 |
MYSQL_USER |
root |
连接信息 |
MYSQL_HOST |
127.0.0.1 |
连接信息 |
MYSQL_PORT |
3306 |
连接信息 |
MYSQL_ROOT_PASSWORD |
mysqlpassword |
连接信息 |
MYSQL_DATABASE |
pig |
连接信息 |
通过修改 pig-config 中的配置文件,来定义多个微服务组件连接数据库的配置:
pig/pig-config/src/main/resources/config/pigx-auth-dev.yml
pig/pig-config/src/main/resources/config/pigx-upms-dev.yml
pig/pig-config/src/main/resources/config/pigx-codegen-dev.yml
pig/pig-config/src/main/resources/config/pigx-zipkin-dev.yml.yml
修改示例如下:
# 数据源
spring:
datasource:
type: com.zaxxer.hikari.HikariDataSource
driver-class-name: com.mysql.jdbc.Driver
username: ${MYSQL_USER}
password: ${MYSQL_ROOT_PASSWORD}
url: jdbc:mysql://${MYSQL_HOST}:${MYSQL_PORT}/${MYSQL_DATABASE}?characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=false&useJDBCCompliantTimezoneShift=true&useLegacyDatetimeCode=false&serverTimezone=Asia/Shanghai
部署 Redis
通过Rainbond应用市场,可以直接安装 Redis 4.0.13。
该版本Redis默认提供连接信息:

通过修改 pig-config 中的 pig/pig-config/src/main/resources/config/application-dev.yml 来定义所有服务组件连接Redis的配置:
修改示例如下:
# Spring 相关
spring:
redis:
password: ${REDIS_PASS}
host: ${REDIS_HOST}
部署 pig-ui
pig-ui 是一个由nodejs语言编写的 vue项目,作为整个系统的前端静态页面。Rainbond目前已经支持源码构建 nodejs前端 项目,参考文档:NodeJS前端语言
为了便于改造项目,所以将项目 fork 了一份进行修改,代码地址:
https://gitee.com/dazuimao1990/pig-ui
参照Rainbond代码支持规范,在代码根目录下添加了识别文件: nodestatic.json
并在代码仓库中添加了nginx配置文件: www/web.conf 用于处理代理转发:
server {
listen 80;
root /app/www;
location ~* ^/(code|auth|admin|gen) {
proxy_pass http://127.0.0.1:9999;
proxy_connect_timeout 15s;
proxy_send_timeout 15s;
proxy_read_timeout 15s;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
}
利用这份代码进行源码构建,即可完成 pig-ui 服务组件的部署。
依赖与端口梳理
服务组件名称 |
依赖 |
端口对内服务 |
端口对外服务 |
pig-ui |
pig-gateway |
off |
on |
pig-gateway |
pig-eureka Redis |
on |
off |
pig-monitor |
pig-eureka Redis |
off |
off |
pig-config |
pig-eureka |
off |
off |
pig-upms-biz |
pig-eureka pig-db Redis |
off |
off |
pig-zipkin |
pig-eureka pig-db Redis |
off |
on |
pig-auth |
pig-eureka Redis |
off |
off |
pig-codegen |
pig-eureka pig-db Redis |
off |
off |
最终成果
完成部署后,拓扑图如下:

登陆效果:

登陆账户密码:
admin
123456