Java项目配置

概览

以 若依管理系统 https://gitee.com/y_project/RuoYi 作为例子，最终大概是这样子的。

Java项目配置 - 图1注意

以下基于 spug v2.3.4 版本，如果低于 v2.3.4 可以参考 版本升级文档 进行升级，例子仅作为演示，一般情况下你都需要结合自己的项目情况调整配置。

about

安装 jdk / maven

如果已安装可跳过该步骤，这里以安装 jdk-8u251 和 maven-3.6.3 为例，如果你使用 Docker 部署的 Spug，可参考以下步骤进行安装

Java项目配置 - 图3注意

以下仅适用于 2.3.4 及以后的镜像（基于 Centos）启动的容器（这里的 2.3.4 并不是 Spug 的版本号，请在 hub.docker.com 查询镜像版本）。

因 Oracle JDK 下载需要登录账户请自行下载，这里直接使用下载完成的 jdk-8u251-linux-x64.tar.gz 文件。

  1. # 自行至 https://www.oracle.com/java/technologies/javase/javase-jdk8-downloads.html 下载jdk
  2. # 把已下载的压缩包拷贝进容器
  3. docker cp jdk-8u251-linux-x64.tar.gz spug:/
  4. docker exec -it spug bash
  5. tar xf jdk-8u251-linux-x64.tar.gz -C /opt
  7. # 安装maven
  8. curl -o apache-maven-3.6.3-bin.tar.gz http://apache.mirrors.pair.com/maven/maven-3/3.6.3/binaries/apache-maven-3.6.3-bin.tar.gz
  9. tar xf apache-maven-3.6.3-bin.tar.gz -C /opt/
  10. echo -e 'export JAVA_HOME=/opt/jdk1.8.0_251\nexport PATH=$PATH:$JAVA_HOME/bin:/opt/apache-maven-3.6.3/bin' > /etc/profile.d/java.sh
  12. # [可选]配置阿里云镜像加速下载，在159-164行（<mirrors\>标签内）添加以下内容
  13. vi /opt/apache-maven-3.6.3/conf/settings.xml
  15.     159     <mirror>
  16.     160       <id>aliyunmaven</id>
  17.     161       <mirrorOf>*</mirrorOf>
  18.     162       <name>阿里云公共仓库</name>
  19.     163       <url>https://maven.aliyun.com/repository/public</url>
  20.     164     </mirror>
  22. # 退出并重启容器
  23. exit
  24. docker restart spug

文件过滤

只需要发布编译过的 jar 包，所以这里选择了 包含 规则。

  1. ruoyi-admin.jar

自定义变量

该例子中并不需要特殊的 全局变量，如果你需要的话可以在这里定义，然后在下边的钩子中类似 $SPUG_DEPLOY_ID 那样去引用。

代码检出前

该例子中也不需要执行。

代码检出后

在这里进行项目的依赖包安装和编译工作，该钩子中当前目录即为按发布申请中选择 Git 分支/版本 检出后的代码目录。

  1. # 执行maven编译
  2. mvn clean package -Dmaven.test.skip=true
  3. cp ruoyi-admin/target/ruoyi-admin.jar .

这里拷贝 ruoyi-admin.jar 至项目根目录，因为咱们文件过滤规则指定的就是相对于项目根目录。

应用发布前

发布前停止现有的服务。

  1. # 停止服务
  2. set +e
  3. ps -ef | grep ruoyi-admin | grep -v grep | awk '{print $2}' | xargs kill -9

因为 Spug 会检测每个钩子内脚本最终退出状态码，如果非 0 则认为执行异常终止发布，所以如果你的目标主机是 Centos 则需要通过 if 来判断进程 是否存在，如果存在才执行 kill。

  1. # 停止服务
  2. PID=$(ps -ef | grep ruoyi-admin | grep -v grep | awk '{print $2}')
  3. if [ ! -z $PID ]; then
  4.    kill -9 $PID
  5. fi

应用发布后

在这里启动服务。

  1. # 添加jdk至PATH变量
  2. PATH=$PATH:/usr/local/jdk1.8.0_231/bin
  3. nohup java -jar ruoyi-admin.jar &> run.log &