通过Maven profile实现环境切换,快速部署到正式环境

190 阅读3分钟
原文链接: raye.wang

前言

在开发工作中存在多个环境:开发环境、测试环境、正式环境(生产环境),而每个环境的MySQL、Redis、Rabbitmq、ElasticSearch等配置各不相同,所以每次开发完成部署或者更新都需要手动改变配置文件,尤其是当使用jenkins等相关自动化编译部署的工具的时候,必须要先修改配置文件再上传代码,否则更新就容易出错。解决这个问题常用的方法有:一是通过Git分支,不同环境不同分支,因为配置文件很少修改,所以一般来说合并不会出现问题,另外就算修改了,在提交代码的时候手动合并一下也就可以了。二是通过maven profile,也是本文主要介绍的方式,maven profile方式有个弊端就是每次修改配置文件就需要修改所有的配置文件,好处就是不管什么分支,配置文件都是相同的(在没有修改配置文件的情况下),不用担心切换分支导致环境异常等等。git和maven profile各有优缺点,具体采用哪种可以根据实际情况采用

开始使用Maven profile

创建对应文件夹

使用maven profile需要给不同的环境创建不同的配置文件夹,比如我的项目主要有测试环境和正式环境,所以在resources文件夹创建了2个目录dev(测试环境)和formal(正式环境),同时把配置文件application.yml放入2个文件夹,修改dev的application.yml服务端口为8081,formal的application.yml的服务端口为8080,具体结构如下图 结构图

修改pom.xml文件

首先在pom.xml中创建测试环境和开发环境节点

    <profiles>
        <profile>
            <id>dev</id>
            <properties>
                <environment>dev</environment>
            </properties>
            <activation>
                <activeByDefault>true</activeByDefault>
            </activation>
        </profile>
        <profile>
            <id>formal</id>
            <properties>
                <environment>formal</environment>
            </properties>
        </profile>
    </profiles>

其中id节点是环境的名称,environment是自定义节点,节点值就是创建的环境的文件夹名称,activeByDefault表示不指定环境的时候的默认节点

排除文件夹

为不同环境创建的文件夹,在打包的时候是需要将文件夹内的配置文件打包出来,所以我们需要先排除掉不同环境的文件夹,避免打包的时候将所有文件夹也打包进去

<build>

        <resources>

            <resource>
                <directory>src/main/resources</directory>
                <excludes>
                    <exclude>dev/*</exclude>
                    <exclude>formal/*</exclude>
                </excludes>
            </resource>

        </resources>

</build>  
指定配置目录

指定配置文件在那些目录下,主要是指定环境文件夹和classpath里面的配置文件

    <build>
        <resources>
            <resource>
                <directory>src/main/java</directory>
                <includes>
                    <include>*.xml</include>
                </includes>
            </resource>
            <resource>
                <directory>src/main/resources/${environment}</directory>
            </resource>
        </resources>

    </build>

以上代码配置了2个配置文件点,classpath和指定的环境文件夹

            <resource>
                <directory>src/main/java</directory>
                <includes>
                    <include>*.xml</include>
                </includes>
            </resource>

这里是配置存放Java类文件的源文件目录下的所有xml配置文件,这样存放在src/main/java的配置文件也会打包出来

 <resource>
    <directory>src/main/resources/${environment}</directory>
</resource>  

是配置的环境文件夹,其中${environment}对应之前配置环境的自定义标签environment

打包

不指定环境的打包就跟以前的打包命令没有任何区别,会使用activeByDefault指定的环境,如果要指定环境,就给mvn添加参数-P{environment},P是大写,如果我要打包正式环境

mvn install -Pformal  

中间不需要空格,另外如果是本地测试的话,每次打包之前最好执行一下

mvn clean  

清理一下,否则maven可能会有缓存机制,无法打出正确的包,当然在Jenkins上面不会存在这种问题,因为不会说多个环境打包

不完整的完整的配置文件

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

            <resource>
                <directory>src/main/resources</directory>
                <excludes>
                    <exclude>dev/*</exclude>
                    <exclude>formal/*</exclude>
                </excludes>
            </resource>
            <resource>
                <directory>src/main/java</directory>
                <includes>
                    <include>*.xml</include>
                </includes>
            </resource>
            <resource>
                <directory>src/main/resources/${environment}</directory>
            </resource>
        </resources>

    </build>

    <profiles>
        <profile>
            <id>dev</id>
            <properties>
                <environment>dev</environment>
            </properties>
            <activation>
                <activeByDefault>true</activeByDefault>
            </activation>
        </profile>
        <profile>
            <id>formal</id>
            <properties>
                <environment>formal</environment>
            </properties>
        </profile>
    </profiles>