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

系统环境需求

阿里云CentOS7.6【最低配置 1核CPU/2G 内存/40G 硬盘 带宽：最低要求1M】
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.8.2-bin.tar.gz
  mv apache-maven-3.8.2 /data/service/
  
  #修改环境变量/etc/profile，MAVEN_HOME修改为自己的路径。
  export  MAVEN_HOME=/data/service/apache-maven-3.8.2
  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
  

  注意4：如果用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

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

3. 修改项目中的配置文件，配置文件有两个，分别是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/
#修改pom.xml把<exclude>WEB-INF/</exclude>启用
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>
                

4. 修改好项目的配置文件之后，把项目进行打包。通过mvn打包成一个可执行的jar包。

cd /data/gitee/MCMS/
mvn clean package

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

5. 启动项目：把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

【注意】localhost为本地地址,根据实际情况修改