概述
Maven本身不提供任何插件将war包发布到远程站点,例如Tomcat这样类似的Servlet容器,但是,Apache Tomcat本身提供了一个Maven插件:
<dependency>
<groupId>org.apache.tomcat.maven</groupId>
<artifactId>tomcat7-maven-plugin</artifactId>
<version>2.1</version>
</dependency>
tomcat7-maven-plugin是很久以前的插件版本,默认支持到Tomcat7,但是对于目前最新的Tomcat9同样可以使用该插件(虽然插件的ArtifactId的名字为tomcat7很奇怪)
一、Tomcat插件支持的目标
默认使用的Tomcat7插件支持多种目标,
调用格式如下:
mvn tomcat7:[goal]
例如,远程部署一个项目到Tomcat容器:
mvn tomcat7:deploy
文档如下:
二、系统要求及插件引入
2.1 系统要求
要求如下:
2.2 引入插件
引入方式:
<project>
...
<build>
<!-- 在POM中或父POM中使用这样的插件(IDEA会出现对应的插件栏) -->
<plugins>
<plugin>
<groupId>org.apache.tomcat.maven</groupId>
<artifactId>tomcat7-maven-plugin</artifactId>
<version>2.1</version>
</plugin>
...
</plugins>
</build>
...
</project>
三、远程部署war到tomcat
命令格式:
mvn tomcat7:deploy
3.1 添加tomcat管理角色
修改tomcat的用户配置文件
%TOMCAT_HOME%/conf/tomcat-users.xml,添加一个用户:
<?xml version="1.0" encoding="UTF-8"?>
<tomcat-users xmlns="http://tomcat.apache.org/xml"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://tomcat.apache.org/xml tomcat-users.xsd"
version="1.0">
<role rolename="manager-gui" />
<role rolename="manager-script"/>
<user username="username" password="password" roles="manager-gui,manager-script"/>
</tomcat-users>
注意!可以给该用户添加多个角色,为了远程部署,至少需要这个角色:
- manager-script
当然,也可以开启manager-gui用于可视化管理
3.2 本地Maven设置Server
为了让本地发布的Maven可以找到对应的服务器并完成鉴权
需要修改settings.xml,并添加服务器,这里的账号、密码需要和部署的tomcat服务器配置的一致:
<servers>
<server>
<id>tomcatServer</id>
<username>username</username>
<password>password</password>
</server>
</servers>
3.3 项目配置Tomcat插件
<build>
<!-- 在POM中或父POM中使用这样的插件(IDEA会出现对应的插件栏) -->
<plugins>
<plugin>
<groupId>org.apache.tomcat.maven</groupId>
<artifactId>tomcat7-maven-plugin</artifactId>
<version>2.2</version>
<configuration>
<url>http://{yourIP}:8080/manager/text</url>
<server>tomcatServer</server>
<update>true</update>
<path>/${project.artifactId}</path>
</configuration>
</plugin>
...
</plugins>
</build>
此处指定了插件所使用的切记需要一致(setting.xml和pom.xml)
3.4 插件参数说明
tomcat7-maven-plugin为每个目标提供了多个参数,每个目标可以有相关的配置,具体说明可参考官方文档:
Plugin Documentation
3.4.1 必选参数
以下参数必选,但是可以在pom中空缺,空缺时将采用默认值
3.4.2 可选参数
对于个性化的需求,tomcat7插件提供了可配置的参数
3.5 运行结果
调用:mvn tomcat7:deploy命令得到下图:
成功快速部署到tomcat中
四、远程undeploy
此外,如果快速卸载(undeploy)Tomcat服务器的项目,使用:
mvn tomcat7:undeploy
效果如下:
写在最后:
更多关于Java的技术和资讯可以关注我的专栏:
Java架构筑基zhuanlan.zhihu.com专栏免费给大家分享Java架构的学习资料和视频