Quick Links

• Home
• Downloads
• Quick start
• How to contribute?
  • Adding a container

Documentation

• Overview
  • Architecture
  • Features
• Installation
• Usage
  • Java API
  • Functional testing with JUnit
  • Ant tasks
  • Maven2/Maven3 plugin
• Articles
• License
• Credits

Containers

• Geronimo
  • Geronimo 1.x
  • Geronimo 2.x

• Glassfish
  • Glassfish 2.x
  • Glassfish 3.x

• JBoss
  • JBoss 3.x
  • JBoss 4.x
  • JBoss 4.2.x
  • JBoss 5.x
  • JBoss 5.1.x
  • JBoss 6.x
  • JBoss 6.1.x
  • JBoss 7.x
  • JBoss 7.1.x

• Jetty
  • Jetty 4.x
  • Jetty 5.x
  • Jetty 6.x
  • Jetty 7.x
  • Jetty 8.x

• Jo!
  • jo 1.x

• JOnAS
  • JOnAS 4.x
  • JOnAS 5.x

• JRun
  • JRun 4.x

• Orion/OC4J
  • Oc4J 9.x
  • Oc4j 10.x

• Resin
  • Resin 2.x
  • Resin 3.x
  • Resin 3.1.x

• Tomcat
  • Tomcat 4.x
  • Tomcat 5.x
  • Tomcat 6.x
  • Tomcat 7.x

• WebLogic
  • WebLogic 8.x
  • WebLogic 9.x
  • WebLogic 10.x
  • WebLogic 10.3.x

Extensions

• Ant
• Maven2/Maven3

Independent extensions:

• Gradle
• M2Eclipse Webby
• Mule container

Project Info

• Roadmap
• News
• Issues
• Change log
• SVN
• Mailing Lists
• License
• Credits

Get Involved

• Contributing
• Discussions

Development

• Cargo Code Style
• Project Structure
• Importing sources
• Building
• Release procedure
• CI status

Mission

Tools

Cargo provides the following Tools and APIs:

• A Java API to start/stop/configure Java Containers and deploy modules into them.
• A Java API to parse/create/merge Java EE Modules
• Ant tasks.
• Maven 2/Maven 3 plugin.

These tools and APIs can be used in a standalone fashion or via various IDEs.

Usage

Cargo is often used to deploy applications to containers from test APIs (such as JUnit), ANT or Maven builds. Cargo can install the container and dependencies needed for your deployment as well. Please find below the links to our Quick Start guides:

• Getting Started for the Maven2/Maven3 plugin
• Cookbook for implementing functional testing with the Cargo Java API and JUnit
• Examples for the Cargo ANT tasks

Development Status

Container Support

List of supported containers and the extensions that are implemented for each container (Java API, Ant tasks and Maven2/Maven3 plugin). The specified version is the version of the associated Cargo module where the feature was first made available (for example 0.2 for the Maven2 plugin means version 0.2 of the Cargo Maven 2 extension release). Click on a container's name to see a detailed list of features it supports.

Container	Java API (version)	Ant tasks (version)	Maven 2 plugin (version)
Geronimo 1.x	0.8	0.8	0.8
Geronimo 2.x	1.0.4	1.0.4	1.0.4
Glassfish 2.x	1.0.1	1.0.1	1.0.1
Glassfish 3.x	1.0.1	1.0.1	1.0.1
JBoss 3.x	0.7	0.7	0.7
JBoss 4.x	0.7	0.7	0.7
JBoss 4.2.x	1.0	1.0	1.0
JBoss 5.x	1.0	1.0	1.0
JBoss 5.1.x	1.0.1	1.0.1	1.0.1
JBoss 6.x	1.0.1	1.0.1	1.0.1
JBoss 6.1.x	1.1.3	1.1.3	1.1.3
JBoss 7.x	1.1.2	1.1.2	1.1.2
JBoss 7.1.x	1.1.4	1.1.4	1.1.4
Jetty 4.x	0.1	1.0	0.2
Jetty 5.x	0.8	1.0	0.2
Jetty 6.x	0.8	1.0	0.2
Jetty 7.x	1.0.1	1.0.1	1.0.1
Jetty 8.x	1.1.3	1.1.3	1.1.3
jo! 1.x	0.5	0.5	0.1
JOnAS 4.x	1.0	1.0	1.0
JOnAS 5.x	1.0	1.0	1.0
JRun 4.x	1.0	1.0	1.0
Oc4J 9.x	0.3	0.3	0.3
Oc4j 10.x	1.0	1.0	1.0
Resin 2.x	0.1	0.1	0.1
Resin 3.x	0.1	0.1	0.1
Resin 3.1.x	1.2.0	1.2.0	1.2.0
Tomcat 4.x	0.1	0.1	0.1
Tomcat 5.x	0.1	0.1	0.1
Tomcat 6.x	1.0	1.0	1.0
Tomcat 7.x	1.0.2	1.0.2	1.0.2
WebLogic 8.x	0.3	0.3	0.1
WebLogic 9.x	1.0	1.0	1.0
WebLogic 10.x	1.0	1.0	1.0
WebLogic 10.3.x	1.0	1.0	1.0

We also encourage you to report success and failures on different versions of those containers in the Tested on section. Moreover, some containers are tested dialy on the Codehaus Cargo Continous Integration System; for these the container's page also shows which version is tested.

News

S. Ali Tokmen posted on Apr 01, 2012

CARGO 1.2.1 is now available, and is not an April fool!

Dear CARGO enthusiasts CARGO 1.2.1 is now available; and no this is definitely not an April fool! Of course, all of you are wondering what that release brings in... As usual, we have a certain number of fixes and improvements; major highlights are: 12 bug fixes, be it for core components but also for containers. CARGO now supports starting an installed local container independently from the starting instance (Java API, ANT or Maven2/Maven3 plugin); so that the started container can "outlive".…

S. Ali Tokmen posted on Jan 24, 2012

CARGO 1.2.0 now available!

Dear CARGO enthusiasts First of all, happy New Year! Since the last release of CARGO a bit more than one month and a half ago, we have had the opportunity of fixing some bugs and adding the functionalities: CARGO Maven2/Maven3 plugin fixes and improvements: ContainerStopMojo now can resolve dependencies with scope <test>, the same way ContainerRunMojo and ContainerStartMojo can (CARGO-1069 and CARGO-527).</test>…

S. Ali Tokmen posted on Dec 03, 2011

CARGO 1.1.4 now available!

Dear CARGO enthusiasts About 8 weeks have passed since the last CARGO release. During these weeks, some fixes and improvements have been implemented in CARGO and the new version 1.1.4 is now ready. These changes include: General: Harmonized the behaviour when copying configuration files, now both <file> and <configfiles> can copy directories [CARGO-1045] Improved the module hierarchy and dependencies [CARGO-1011] This way,</file></configfiles>…