快捷導(dǎo)航

淺談maven 多環(huán)境打包發(fā)布的兩種方式

更新時(shí)間：2018年08月03日 09:12:56 作者：幸運(yùn)的天才小驢

這篇文章主要介紹了淺談maven 多環(huán)境打包發(fā)布的兩種方式，小編覺得挺不錯(cuò)的，現(xiàn)在分享給大家，也給大家做個(gè)參考。一起跟隨小編過來看看吧

集合工程中 maven 的多環(huán)境打包發(fā)布

在一個(gè)項(xiàng)目的開發(fā)過程中，我們經(jīng)常要進(jìn)行開發(fā)環(huán)境 , 測試環(huán)境，正式環(huán)境打包部署，如果每次打包過程中我們都是人為的根據(jù) 不同環(huán)境去修改一些配置文件，這樣不但工作量太龐大，而且還容易出錯(cuò)，而maven的插件正好解決了我們的困擾。

1. maven 聚合工程的創(chuàng)建

創(chuàng)建過程直接忽略，看最終的結(jié)果圖

第一種方式

2. 不同環(huán)境打包的配置

因?yàn)橐l(fā)布一個(gè)webapp的主要配置文件集中在 web工程中，故而，相關(guān)的配置文件都在 ecps-manager-web工程的 resources下。

原本在 ecps-manager-web的resources中是沒有 dev 和 test 文件夾的。改造后就是上圖。

針對我的resources中文件的管理是分文件夾管理，故而，在分環(huán)境打包是也是按照這種結(jié)構(gòu)創(chuàng)建不同環(huán)境的文件分布。

很顯然。我們把需要更改的配置文件，復(fù)制到各個(gè)不同環(huán)境的文件夾中，同時(shí)保持原有的結(jié)構(gòu)。那些不需要更改的文件是不需要復(fù)制的。

例如：
resources/properties/jdbc.properties是需要更改的配置文件，我們就需要的 dev 和 test 的文件下分別創(chuàng)建一個(gè) properties 文件夾，然后復(fù)制一分jdbc.properties文件即可。

pom.xml中的配置后面再說，先理清思路。

3. 開發(fā)中的使用

現(xiàn)在在這種結(jié)構(gòu)下。我來描述開發(fā)中的存在情況。

1. 本地開發(fā)環(huán)境

我們通常在 svn 或者 github 中 checkout 項(xiàng)目的代碼之后，需要在本地啟動(dòng)開發(fā)，這個(gè)時(shí)候，我們是不需要更改任何東西的。
比如 resource/properties/jdbc.properties 里面本來就配置的開發(fā)中的環(huán)境，所以直接 tomcat 啟動(dòng)即可。不需要管 dev 或者 test

2. 開發(fā)環(huán)境

在前后端分離的開發(fā)方式下，后臺本地開發(fā)完代碼之后，需要打包發(fā)布到開發(fā)的環(huán)境中，提供API接口，這個(gè)時(shí)候就使用 dev 中的配置文件，打包，或者交由 Jenkins 自動(dòng)構(gòu)建開發(fā)環(huán)境。

3. 測試環(huán)境

在前后端功能完成之后，就需要將當(dāng)前功能截止的代碼打包部署到測試環(huán)境，供測試人員測試。這個(gè)時(shí)候就使用 test 中的配置文件，打包，或者交由jenkins 自動(dòng)構(gòu)建測試環(huán)境。

4. 生產(chǎn)環(huán)境

測試完成之后，經(jīng)過預(yù)發(fā)布環(huán)境之后，就要新的 tag 代碼打包部署到正式環(huán)境，上線。這個(gè)時(shí)候就使用 prod 中的配置文件，打包。交由運(yùn)維人員部署代碼。

4. 具體的pom文件

這里的工程又有ecps-manager 是聚合工程，因此，相關(guān)的打包部署信息都配置在 ecps-manager 聚合工程的pom中。

<project xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://maven.apache.org/POM/4.0.0"
     xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  <parent>
    <artifactId>ecps-parent</artifactId>
    <groupId>com.ecps</groupId>
    <version>1.0-SNAPSHOT</version>
    <relativePath>../ecps-parent/pom.xml</relativePath>
  </parent>
  <modelVersion>4.0.0</modelVersion>

  <artifactId>ecps-manager</artifactId>
  <packaging>pom</packaging>

  <name>ecps-manager</name>
  <url>http://maven.apache.org</url>
  <modules>
    <module>/ecps-manager-model</module>
    <module>/ecps-manager-mapper</module>
    <module>/ecps-manager-service</module>
    <module>/ecps-manager-web</module>
  </modules>

  <properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
  </properties>

  <profiles>
    <!--開發(fā)環(huán)境-->
    <profile>
      <id>dev</id>
      <properties>
        <package.environment>dev</package.environment>
      </properties>
      <activation>
        <activeByDefault>true</activeByDefault>
      </activation>
    </profile>
    <profile>
      <!--測試環(huán)境-->
      <id>test</id>
      <properties>
        <package.environment>test</package.environment>
      </properties>
    </profile>
  </profiles>

  <!-- 如果不添加此節(jié)點(diǎn)mybatis的mapper.xml文件都會被漏掉。 因?yàn)閙aven默認(rèn)讀取src/main/resources下的文件-->
  <build>
    <finalName>ecps-manager-web</finalName>

    <plugins>
      <plugin>
        <!-- maven war plugin-->
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-war-plugin</artifactId>
        <version>2.2</version>
        <configuration>
          <webXml>src\main\webapp\WEB-INF\web.xml</webXml>
          <warSourceDirectory>webapp</warSourceDirectory>
          <archive>
            <addMavenDescriptor>false</addMavenDescriptor>
          </archive>
          <webResources>
            <resource>
              <directory>src/main/resources/${package.environment}</directory>
              <targetPath>WEB-INF/classes</targetPath>
              <filtering>true</filtering>
            </resource>
          </webResources>
        </configuration>

      </plugin>

      <!-- 添加tomcat插件 -->
      <plugin>
        <groupId>org.apache.tomcat.maven</groupId>
        <artifactId>tomcat7-maven-plugin</artifactId>
        <configuration>
          <port>8080</port>
          <path>/</path>
          <!-- 系統(tǒng)熱部署配置-->
          <url>http://192.168.31.104:8080/manager/text</url>
          <username>tomcat</username>
          <password>tomcat</password>
        </configuration>
      </plugin>
    </plugins>
  </build>
</project>

打包使用的插件： maven-war-plugin

動(dòng)態(tài)指定目錄，接受參數(shù) ： ${package.environment}

目標(biāo)路徑：targetPage

webXml : 配置web.xml路徑

5. maven 命令打包

mvn clean package -P test -----> 測試環(huán)境
mvn clean package -P dev -----> 開發(fā)環(huán)境

在IDEA 中可以這樣操作：

6. 可能出現(xiàn)的錯(cuò)誤：

web.xml 不存在

有些文檔會將此處配置為：

執(zhí)行 mvn clean package -P test 的時(shí)候，報(bào)錯(cuò) web.xml找不到：

就需要修改中的內(nèi)容。

也就是你工作空間中的對應(yīng)的web.xml的路徑（src/開始）

頁面不能訪問，jsp不存在

修改為自己jsp存放路徑

第二種方式

其實(shí)第一種方式打包之后的war中的結(jié)構(gòu)中依舊存在 dev和test文件夾，而且pom.xml中的配置有點(diǎn)復(fù)雜，現(xiàn)在提出第二種方式，簡單的不能想象。

依舊展示一下打包之前使用第二種方式的結(jié)構(gòu)（工程結(jié)構(gòu)不變，展示ecps-manager-web結(jié)構(gòu)）：

這里把dev 和 test 全部包含到 env 文件夾下。

ecps-manager 聚合工程中 pom.xml

<project xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://maven.apache.org/POM/4.0.0"
     xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  <parent>
    <artifactId>ecps-parent</artifactId>
    <groupId>com.ecps</groupId>
    <version>1.0-SNAPSHOT</version>
    <relativePath>../ecps-parent/pom.xml</relativePath>
  </parent>
  <modelVersion>4.0.0</modelVersion>

  <artifactId>ecps-manager</artifactId>
  <packaging>pom</packaging>

  <name>ecps-manager</name>
  <url>http://maven.apache.org</url>
  <modules>
    <module>/ecps-manager-model</module>
    <module>/ecps-manager-mapper</module>
    <module>/ecps-manager-service</module>
    <module>/ecps-manager-web</module>
  </modules>

  <properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
  </properties>

  <profiles>
    <!--開發(fā)環(huán)境-->
    <profile>
      <id>dev</id>
      <!-- 項(xiàng)目日志配置 -->
      <!-- <properties>    <maven.log.output.directory>${catalina.home}/logs/${project.artifactId}</maven.log.output.directory> 
      </properties>-->
      <build>
        <resources>
          <resource>
            <directory>src/main/resources/env/dev</directory>
          </resource>
        </resources>
      </build>
      <activation>
        <activeByDefault>true</activeByDefault>
      </activation>
    </profile>
    <profile>
      <!--測試環(huán)境-->
      <id>test</id>
      <!-- <properties>       <maven.log.output.directory>${catalina.home}/logs/${project.artifactId}</maven.log.output.directory> 
      </properties>-->
      <build>
        <resources>
          <resource>
            <directory>src/main/resources/env/test</directory>
          </resource>
        </resources>
      </build>
    </profile>
  </profiles>

  <build>
    <finalName>ecps-manager-web</finalName>
    <!--打包之后不包含env-->
    <resources>
      <resource>
        <directory>src/main/resources</directory>
        <filtering>true</filtering>
        <excludes>
          <exclude>**/env/**</exclude>
        </excludes>
      </resource>
    </resources>

    <plugins>
      <!-- 添加tomcat插件 -->
      <plugin>
        <groupId>org.apache.tomcat.maven</groupId>
        <artifactId>tomcat7-maven-plugin</artifactId>
        <configuration>
          <port>8080</port>
          <path>/</path>
          <!-- 系統(tǒng)熱部署配置-->
          <url>http://192.168.31.104:8080/manager/text</url>
          <username>tomcat</username>
          <password>tomcat</password>
        </configuration>
      </plugin>
    </plugins>
  </build>
</project>

最終的打包結(jié)果：