JeecgBoot项目上线发布的几种方式

向右看齐 2022-12-16 09:07 889阅读 0赞

## 方案一：JAR部署方案 ##

### 1. 正式环境部署 ###

部署方案采用nginx+tomcat部署方案  
后端服务通过JAR方式运行  
前端项目build后的静态资源，部署到nginx中

### 2. 后台项目jeecg-boot打jar包 ###

*  通过jeecg-boot-parent打包项目。
 *  jeecg-boot-module-system作为启动项目。

1.  修改数据库连接 application-prod.yml
2.  修改缓存redis配置 application-prod.yml
3.  修改上传附件配置 application-prod.yml

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmd4aWZhY2FpX2JlbGlldmU_size_16_color_FFFFFF_t_70_pic_center][]

1.  切换配置为线上配置 application.yml  
    相关配置文件有application-dev.yml，application-prod.yml，application-test.yml和application.yml，在application.yml中指定哪个配置文件生效。

![20201019164813635.png_pic_center][]

1.  修改pom.xml加上打包插件

<build>
      <plugins>
      <plugin>
          <groupId>org.springframework.boot</groupId>
          <artifactId>spring-boot-maven-plugin</artifactId>
      </plugin>
     </plugins>
    </build>

我的项目中用的是以下打包插件：

<plugins>
    	
    	
    	
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <configuration>
                <source>1.8</source>
                <target>1.8</target>
                <encoding>UTF-8</encoding>
            </configuration>
        </plugin>
    </plugins>

1.  执行下jeecg-boot-parent的 install 操作

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmd4aWZhY2FpX2JlbGlldmU_size_16_color_FFFFFF_t_70_pic_center 1][]

1.  maven package 打 jar 包

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

1.  找到jeecg-boot-module-system-2.0.0.jar JAR包

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmd4aWZhY2FpX2JlbGlldmU_size_16_color_FFFFFF_t_70_pic_center 2][]

1.  后台项目jeecg-boot启动  
    通过命令启动项目：

*  Window下启动命令：

>> java -jar D:\jeecg-boot-module-system-2.0.0.jar

*  Linux下后台进程启动命令：

>> nohup java -jar jeecg-boot-module-system-2.0.0.jar >catalina.out 2>&1 &

*  关掉项目：

>> ps -ef|grep java
    >> kill 进程号

### 3. 前台项目build ###

1.  修改后台接口服务地址 public/index.html

window._CONFIG['domianURL'] = 'http://localhost:8080/jeecg-boot';
    window._CONFIG['imgDomainURL'] = 'http://localhost:8080/jeecg-boot/sys/common/view';
    window._CONFIG['pdfDomainURL'] = 'http://localhost:8080/jeecg-boot/sys/common/pdf/pdfPreviewIframe';

重要提示：

*  后台服务接口地址，一定要配置外网的IP或者域名，配置内网域名后台访问不到的。
 *  后台启动默认名字jeecg-boot，不建议修改。如果需要修改，请自行替换此文中所有提到项目名jeecg-boot的地方；  
    同时修改前端代码 src/utils/request.js，里面的项目名字。

const service = axios.create({ 
      baseURL: '/jeecg-boot', // api base_url
      timeout: 6000 // 请求超时时间
    })

1.  使用build命令打包项目

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmd4aWZhY2FpX2JlbGlldmU_size_16_color_FFFFFF_t_70_pic_center 3][]

build完成后台会生成一个dist的目录该目录下即为build后的文件。

1.  nginx部署前端项目  
    拷贝dist下的代码到nginx安装目录下html目录中，即可。

### 4. nginx配置 ###

1.  nginx监听80端口，配置文件：conf/nginx.conf

server {
    		listen       80;
    		server_name  你的域名;
    
    		# 后台服务配置，配置了这个location便可以通过 http://域名/jeecg-boot/xxxx 访问		
    		location ^~ /jeecg-boot {
    			proxy_pass              http://127.0.0.1:8080/jeecg-boot/;
    			proxy_set_header        Host 127.0.0.1;
    			proxy_set_header        X-Real-IP $remote_addr;
    			proxy_set_header        X-Forwarded-For $proxy_add_x_forwarded_for;
    		}
    		# 解决Router(mode: 'history')模式下，刷新路由地址不能找到页面的问题
    		location / {
    			root   html;
    			index  index.html index.htm;
    			if (!-e $request_filename) {
    				rewrite ^(.*)$ /index.html?s=$1 last;
    				break;
    			}
    		}
    	}

1.  nginx 开启压缩，提高首页访问效率  
    nginx.conf 的 http 中加入以下片断：

# gzip config
    gzip on;
    gzip_min_length 1k;
    gzip_comp_level 9;
    gzip_types text/plain application/javascript application/x-javascript text/css application/xml text/javascript application/x-httpd-php image/jpeg image/gif image/png;
    gzip_vary on;
    gzip_disable "MSIE [1-6]\.";

参考图：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmd4aWZhY2FpX2JlbGlldmU_size_16_color_FFFFFF_t_70_pic_center 4][]

1.  配置后启动nginx  
    通过：http://你的域名 访问项目，出现如下页面，使用账户/密码：admin/123456 登录成功即可  
    ![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmd4aWZhY2FpX2JlbGlldmU_size_16_color_FFFFFF_t_70_pic_center 5][]

## 方案二：WAR部署方案 ##

### 1. 正式环境部署 ###

部署方案采用nginx+tomcat部署方案  
后端服务发布部署到tomcat中  
前端项目由于build后都是静态问题，部署到nginx中

### 2. 后台项目jeecg-boot打war包（jeecg-boot-module-system） ###

后台项目jeecg-boot-module-system打war包之前要进行如下改动：

1.  pom.xml文件中项目打包格式设置为war，具体配置如下：

<modelVersion>4.0.0</modelVersion>
    <groupId>org.jeecgframework.boot</groupId>
    <artifactId>jeecg-boot-module-system</artifactId>
    <version>2.0.0</version>
    <packaging>war</packaging>

1.  pom.xml文件删除插件spring-boot-maven-plugin，下面配置删除

<build>
       <plugins>
    	<plugin>
    		<groupId>org.springframework.boot</groupId>
    		<artifactId>spring-boot-maven-plugin</artifactId>
    	</plugin>
       </plugins>
    </build>

1.  增加项目web容器部署的支持，修改类/src/main/java/org/jeecg/JeecgApplication.java，代码如下：

package org.jeecg;
    
    import org.springframework.boot.SpringApplication;
    import org.springframework.boot.autoconfigure.SpringBootApplication;
    import org.springframework.boot.builder.SpringApplicationBuilder;
    import org.springframework.boot.web.servlet.support.SpringBootServletInitializer;
    
    import springfox.documentation.swagger2.annotations.EnableSwagger2;
    
    @SpringBootApplication
    @EnableSwagger2
    public class JeecgApplication extends SpringBootServletInitializer { 
    	
    	@Override
        protected SpringApplicationBuilder configure(SpringApplicationBuilder application) { 
            return application.sources(JeecgApplication.class);
        }
    
        public static void main(String[] args) { 
        	System.setProperty("spring.devtools.restart.enabled", "true");
        	SpringApplication.run(JeecgApplication.class, args);
        }
    }

1.  注释掉WebSocket配置  
    将此类注释掉：jeecg-boot-module-system/org.jeecg.config.WebSocketConfig
2.  修改配置文件（数据库和redis配置）

*  修改数据库连接 application-prod.yml
 *  修改缓存redis配置 application-prod.yml
 *  修改上传附件配置 application-prod.yml

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmd4aWZhY2FpX2JlbGlldmU_size_16_color_FFFFFF_t_70_pic_center 6][]

*  切换配置为线上配置 application.yml

![20201019174346478.png_pic_center][]

打包：

1.  首先执行下jeecg-boot-parent的install 操作

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmd4aWZhY2FpX2JlbGlldmU_size_16_color_FFFFFF_t_70_pic_center 7][]

1.  然后 maven package 打war包

![20201019174629562.png_pic_center][]

### 3. 后台项目jeecg-boot部署tomcat ###

1.  设置tomcat端口号 8080，设置tomcat编码 URIEncoding=“UTF-8”
2.  部署项目到tomcat安装目录webapps/jeecg-boot工程目录下

部署完后通过http://localhost:8080/jeecg-boot 可以访问项目，提示token错误说明部署成功。  
注意：

1.  tomcat解压war后的目录名称即你访问的根路径，即这里的jeecg-boot
2.  新版的swagger需要访问http://localhost:8080/jeecg-boot/doc.html

### 4. 前台项目build及nginx部署同方案一 ###

配置后启动tomcat，启动nginx。

## 方案三：极简部署方案，基于 SpringBoot 特性 ##

1.  首先修改配置，去掉项目名 jeecg-boot

ant-design-jeecg-vue/src/utils/request.js
    ant-design-jeecg-vue/public/index.html

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmd4aWZhY2FpX2JlbGlldmU_size_16_color_FFFFFF_t_70_pic_center 8][]  
![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmd4aWZhY2FpX2JlbGlldmU_size_16_color_FFFFFF_t_70_pic_center 9][]

1.  修改路由History 模式为“hash”

src/router/index.js

![20201019180318341.png_pic_center][]  
然后 ant-design-jeecg-vue 运行 build：

>> npm run build

1.  然后将编译之后dist下的文件复制到 jeecg-boot-module-system 项目的 /src/main/resources/static 目录下
2.  修改springboot项目启动，根路径访问页面为 index.html  
    jeecg-boot-module-system\\src\\main\\java\\org\\jeecg\\config\\WebMvcConfiguration

/** * 访问根路径默认跳转 index.html页面 （简化部署方案： 可以把前端打包直接放到项目的 webapp，上面的配置） */
    @Override
    public void addViewControllers(ViewControllerRegistry registry) { 
    	registry.addViewController("/").setViewName("index.html");
    }

1.  修改springboot项目的启动名字，去掉项目名 jeecg-boot

jeecg-boot-module-system/src/main/resources/application-dev.yml

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmd4aWZhY2FpX2JlbGlldmU_size_16_color_FFFFFF_t_70_pic_center 10][]

1.  重新启动项目，访问 http://localhost:8080/ 就可以看到效果

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmd4aWZhY2FpX2JlbGlldmU_size_16_color_FFFFFF_t_70_pic_center]: /images/20221123/a07c169dfe7e4d2dba4ecc4cb6c17f38.png
[20201019164813635.png_pic_center]: /images/20221123/00f193ff99c840fcab9d43d4c5f5722c.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmd4aWZhY2FpX2JlbGlldmU_size_16_color_FFFFFF_t_70_pic_center 1]: /images/20221123/f55918ae46b542d1adfa45836f1e873b.png
[2020101916584034.png_pic_center]: /images/20221123/dd2253a917f647fb8719e7dbe8af93f3.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmd4aWZhY2FpX2JlbGlldmU_size_16_color_FFFFFF_t_70_pic_center 2]: /images/20221123/80d4d38067144c45a3f65525becdf754.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmd4aWZhY2FpX2JlbGlldmU_size_16_color_FFFFFF_t_70_pic_center 3]: /images/20221123/fd73ed5ac02e4bcd9a3ff5563ed723f2.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmd4aWZhY2FpX2JlbGlldmU_size_16_color_FFFFFF_t_70_pic_center 4]: /images/20221123/2974072884eb4f06b4823db316cc5f5a.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmd4aWZhY2FpX2JlbGlldmU_size_16_color_FFFFFF_t_70_pic_center 5]: /images/20221123/cc0193a339b34ccabce7377618a765e4.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmd4aWZhY2FpX2JlbGlldmU_size_16_color_FFFFFF_t_70_pic_center 6]: /images/20221123/f885fd7f8ea646af9375ee2e27316039.png
[20201019174346478.png_pic_center]: /images/20221123/daa63aa1e89c455b9c567ec22ecc1802.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmd4aWZhY2FpX2JlbGlldmU_size_16_color_FFFFFF_t_70_pic_center 7]: /images/20221123/53f18799d96645ecaadada8371136496.png
[20201019174629562.png_pic_center]: /images/20221123/3f32fb08b3fe4ac0ae1dd84e5aeea500.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmd4aWZhY2FpX2JlbGlldmU_size_16_color_FFFFFF_t_70_pic_center 8]: /images/20221123/5293bb572c0e40edaeed790f046cb8b1.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmd4aWZhY2FpX2JlbGlldmU_size_16_color_FFFFFF_t_70_pic_center 9]: /images/20221123/9ba58f33414e4be1a6b24afc41cdf38d.png
[20201019180318341.png_pic_center]: /images/20221123/93081d3bfd104ee39b2070503c3776fa.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmd4aWZhY2FpX2JlbGlldmU_size_16_color_FFFFFF_t_70_pic_center 10]: /images/20221123/cb53c03fd1f74dfea29add3a38a045a6.png