This page last changed on Nov 21, 2006 by vmassol.

A Maven 2 plugin that wraps the Cargo Java API

Functional tests
The usage of Cargo for executing functional tests on a container does not mandate this m2 plugin. You could directly use the Cargo Java API from your Java unit test classes (JUnit, TestNG, etc), as described on the Functional testing page.

Table of Contents

The documentatation for this Maven2 plugin includes:

  • Installation: explains how to install the plugin
  • Getting started: explains how to use the plugin on several use cases
  • Reference Guide: provide reference documentation for all configuration options
  • Tips: tips for using the plugin

Getting Started

As usual the best way to learn to use a tool is through examples. We have several sample projects that we use as our internal functional tests suite. We really recommend that you check them out.

Another good way to get started is to use Maven2 Archetypes we have created for you.

In addition here are the typical uses cases covered by the plugin:

Here are the different goals available to call on this plugin:

Goals Description
cargo:start Start a container. That task can optionally install and configure a container; it can also optionally deploy deployables (WAR, EAR, etc.) to it.
cargo:stop Stop a container
cargo:configure Create the configuration for a local container, without starting it
cargo:package Package the local container
cargo:deployer-deploy (aliased to cargo:deploy) Deploy a deployable to a running container
cargo:deployer-undeploy (aliased to cargo:undeploy) Undeploy a deployable from a running container
cargo:deployer-start Start a deployable already installed in a running container
cargo:deployer-stop Stop a deployed deployable without undeploying it
cargo:deployer-redeploy (aliased to cargo:redeploy) Undeploy and deploy again a deployable
cargo:uberwar Merge several WAR files into one
cargo:install Installs a container distribution on the file system. Note that the cargo:start task will also install the container automatically (but will not call cargo:install).
cargo:help Get help (list of available goals, available options, etc.) (since v1.0.2)


The configuration elements are described in the Reference Guide section.

Document generated by Confluence on Jul 10, 2010 12:22