Cargo支持两种本地部署的方式,分别为standalone模式和existing模式。在standalone模式中,Cargo会从Web容器的安装目录复制一份配置到用户指定的目录,然后在此基础上部署应用,每次重新构建的时候,这个目录都会被清空,所有配置被重新生成。而在existing模式中,用户需要指定现有的Web容器配置目录,然后Cargo会直接使用这些配置并将应用部署到其对应的位置。代码清单12-14展示了standalone模式的配置样例。
代码清单12-14 使用standalone模式部署应用至本地Web容器
cargo-maven2-plugin的groupId是org.codehaus.cargo,这不属于官方的两个Maven插件groupId,因此用户需要将其添加到settings.xml的pluginGroup元素中以方便命令行调用。
上述cargo-maven2-plugin的具体配置包括了container和configuration两个元素,configuration的子元素type表示部署的模式(这里是standalone)。与之对应的,configuration的home子元素表示复制容器配置到什么位置,这里的值为${project.build.directory}/tomcat6x,表示构建输出目录,即target/下的tomcat6x子目录。container元素下的containerId表示容器的类型,home元素表示容器的安装目录。基于该配置,Cargo会从D:/cmd/apache-tomcat-6.0.29目录下复制配置到当前项目的target/tomcat6x/目录下。
现在,要让Cargo启动Tomcat并部署应用,只需要运行:
以account-web为例,现在就可以直接访问地址的账户注册页面[1]了。
默认情况下,Cargo会让Web容器监听8080端口。可以通过修改Cargo的cargo.servlet.port属性来改变这一配置,如代码清单12-15所示。
代码清单12-15 更改Cargo的Servlet监听端口
要将应用直接部署到现有的Web容器下,需要配置Cargo使用existing模式,如代码清单12-16所示。
代码清单12-16 使用existing模式部署应用至本地Web容器
上述代码中configuration元素的type子元素的值为existing,而对应的home子元素表示现有的Web容器目录,基于该配置运行mvn cargo:start之后,便能够在Tomcat的webapps子目录看到被部署的Maven项目。
[1] 地址为http:localhost:8080/account-web-1.0.0-SNAPSHOT/signup.jsp。