使用Maven部署应用到TongWeb(东方通应用服务器)

使用Maven部署应用到TongWeb(东方通应用服务器)

TongWeb是东方通(TongTech)开发的一款国产Java应用服务器，与Tomcat类似但提供了更多企业级功能。以下是使用Maven将项目部署到TongWeb服务器的方法：

1. 使用TongWeb Maven插件 (推荐方式)

东方通提供了官方的Maven插件，这是最直接的部署方式。

基本配置

<build><plugins><plugin><groupId>com.tongtech</groupId><artifactId>tongweb-maven-plugin</artifactId><version>7.0.0</version> <!-- 根据TongWeb版本调整 --><configuration><url>http://localhost:9060/manager/text</url><username>admin</username><password>tongweb</password><path>/${project.build.finalName}</path><update>true</update><charset>UTF-8</charset></configuration></plugin></plugins>
</build>

在settings.xml中安全配置凭证

<servers><server><id>tongweb-server</id><username>admin</username><password>{DES}加密后的密码</password></server>
</servers>

常用命令

• 部署应用：mvn tongweb:deploy
• 重新部署：mvn tongweb:redeploy
• 取消部署：mvn tongweb:undeploy
• 启动应用：mvn tongweb:start
• 停止应用：mvn tongweb:stop

2. 使用Cargo插件通用部署

如果官方插件不可用，可以使用Cargo进行通用部署：

<plugin><groupId>org.codehaus.cargo</groupId><artifactId>cargo-maven2-plugin</artifactId><version>1.9.11</version><configuration><container><containerId>tongweb7x</containerId><type>remote</type></container><configuration><type>runtime</type><properties><cargo.remote.uri>http://localhost:9060/manager/text</cargo.remote.uri><cargo.remote.username>admin</cargo.remote.username><cargo.remote.password>tongweb</cargo.remote.password><cargo.tongweb.manager.context>manager</cargo.tongweb.manager.context></properties></configuration><deployables><deployable><groupId>${project.groupId}</groupId><artifactId>${project.artifactId}</artifactId><type>war</type><properties><context>/${project.build.finalName}</context></properties></deployable></deployables></configuration>
</plugin>

3. 使用Ant任务通过Maven部署

<plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-antrun-plugin</artifactId><version>3.1.0</version><dependencies><dependency><groupId>com.tongtech</groupId><artifactId>tongweb-ant</artifactId><version>7.0.0</version></dependency></dependencies><executions><execution><phase>deploy</phase><goals><goal>run</goal></goals><configuration><target><taskdef name="tongdeploy" classname="com.tongtech.ant.taskdefs.management.TongDeployTask"classpathref="maven.plugin.classpath"/><tongdeploy url="http://localhost:9060/manager/text"username="admin"password="tongweb"path="/${project.build.finalName}"war="file:${project.build.directory}/${project.build.finalName}.war"update="true"/></target></configuration></execution></executions>
</plugin>

准备工作

在部署前，请确保：

1. 启用管理控制台：

   • 修改TONGWEB_HOME/webapps/manager/META-INF/context.xml，配置适当的IP访问限制

2. 配置用户权限：

   • 修改TONGWEB_HOME/conf/tomcat-users.xml，添加管理用户：

   <role rolename="manager-script"/>
   <user username="admin" password="tongweb" roles="manager-script"/>
   

3. 开放管理端口：

   • 默认管理端口为9060，确保防火墙已放行

多环境部署配置

<profiles><profile><id>dev</id><properties><tongweb.url>http://dev-server:9060/manager/text</tongweb.url></properties></profile><profile><id>prod</id><properties><tongweb.url>http://prod-server:9060/manager/text</tongweb.url><tongweb.path>/prod-${project.build.finalName}</tongweb.path></properties></profile>
</profiles>

使用命令指定环境：mvn tongweb:deploy -Pprod

常见问题解决

1. 部署失败：权限不足

   • 确保用户具有manager-script角色
   • 检查tomcat-users.xml配置

2. 连接被拒绝

   • 确认TongWeb服务已启动
   • 检查管理端口(默认9060)是否开放

3. 中文乱码问题

   • 在插件配置中添加：<charset>UTF-8</charset>
   • 检查TongWeb服务器的文件编码设置

4. 类加载问题

   • TongWeb可能有特殊的类加载机制，检查是否需要调整context.xml配置

5. 内存不足

   • 调整Maven运行内存：export MAVEN_OPTS="-Xms512m -Xmx1024m"

注意事项

1. TongWeb的路径规范可能与标准Tomcat有所不同，特别是上下文路径
2. 企业版TongWeb可能有额外的安全限制，需要联系管理员获取部署权限
3. 生产环境建议使用HTTPS协议进行部署操作
4. 部署前建议备份原有应用

如需更详细的配置，请参考东方通官方文档或联系TongWeb技术支持。