用Maven部署war包到远程Tomcat服务器

Posted 2020-08-27 起个名字好难

原文：http://www.cnblogs.com/guogangj/p/5457959.html#3574439

 

过去我们发布一个Java Web程序通常的做法就是把它打成一个war包，然后用SSH这样的工具把它上传到服务器，并放到相应的目录里，让Tomcat自动去解包，完成部署。

很显然，这样做不够方便，且我们在用SSH把文件拽上去的时候很可能会搞错。(当然了大厂就不会有这样的问题，因为人家有运维团队专门来干这个事情，哈哈)

现在我要的是：一行命令部署到本地服务器，在本地测试一番，没有问题的话就一行命令部署到正式服务器，另外正式服务器的密码只有我自己知道，只有我能执行这个部署(其它开发组员不知道正式服务器密码)。

OK，我们先要在Maven(POM.XML)中引入这个插件：

    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.tomcat.maven</groupId>
                <artifactId>tomcat7-maven-plugin</artifactId>
                <version>2.2</version>
            </plugin>
        </plugins>
    </build>

这个叫“tomcat7-maven-plugin”的插件是利用Tomcat的“manager”模块来实现war包部署的，所以必须确保Tomcat安装了Manager模块，(看看webapp下有没有Manager目录)它虽然名字带“tomcat7”，但Tomcat8也适用，我用的就是Tomcat8。接下来我们对本地的Tomcat的manager模块进行一些配置，打开本地Tomcat的tomcat-users.xml文件，增加这样的配置：

<user username="deployer" password="654321" roles="manager-script"/>

这个叫“deployer”的用户，角色设定为“manager-script”，表明他可以使用Tomcat的manager模块的后台脚本管理，BTW，如果角色为“manager-gui”则表示此用户可使用manager模块的前端网页管理。然后对正式服务器也做一个类似的配置。

贴出配置全面点的：

<role rolename="manager-gui"/>

<role rolename="manager-script"/>

<role rolename="manager-jmx"/>

<role rolename="manager-status"/>

<user username="user1" password="123456" roles="manager-gui,manager-script,manager-jmx,manager-status"/>

 

 

接下来完善一下tomcat7-maven-plugin的配置：

    <properties>
        <warPackageName>MyWebAppDemo</warPackageName>
        <tomcat.deploy.server>localTestServer</tomcat.deploy.server>
        <tomcat.deploy.serverUrl>http://localhost/manager/text</tomcat.deploy.serverUrl>
    </properties>

    <profiles>
        <profile>
            <id>deploy2production</id>
            <properties>
                <tomcat.deploy.server>productionServer</tomcat.deploy.server>
                <tomcat.deploy.serverUrl>http://120.26.93.30:8080/manager/text</tomcat.deploy.serverUrl>
            </properties>
        </profile>
    </profiles>

    <build>
        <finalName>${warPackageName}</finalName>
        <plugins>
            <plugin>
                <groupId>org.apache.tomcat.maven</groupId>
                <artifactId>tomcat7-maven-plugin</artifactId>
                <version>2.2</version>
                <configuration>
                    <server>${tomcat.deploy.server}</server>
                    <url>${tomcat.deploy.serverUrl}</url>
                    <path>/${warPackageName}</path>
                </configuration>
            </plugin>
        </plugins>
    </build>

OK，现在来讲解一番：

Configuration-Server

Configuration中的server是个变量，叫tomcat.deploy.server，我并没有写死，因为我们要将WAR包部署到不同服务器去，而这个变量则由前面的properties来确定，我们可以看到，properties中，tomcat.deploy.server被赋值为localTestServer，这就是我们的默认值，但通过调整Maven的运行参数，我们可以将它修改为别的值，那么localTestServer又表示什么呢？我前面说了，服务器的密码是自己定的，而且不希望别人知道，别的开发组员能各自决定自己本地服务器的密码，但他们无需知道我的密码，所以这个localTestServer的相关的内容是定义在“~/.m2/settings.xml”中的，在Windows7下通常就是在“C:\\Users\\(用户名)\\.m2\\settings.xml”这里。打开这个配置文件，在servers中增加两个server，也就是我们要将程序部署上去的两个server。

<servers>
    <server>
        <id>productionServer</id>
        <username>deployer</username>
        <password>123456</password>
    </server>
    <server>
        <id>localTestServer</id>
        <username>deployer</username>
        <password>654321</password>
    </server>
</servers>

这个貌似没什么好说了，这个配置非常的self-explanatory。

Configuration-url

Configuration中的url也是个变量，很显然，我也不能把它写死，但它不像用户名和密码那么敏感，所以直接出现在POM.XML中也无所谓，默认情况下，其值是“http://localhost/manager/text”，这个地址便是Tomcat的Manager模块的后台脚本入口，url的值同样可以通过Maven的运行参数调整。

Configuration-path

要将WAR包部署到哪里去？要指定一个path，如果path为“/”，也就是部署为传说中的ROOT.WAR，这次我们指定了一个名为MyWebAppDemo的path。部署成功之后可以通过http://localhost/MyWebAppDemo来访问。

profile参数

也就是前面提到的Maven的参数，这里我们定了一个参数，叫deploy2production，在运行mvn的时候带上这个参数的话，就会用参数中的tomcat.deploy.server，tomcat.deploy.serverUrl来取代默认的值。

OK，所有的工作都完成了，就剩下部署了。开始吧：

mvn tomcat7:redeploy

为什么是redeploy而不是deploy？因为用deploy的话在我这里会出现些问题，具体啥问题就不说了，也许你那里正常，如果没问题的话用deploy也行啊。执行完这个之后，我们的程序就被部署到本地Tomcat服务器上了。再来看，这是带参数的mvn：

mvn tomcat7:redeploy -Pdeploy2production

这么一下，我们的程序就被部署到正式服务器去了。

如果你想把程序移除掉，那很简单，只需要使用undeploy来代替redeploy即可。