Quick Links

Documentation

Containers

Extensions

Project Info

Get Involved

Development

Feeds


 Site
News

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 and optionally deploy deployables (WAR, EAR, etc)
cargo:stop Stop a 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 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 this is performed automatically by the cargo:start goal



The configuration elements are described in the Reference Guide section.