• IDEA开发工具maven项目通过tomcat7插件远程部署项目


    1.添加tomcat用户及权限

    由于涉及到tomcat的自动部署,所以需要具备tomcat的管理权限,而普通的tomcat用户是没有管理权限的,比如通过{TOMCAT_HOME}/bin/startup.bat启动tomcat之后,在首页右侧的Manager App中,需要先输入管理员账户和密码才能进行项目服务器上项目的管理,否则根本无法进入管理页面。

    添加用户和权限也很简单,在{TOMCAT_HOME}/conf/tomcat-users.xml 文件中,</tomcat-users>节点下添加如下内容,创建管理角色和用户,并授权用户管理角色:

    <role rolename="manager-gui" />
    <role rolename="manager-script" />
    <user username="tomcat" password="tomcat" roles="manager-gui, manager-script"/>
    

    之后进入tomcat首页->Manager App测试管理员账号是否创建成功

    注:

    • username和password可以自定义,这里为了简单记忆使用了tomcat同时作为用户名和密码。
    • 网上有的博客这里配置了大量的权限,但是目前并没有发现其在这个阶段的作用和意义。

    2.配置tomcat允许远程访问

    默认tomcat只允许本地部署,如果是要部署到远程服务器上,那么需要在远程服务器的{TOMCAT_HOME}conf/Catalina/localhost/目录下创建一个manager.xml文件,配置如下内容:

    <?xml version="1.0" encoding="UTF-8"?>
    <Context privileged="true" antiResourceLocking="false" docBase="${catalina.home}/webapps/manager">
             <Valve className="org.apache.catalina.valves.RemoteAddrValve" allow="^.*$" />
    </Context>
    

    如果只想允许部分IP拥有访问权限,那么可以配置allow节点,比如

    allow="127.0.0.1,192.168.1.*"
    

    代表只允许主机拥有访问权限。

    注意:如果没有这一步的配置,本地tomcat服务器部署正常,但是远程tomcat服务器会报出下方常见问题中提到的Cannot invoke Tomcat manager: Connection reset by peer: socket write error异常

    3.为maven添加tomcat管理员账号

    由于需要使用maven来构建和部署项目,所以maven就需要拥有tomcat的管理员账号信息。
    {MAVEN_HOME}/conf/settings.xml文件中<servers>节点下添加如下内容:

    <!-- 配置可以操作tomcat的用户名和密码 -->
    <server>
        <id>crocutax</id>
        <!-- server login name -->
        <username>tomcat</username>
        <!-- server login password -->
        <password>tomcat</password>
    </server>
    

    4.配置tomcat7插件

    在项目的pom.xml中配置tomcat7 plugin,具体节点的意义看注释或下方清单

    <!-- 配置Tomcat插件 -->
    <plugin>
        <groupId>org.apache.tomcat.maven</groupId>
        <artifactId>tomcat7-maven-plugin</artifactId>
        <version>2.2</version>
    
        <configuration>
            <!-- 此处的名字必须和{MAVEN_HOME}/conf/settings.xml中配置的server节点的id一致-->
            <server>crocutax</server>
            <!--服务器端口号-->
            <port>8080</port>
            <!-- 项目发布的路径,默认就是tomcat/webapps目录,可以指定深层次目录,留"/",则默认在webapps目录下部署ROOT.war包-->
            <path></path>
            <!-- 注意tomcat7此处的url,不能随意修改,后缀必须是text,不能是html. 如果是本地tomcat部署,用localhost和ip都可以 -->
            <url>http://localhost:8080/manager/text</url>
            <!--<url>http://117.62.110.110:8080/manager/text</url>-->
            <!--解决中文参数乱码问题-->
            <uriEncoding>UTF-8</uriEncoding>
            <update>true</update>
            <!--配置在tomcatconf	omcat-users.xml中定义的用户名-->
            <username>tomcat</username>
            <password>tomcat</password>
        </configuration>
    </plugin>
    

    节点清单

    • server : 名字必须和{MAVEN_HOME}/conf/settings.xml中配置的server节点的id一致
    • port : 服务器端口号
    • path :项目发布的路径,默认就是tomcat/webapps目录,可以指定深层次目录,留"/",则默认在webapps目录下部署ROOT.war包
    • url : 注意tomcat7此处的url,不能随意修改,后缀必须是text,不能是html. 如果是本地tomcat部署,用localhost和ip都可以
    • uriEncoding :解决中文参数乱码问题
    • update : 热部署,否则后期会报错
    • username :配置{TOMCAT_HOME}conf omcat-users.xml中定义的用户名
    • password :同上

    5.启动tomcat服务器

    先通过{TOMCAT_HOME}/bin/startup.bat启动tomcat,启动完毕之后再进行部署,否则会报出如下异常

    Cannot invoke Tomcat manager: Connection refused: connect -> [H
    elp 1]
    

    6.maven命令部署

    在IDE->Terminal 或 项目根目录打开dos窗口,输入maven命令

    • mvn clean package tomcat:deploy (使用的是插件1.1版本,如果pom.xml中配置的是2.2版本,那么使用这么命令会报错)
    • mvn clean package tomcat7:deploy (使用的是插件2.2版本,自己用的这个)

    然后看着命令行歇一会吧

    ...
    [INFO] --- maven-war-plugin:2.2:war (default-war) @ cmw ---
    [INFO] Packaging webapp
    [INFO] Assembling webapp [cmw] in [D:codeserverchinesemedicine	argetcmw]
    [INFO] Processing war project
    [INFO] Copying webapp resources [D:codeserverchinesemedicinesrcmainwebapp]
    [INFO] Webapp assembled in [887 msecs]
    [INFO] Building war: D:codeserverchinesemedicine	argetcmw.war
    [INFO] WEB-INFweb.xml already added, skipping
    [INFO]
    [INFO] <<< tomcat7-maven-plugin:2.2:deploy (default-cli) < package @ cmw <<<
    [INFO]
    [INFO]
    [INFO] --- tomcat7-maven-plugin:2.2:deploy (default-cli) @ cmw ---
    [INFO] Deploying war to http://localhost:8080/cmw
    Uploading: http://localhost:8080/manager/text/deploy?path=%2Fcmw&update=true
    Uploaded: http://localhost:8080/manager/text/deploy?path=%2Fcmw&update=true (45960 KB at 40564.5 KB/sec)
    
    [INFO] tomcatManager status code:200, ReasonPhrase:OK
    [INFO] OK - Deployed application at context path /cmw
    [INFO] ------------------------------------------------------------------------
    [INFO] BUILD SUCCESS
    [INFO] ------------------------------------------------------------------------
    [INFO] Total time: 18.075 s
    [INFO] Finished at: 2017-09-17T11:31:21+08:00
    [INFO] Final Memory: 20M/293M
    [INFO] ------------------------------------------------------------------------
    
    

    出现 BUILD SUCCESS,就部署成功了!

    常见的部署命令,在Tomcat7 Plugin Documentation 中有详细介绍,这里罗列几个常用的:

    • tomcat7:run 运行当前项目
    • tomcat7:deploy 部署当前项目
    • tomcat7:redeploy 重新部署项目
    • tomcat7:undeploy 取消部署当前项目

    常见问题

    Tomcat return http status error: 401, Reason Phrase: Unauthorized

    未授权访问tomcat,即没有tomcat的管理权限,如果没有进行步骤1中的"添加tomcat用户及权限"操作,远程部署时就会报此异常。

    还有一种情况,已经在conf/tomcat-users.xml中配置了用户和权限

    <!-- 创建用户,并授权 -->
    <role rolename="manager-gui" />
    <role rolename="manager-script" />
    <user username="tomcat" password="tomcat" roles="manager-gui, manager-script"/>
    

    但是还是有这个异常信息,于是在服务器tomcat首页测试Manager App,发现定义的tomcat管理员角色无法正常登陆。这说明配置的用户和角色出问题了,继续排查,在tomcat启动日志中,发现了如下异常信息:

    警告: Unexpected exception resolving reference
    com.sun.org.apache.xerces.internal.impl.io.MalformedByteSequenceException: 1 字节的 UTF-8 序列的字节 1 无效。
    

    于是怀疑是有中文字符造成的影响,删掉了在tomcat-users.xml中的中文注释,即

    <!-- 创建用户,并授权 -->
    

    再次部署,tomcat Manager App 测试成功,远程一键部署成功!

    注:

    虽然这里是WARN而不是ERROR,但是还是有可能造成一些内部程序的加载失败导致功能缺失,比如这里的tomcat启动成功,但是内部管理权限却配置失败,进而导致远程部署因没有权限而失败。所以,从严谨性角度出发,如果精力足够,那么所有的WARN都不容忽视。

    Connection reset by peer: socket write error

    异常信息:[ERROR] Failed to execute goal org.apache.tomcat.maven:tomcat7-maven-plugin:2.2:deploy (default-cli) on project cmw: Cannot invoke Tomcat manager: Connection reset by peer: socke
    t write error -> [Help 1]

    这个应该是部署的时候最容易出现的异常了,在这里卡了很久。网上查了一大圈。根本原因是:当客户端发出请求(request)后,如果还没有完全获得服务端的响应(response),客户端与服务器段的连接断开(例如断网、按了“停止”按钮、或者客户端浏览器关闭等),服务器端就会抛出此Exception。

    这个问题需要从多方面排查。

    1.如果是远程服务器,需要配置tomcat允许远程访问,见步骤2

    2.有的说tomcat9在步骤1中配置用户权限时,同一个用户不能同时拥有manager-guimanager-script权限,但是我分开了之后,依然没有解决这个问题。最终放弃使用tomcat9,使用tomcat7,一切正常了。

    3.如果tomcat上已经部署了该项目,那么需要使用redeploy命令,即mvn tomcat7:redeploy

    部署后的项目404

    以下3种原因都有可能造成部署后的项目无法正常访问,报404:

    1. 如果是远程服务器,请确保8080端口已经添加到入网规则中
    2. pom.xml中tomcat7插件的path节点配置的有问题
    3. 项目本身404

    tomcat内存泄漏

    tomcat日志中报出

    The web application [/appStore] appears to have started a thread named [Thread-2],but has failed to stop it ,this is very likely to create a memory leak


    非原创,文章来源及参考如下
    作者:王西文
    链接:https://www.jianshu.com/p/d4585b83b9dd
  • 相关阅读:
    在linux下Ant的环境配置
    在linux下Java的环境配置
    CSS列表逆序
    HTML元素基础学习
    第一天---HTML基础学习
    排球计分程序
    罗辑思维:怎样成为一个高手 观后感
    十八周个人作业
    本周个人作业
    个人作业
  • 原文地址:https://www.cnblogs.com/helloworldmybokeyuan/p/11229712.html
Copyright © 2020-2023  润新知