硕果云项目本地部署教程

刺骨的言语ヽ痛彻心扉 2022-12-05 05:14 339阅读 0赞

### 文章目录 ###

*  1：环境准备
 *  2: 下载项目
 *  3: 修改配置
 *  4: 启动后端项目
 *  5: 启动前端项目
 *  6: 监控
 *  7: 其他
 *  8: 项目地址
 *  9: 本机环境

# 1：环境准备 #

开发环境：

*  jdk:1.8
 *  MySQL:5.7+
 *  redis
 *  rabbitMq
 *  node.js
 *  consul  
    开发工具：`IntelliJ IDEA`,需要安装的插件`lombok`

# 2: 下载项目 #

.`git clone` 下载 [spring-microservice-exam][]  
.`git clone https://gitee.com/wells2333/spring-microservice-exam.git`

# 3: 修改配置 #

1.  按需修改spring-microservice的config-servicce的/config文件夹下各服务的配置
2.  例如：ip、端口、数据库名称等，所有配置均有默认，比如数据库的ip为 `localhost:3306`,账号为`root/11`
3.  redis：`localhost:6379`
4.  rabbitMq:`localhost:5672`  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM4MjE1MDQy_size_16_color_FFFFFF_t_70_pic_center]
5.  运行数据库初始化脚本：  
    首先新建四个数据库，分别是：microservice-user、microservice、microservice-auth、microservice-gateway,分别执行下面的SQL脚本：  
    特别说明：下方数据库名需要使用tab建上面的撇号"\`"包裹的

> create database `microservice-auth` default character set utf8 collate utf8\_general\_ci;  
> create database `microservice-exam` default character set utf8 collate utf8\_general\_ci;  
> create database `microservice-gateway` default character set utf8 collate utf8\_general\_ci;  
> create database `microservice-user` default character set utf8 collate utf8\_general\_ci;

*  docs/deploy/mysql/init/microservice\_auth.sql
 *  docs/deploy/mysql/init/microservice\_exam.sql
 *  docs/deploy/mysql/init/microservice\_gateway.sql
 *  docs/deploy/mysql/init/microservice\_user.sql

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM4MjE1MDQy_size_16_color_FFFFFF_t_70_pic_center 1]

# 4: 启动后端项目 #

1.  启动项目前要先确认consul、MySQL、redis、rabbitMq是否已经启动
2.  配置JVM参数：目的是限制每个服务的内存：如`config-server`可以分配64M（-Xmx64m -Xms64m）,其他服务分配128M（-Xmx128m -Xms128m）
3.  按顺序启动
    
     *  config-service :9181
     *  auth-service :9182
     *  user-service :9183
     *  exam-service :9184
     *  gateway-service :9180  
        需要监控功能在启动
     *  monitor-service :9186
     *  msc-service :9185  
        这里可能会报链接不上zipkin的异常，可以忽略，因为zipkin服务没启动，不影响部署。
4.  先解决一个问题吧，就是有一个包是需要手动添加到maven的  
    添加教程：[添加jar包到maven仓库教程地址][jar_maven]

> mvn install:install-file -Dfile=QRCode.jar -DgroupId=QRCode -DartifactId=QRCode -Dversion=3.0 -DcreateChecksum=true -Dpackaging=jar -DgeneratePom=true

1.  成功截图  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM4MjE1MDQy_size_16_color_FFFFFF_t_70_pic_center 2]  
    去你的maven下可以找到这个jar信息  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM4MjE1MDQy_size_16_color_FFFFFF_t_70_pic_center 3]  
    最后就可以看到所有的jar都引入正常了  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM4MjE1MDQy_size_16_color_FFFFFF_t_70_pic_center 4]
2.  修改项目VM  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM4MjE1MDQy_size_16_color_FFFFFF_t_70_pic_center 5]  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM4MjE1MDQy_size_16_color_FFFFFF_t_70_pic_center 6]
3.  访问consul管控台，检查各个服务的health check是否正常，如下图说明所有服务均启动成功  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM4MjE1MDQy_size_16_color_FFFFFF_t_70_pic_center 7]

# 5: 启动前端项目 #

1.  安装前端依赖 （方式一 npm）  
    分别在`frontend/spring-microservice-exam-ui`、`frontend/spring-microservice-exam-web`，目录下，命令行运行：

> $ npm install  
> 安装过程可能耗时较久，还可能安装node-saas失败，可以再执行：  
> $ npm i node-sass --sass\_binary\_site=https://npm.taobao.org/mirrors/node-sass/  
> $ npm run dev

![在这里插入图片描述][20200910153825126.png_pic_center]

1.  安装前端依赖（方式二 yarn）

# 安装yarn
    npm install -g yarn
    
    # 下载依赖
    yarn install
    
    # 启动
    yarn run dev
    
    # 编译项目
    yarn run build
    
    # Lints and fixes files
    yarn run lint

1.  我直接用的yarn方式，前端下载依赖没出错，启动的时候出错了，错误信息如下：  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM4MjE1MDQy_size_16_color_FFFFFF_t_70_pic_center 8]
2.  解决办法修改spring-microservice-exam-ui的package.json文件

> “vue-spinkit”: “~1.4.1”,

1.  spring-microservice-exam-web这个项目的不用修改，直接就可以启动
2.  这个问题解决思路：  
    由于package.json文件中版本号的特点，下面三个版本号在安装的时候代表不同的含义。

"5.0.3",
    "~5.0.3",
    "^5.0.3"

“5.0.3”表示安装指定的5.0.3版本，“～5.0.3”表示安装5.0.X中最新的版本，“^5.0.3”表示安装5.X.X中最新的版本。这就麻烦了，常常会出现同一个项目，有的同事是OK的，有的同事会由于安装的版本不一致出现bug。  
7. 配置 `IntelliJ IDEA`  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM4MjE1MDQy_size_16_color_FFFFFF_t_70_pic_center 9]  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM4MjE1MDQy_size_16_color_FFFFFF_t_70_pic_center 10]  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM4MjE1MDQy_size_16_color_FFFFFF_t_70_pic_center 11]  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM4MjE1MDQy_size_16_color_FFFFFF_t_70_pic_center 12]

1.  可以在上面的idea命令行页面运行下载依赖的操作
2.  启动的话就和你平时启动项目没两样，右上角的启动按钮启动就行了  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM4MjE1MDQy_size_16_color_FFFFFF_t_70_pic_center 13]
3.  项目启动成功登录截图  
    前台：localhost:8080  
    后台：localhost:9527  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM4MjE1MDQy_size_16_color_FFFFFF_t_70_pic_center 14]![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM4MjE1MDQy_size_16_color_FFFFFF_t_70_pic_center 15]
4.  默认账号  
    管理员:admin/123456  
    学生：student/123456  
    教师：teacher/123456

# 6: 监控 #

<table> 
 <thead> 
  <tr> 
   <th>名称</th> 
   <th>地址</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>rabbitMq监控</td> 
   <td>localhost:15672</td> 
  </tr> 
  <tr> 
   <td>spring boot admin服务监控</td> 
   <td>localhost:9186</td> 
  </tr> 
  <tr> 
   <td>zipKin链路跟踪</td> 
   <td>localhost:9411</td> 
  </tr> 
  <tr> 
   <td>consul</td> 
   <td>localhost:8500</td> 
  </tr> 
 </tbody> 
</table>

# 7: 其他 #

1.  密钥库（部署可暂时忽略）  
    使用keytool生成jwt token密钥库

> $ keytool -genkeypair -alias jwt -keyalg RSA -dname “CN=jwt,L=Berlin,S=Berlin,C=DE” -keypass abs123 -keystor

执行下面命令，输入密钥，复制输出的公钥

> $ keytool -list -rfc --keystore jwt-jks | openssl x509 -inform pem -pubkey

1.  GC参数  
    生产参数实例

> \-Xmx512m -Xms256m -XX:+UnlockDiagnosticVMOptions -XX:+UseConcMarkSweepGC -XX:+UseCMSInitiatingOccupancyOnly -XX:CMSInitiatingOccupancyFraction=70 -XX:AutoBoxCacheMax=20000 -XX:-UseBiasedLocking -XX:-UseCounterDecay -XX:-OmitStackTraceInFastThrow -Djava.security.egd=file:/dev/urandom -XX:+CMSParallelInitialMarkEnabled -XX:+ParallelRefProcEnabled -XX:+ExplicitGCInvokesConcurrent -XX:+PrintGCApplicationStoppedTime -XX:+PrintGCApplicationConcurrentTime -XX:+PrintGCDateStamps -XX:+PrintGCDetails -XX:+PrintTenuringDistribution -XX:+HeapDumpOnOutOfMemoryError -XX:+PerfDisableSharedMem -XX:+PrintCompressedOopsMode -XX:-PrintGCApplicationStoppedTime

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM4MjE1MDQy_size_16_color_FFFFFF_t_70_pic_center 16]

1.  接口文档地址： localhost:9180/swagger-ui.html  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM4MjE1MDQy_size_16_color_FFFFFF_t_70_pic_center 17]  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM4MjE1MDQy_size_16_color_FFFFFF_t_70_pic_center 18]  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM4MjE1MDQy_size_16_color_FFFFFF_t_70_pic_center 19]
2.  后台页面展示  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM4MjE1MDQy_size_16_color_FFFFFF_t_70_pic_center 20]  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM4MjE1MDQy_size_16_color_FFFFFF_t_70_pic_center 21]  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM4MjE1MDQy_size_16_color_FFFFFF_t_70_pic_center 22]

# 8: 项目地址 #

1.  [硕果云项目地址][spring-microservice-exam]

# 9: 本机环境 #

1.  jdk：1.8
2.  Erlang：V8.3（特别说明，安装rabbitMQ之前要安装erlang环境）
3.  rabbitMQ：3.6.12
4.  node：v12.16.3
5.  mysql：5.7
6.  redis
7.  consul：1.4.3

[spring-microservice-exam]: https://gitee.com/wells2333/sg-exam
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM4MjE1MDQy_size_16_color_FFFFFF_t_70_pic_center]: /images/20221123/d42e4ef28fe34fd1943269fb2a842f96.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM4MjE1MDQy_size_16_color_FFFFFF_t_70_pic_center 1]: /images/20221123/b8a169f25e0344b19db9a14127e8932a.png
[jar_maven]: https://blog.csdn.net/qq_38215042/article/details/107079202
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM4MjE1MDQy_size_16_color_FFFFFF_t_70_pic_center 2]: /images/20221123/c51e530c441044c996d4adc570e611cd.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM4MjE1MDQy_size_16_color_FFFFFF_t_70_pic_center 3]: /images/20221123/94ba2a13b4a1433fb4fa3131ff27c832.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM4MjE1MDQy_size_16_color_FFFFFF_t_70_pic_center 4]: /images/20221123/1e3f4bb523a843c6bb39791b3e13c04c.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM4MjE1MDQy_size_16_color_FFFFFF_t_70_pic_center 5]: /images/20221123/fd77913cd01b4902bfa65e36a84b2ab4.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM4MjE1MDQy_size_16_color_FFFFFF_t_70_pic_center 6]: /images/20221123/3d4ecc322af14993a17ce9aae0905640.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM4MjE1MDQy_size_16_color_FFFFFF_t_70_pic_center 7]: /images/20221123/c5568f38e8434940979316508801feed.png
[20200910153825126.png_pic_center]: /images/20221123/ad465df517b74c6d90a8e311bce22f3c.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM4MjE1MDQy_size_16_color_FFFFFF_t_70_pic_center 8]: /images/20221123/937d81fd6abc41fdaa38cb7b4f4c4a97.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM4MjE1MDQy_size_16_color_FFFFFF_t_70_pic_center 9]: /images/20221123/12ed22aa4a4a42ba84dda8bc5b127f90.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM4MjE1MDQy_size_16_color_FFFFFF_t_70_pic_center 10]: /images/20221123/80c8754829a84064906d28bf96a18dcc.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM4MjE1MDQy_size_16_color_FFFFFF_t_70_pic_center 11]: /images/20221123/f5f7f5b33e5d4f65bd888d25fa96c4af.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM4MjE1MDQy_size_16_color_FFFFFF_t_70_pic_center 12]: /images/20221123/da8bfacb56d941b5aa24c50600a207aa.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM4MjE1MDQy_size_16_color_FFFFFF_t_70_pic_center 13]: /images/20221123/c9c9535b98cd4f48b735d2ea3b05f660.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM4MjE1MDQy_size_16_color_FFFFFF_t_70_pic_center 14]: https://img-blog.csdnimg.cn/20200910152000745.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM4MjE1MDQy,size_16,color_FFFFFF,t_70#pic_center
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM4MjE1MDQy_size_16_color_FFFFFF_t_70_pic_center 15]: /images/20221123/bbc1892f20f242788d3d9f4d5428f45c.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM4MjE1MDQy_size_16_color_FFFFFF_t_70_pic_center 16]: /images/20221123/761896c2f87e435cac3df2a24ca55b06.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM4MjE1MDQy_size_16_color_FFFFFF_t_70_pic_center 17]: /images/20221123/a788510cd9c847e387aa7848104017f6.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM4MjE1MDQy_size_16_color_FFFFFF_t_70_pic_center 18]: /images/20221123/53ea38a68659416c945e0ae3fc7caaca.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM4MjE1MDQy_size_16_color_FFFFFF_t_70_pic_center 19]: /images/20221123/c26a3eaebdf44f1a998fee63230a7e33.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM4MjE1MDQy_size_16_color_FFFFFF_t_70_pic_center 20]: /images/20221123/a4cb73f1459149bba0d4e4c9487b9d70.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM4MjE1MDQy_size_16_color_FFFFFF_t_70_pic_center 21]: /images/20221123/c32d47641d024898ae7a59ee8313e750.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM4MjE1MDQy_size_16_color_FFFFFF_t_70_pic_center 22]: /images/20221123/b73f144aecfa4bc68bd4ca98d78240d4.png