程序汪保姆教程在linux上部署运行一套SpringBoot内容管理系统

我是程序汪

共 10741字,需浏览 22分钟

 · 2021-08-11


程序汪已经分享了很多开源项目了,发现一个痛点很多人拿到开源项目了不会部署运行,光看代码很多人看不下去的(程序汪也是这样),程序汪建议拿到开源项目了,一定要想办法把项目运行起来跑跑,然后看看日志或debug下代码(这样看代码才有灵魂)。公众号回复项目分享,分享了很多Java相关的项目,后面打算做几期项目部署视频,分享给大家。

今天分享的是一款内容管理系统方便快速建网站







问题
  • 保姆级教程太少,目前技术公众号分享的项目已经超多了,但保姆级别的视频和笔记非常少

  • 版本不清楚,很多新人安装软件的版本都搞不清楚(一直报错很懵逼),百度一堆都是过时的信息

  • 入职必备技能,新人入职一般也是安装软件然后把项目运行起来,这是程序员的基本能力,平时大家一定要多练习,上班第一天领导让你运行个项目你就可以轻松完成

本教程特点(希望小白都能运行成功)
  • 保姆级教程=笔记(提供MD笔记)+操作视频

  • 视频非常详细,把下载软件安装过程都记录了,可以选择性快进观看



下面是3个版本的若依项目部署教程,单应用/前后分离/微服务 


(视频教程站 B站 我是程序汪)

部署成功的效果





项目源码地址  https://gitee.com/mingSoft/MCMS


技术选型

后端框架

技术 名称 官网
Spring Framework 容器 http://projects.spring.io/spring-framework
Spring Boot MVC框架 https://spring.io/projects/spring-boot
Apache Shiro 安全框架 http://shiro.apache.org
Spring session 分布式Session管理 http://projects.spring.io/spring-session
MyBatis ORM框架 http://www.mybatis.org
Freemarker 视图框架 http://freemarker.foofun.cn
PageHelper MyBatis分页插件 http://git.oschina.net/free/Mybatis_PageHelper
Log4J 日志组件 http://logging.apache.org
Maven 项目构建 http://maven.apache.org
Elasticsearch 分布式搜索引擎 https://www.elastic.co
Redis 分布式缓存数据库 https://redis.io
hutool 工具类 http://hutool.mydoc.io

前端框架

技术 名称 官网
vue 函式库 https://cn.vuejs.org//
element ui UI库 https://element.eleme.cn/2.0/#/zh-CN
jQuery 函式库 http://jquery.com/
Bootstrap 前端框架 http://getbootstrap.com/
Bootstrap-table Bootstrap数据表格 http://bootstrap-table.wenzhixin.net.cn/
BootstrapValidator 表单验证 http://bootstrapvalidator.com/
Font-awesome 字体图标 http://fontawesome.io/
Waves 点击效果插件 https://github.com/fians/Waves/
zTree 树插件 http://www.treejs.cn/v3/
Select2 选择框插件 https://github.com/select2/select2
Vue MVVM框架 https://cn.vuejs.org/
AmazeUI 移动端UI http://amazeui.org/
Plupload 上传控件 http://www.plupload.com/
freemarker 模板引擎 http://freemarker.foofun.cn/toc.html
validator 验证库 https://github.com/chriso/validator.js
animate 动画 http://daneden.github.io/animate.css/
icon 矢量小图标(待更新) http://ms.mingsoft.net/html/86//6048/index.html

笔记 建议结合视频观看





MCMS网站内容管理系统项目部署-linux系统

系统环境需求

阿里云CentOS7.4
JDK >= 1.8
MySQL >= 5.7
Maven >= 3.0
  • 新建目录

    #tmp存放临时安装包
    mkdir -p /data/tmp
    #service存放软件环境
    mkdir -p /data/service
    #gitee存放代码版本控制库
    mkdir -p /data/gitee

    以上目录非必须,可以自行选择安装路径。

  • JDK >= 1.8 (推荐1.8版本)

    从oracle官方网站上下载1.8版本中的最新版的JDK。下载完成后,把文件通过WinSCP或者XFTP上传到服务器上。接着进行解压和配置环境变量。

    下载地址:https://www.oracle.com/java/technologies/javase/javase-jdk8-downloads.html

    #进入安装包目录,解压
    cd /data/tmp
    tar -zxvf jdk-8u301-linux-x64.tar.gz

    #把解压出来的文件夹转移到统一的地方
    mv /data/tmp/jdk1.8.0_301 /data/service/jdk1.8.0_301

    #修改环境变量/etc/profile,JAVA_HOME修改为自己的jdk路径。
    vim /etc/profile
    export JAVA_HOME=/data/service/jdk1.8.0_301
    export PATH=$PATH:$JAVA_HOME/bin

    #使环境变量生效
    source /etc/profile

    #检查是否配置成功
    java -version
  • Maven >= 3.0

    从Maven官方网站上下载最新版的压缩包。下载完成后,进行解压和配置环境变量。

    下载地址:https://maven.apache.org/download.cgi

    #进入安装包目录,解压
    cd /data/tmp
    tar -zxvf apache-maven-3.6.3-bin.tar.gz
    mv apache-maven-3.6.3 /data/service/

    #修改环境变量/etc/profile,MAVEN_HOME修改为自己的路径。
    export MAVEN_HOME=/data/service/apache-maven-3.6.3
    export PATH=$PATH:$MAVEN_HOME/bin

    #使环境变量生效
    source /etc/profile

    #检查是否配置成功
    mvn -v
  • Git

    从git官方网站上下载最新版的安装包,安装即可。

    下载地址:https://git-scm.com/

    #通过yum安装,本方法最简单。但是无法控制安装的版本
    yum -y install git

    #检查是否配置成功
    git --version

    安装之后,在git仓库中需要添加SSH公钥

    ssh-keygen -t rsa -C "xx@xx.com"
    cat ~/.ssh/id_rsa.pub
  • 安装docker

    #卸载旧版本
    sudo yum remove docker \
                    docker-client \
                    docker-client-latest \
                    docker-common \
                    docker-latest \
                    docker-latest-logrotate \
                    docker-logrotate \
                    docker-engine
    #安装 Docker Engine-Community
    sudo yum install -y yum-utils device-mapper-persistent-data lvm2
    sudo yum-config-manager \
      --add-repo \
      http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo
    sudo yum install docker-ce docker-ce-cli containerd.io
    sudo systemctl start docker

    注意:如果安装docker-ce报错,可以执行以下语句,再进行安装。

    yum install https://download.docker.com/linux/fedora/30/x86_64/stable/Packages/containerd.io-1.2.6-3.3.fc30.x86_64.rpm
  • Mysql >= 5.7

    安装教程:https://www.runoob.com/mysql/mysql-install.html

    下载地址:https://dev.mysql.com/downloads/mysql/

    访问Mysql的可视化数据库开发工具:Navicat Premium 工具的安装教程可自行百度搜索。

    在Docker中安装MySQL。

    #查看可用的 MySQL 版本
    docker search mysql
    #拉取5.7版本
    docker pull mysql:5.7
    #创建配置文件目录
    mkdir -p /data/docker/mysql/conf
    #进入配置文件目录,添加一个配置文件
    vim /data/docker/mysql/conf/my.cnf
    #启动镜像
    docker run -p 3306:3306 --name mysql -v /data/docker/mysql/conf:/etc/mysql/conf.d -e MYSQL_ROOT_PASSWORD=root -d mysql:5.7

    注意1:MySQL(5.7.19)的默认配置文件是 /etc/mysql/my.cnf 文件。如果想要自定义配置,建议向 /etc/mysql/conf.d 目录中创建 .cnf 文件。新建的文件可以任意起名,只要保证后缀名是 cnf 即可。

    注意2:在mysql的镜像启动之前,创建配置文件目录,并放置好配置文件。这样mysql启动的时候,就可以直接使用配置好的参数。以下内容是配置数据库的字符集为utf-8。

    [mysqld]
    character-set-server=utf8

    [mysql]
    default-character-set=utf8

    注意3:如果使用docker进入mysql数据库执行包含中文的sql语句,出现中文乱码的情况,需要在容器系统中设置使用中文包。所以进入docker容器时需要设置环境语言:

    #进入docker容器设置env LANG=C.UTF-8
    docker exec -it mysql env LANG=C.UTF-8 bash

    注意5:如果用Navicat连不上,报如下错误:Lost connection to MySQL server at 'waiting for initial communication packet', system error: 0,需使用一下配置。

    [mysqld]
    character-set-server=utf8
    skip-name-resolve

    [mysql]
    default-character-set=utf8

部署步骤

  1. 从git仓库clone下来最新代码。MCMS网站版本的gitee地址是https://gitee.com/mingSoft/MCMS.git

#clone项目源代码
git clone git@gitee.com:mingSoft/MCMS.git

注意:在clone代码之前,需要在gitee管理后台中添加服务器的SSH公钥。详见https://gitee.com/help/articles/4191

  1. 使用可视化数据库开发工具 Navicat Premium进入数据库管理界面。创建数据库mcms并执行doc目录下的数据脚本mcms-*.*.*.sql,例子中使用脚本mcms-5.2.2.sql

  1. 修改项目中的配置文件,配置文件有两个,分别是application.yml和pom.xml。

cd /data/gitee/MCMS/src/main/resources/
#修改application.yml的项目启动端口号
vim application.yml

修改application.yml的项目启动端口号,修改为18081。

server:
port: 18081

修改pom.xml文件,

cd /data/gitee/MCMS/
#修改application.yml的项目启动端口号
vim pom.xml

打成jar包时,需要把<exclude>WEB-INF/</exclude>启用。

# 数据源配置
<build>
      <finalName>ms-mcms</finalName>
      <resources>
          <resource>
              <directory>src/main/webapp</directory>
              <excludes>
                  <!-- 打包生产并手动将static、html、upload、template复制到生产 -->
                  <exclude>static/</exclude>
                  <exclude>html/</exclude>
                  <exclude>upload/</exclude>
                  <exclude>template/</exclude>
                  <!-- 打包war包,必须删除下面一行代码。打包jar包,推荐启用下面一行代码,方便修改页面代码,否则会WEB-INF里面到文件都会打包到jar里面,不方便修改页面代码-->
                  <exclude>WEB-INF/</exclude>
              </excludes>
          </resource>
          <resource>
              <directory>src/main/resources</directory>
          </resource>
          <resource>
              <directory>src/main/java</directory>
              <excludes>
                  <exclude>**/*.java</exclude>
              </excludes>
          </resource>
      </resources>
               
  1. 修改好项目的配置文件之后,把项目进行打包。通过mvn打包成一个可执行的jar包。

cd /data/gitee/MCMS/
mvn clean package

打包完成后,/data/gitee/MCMS/target/ms-mcms.jar就是打包完成后的jar包文件。

  1. 启动项目:把jar复制到程序目录,把配置文件复制到程序目录,把启动脚本复制到程序目录。因为本项目是使用了spring boot框架,所以jar中内置了web容器,不需要额外安装tomcat了。

    mkdir -p /data/app/MCMS
    cp /data/gitee/MCMS/target/ms-mcms.jar /data/app/MCMS/ms-mcms.jar
    cp -r /data/gitee/MCMS/src/main/webapp/* /data/app/MCMS
    cp /data/gitee/MCMS/bin/start.sh /data/app/MCMS
    cd /data/app/MCMS/
    chmod 755 start.sh

    修改启动脚本start.sh

    vim /data/app/MCMS/start.sh

    使用nohup和&用来表示本命令需要在后台执行,这样退出命令行程序后,java程序也不会停止。

    nohup java -XX:MetaspaceSize=128m -XX:MaxMetaspaceSize=128m -Xms1024m -Xmx1024m -Xmn256m -Xss256k -XX:SurvivorRatio=8 -XX:+UseConcMarkSweepGC \
    -Dloader.path=lib,config \
    -jar -Dfile.encoding=utf-8 -Duser.timezone=GMT+08 -Duser.language=zh -Duser.region=CN ./ms-mcms.jar &

    运行启动脚本start.sh

    ./start.sh

6.查看日志,验证项目是否成功运行。

tail -f -n 200 mcms.log

打开浏览器,输入:http://localhost:18081/ms/login.do(默认账户/密码 msopen/msopen若能正确展示登录页面,并能成功登录,菜单及页面展示正常,则表明环境搭建成功。


注意:如果启动报数据库未知错误,数据库连不上修改application-dev.yml的数据源,url结尾加上&serverTimezone=UTC,

# 数据源配置
spring:
datasource:
  url: jdbc:mysql://localhost:3306/mcms?useUnicode=true&characterEncoding=utf-8&zeroDateTimeBehavior=convertToNull&autoReconnect=true&allowMultiQueries=true&useSSL=true&serverTimezone=UTC
  username: root
  password: root
  filters: wall,mergeStat
  type: com.alibaba.druid.pool.DruidDataSource



md笔记版网盘下载地址:

链接: https://pan.baidu.com/s/1K-Z2-_h06iMyRgWJYcYWFg  

密码: cwm7


点下方原文链接观看B站视频版本

浏览 35
点赞
评论
收藏
分享

手机扫一扫分享

举报
评论
图片
表情
推荐
点赞
评论
收藏
分享

手机扫一扫分享

举报