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
  • Cargo Daemon
• Articles
• License
• Credits

Containers

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

• Glassfish
  • Glassfish 2.x
  • Glassfish 3.x
  • Glassfish 4.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
  • Jetty 9.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
  • Resin 4.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
  • WebLogic 12.x

• WebSphere
  • WebSphere 8.5.x

Extensions

• Ant
• Cargo Daemon
• Maven2/Maven3

Independent extensions:

• Gradle
• 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 any of the supported containers.
• A Java API to (remotely or locally) deploy modules into these containers, be it a server alone, a farm or a cluster.
• A Java API to parse/create/merge J2EE modules.
• ANT tasks wrapping the Java API for configuring, starting, stopping and deploying applications to all supported containers.
• A Web interface that wraps the Java API that can be used to configure, start and stop all containers supported by Cargo remotely and at any time.
• Maven2/Maven3 plugins wrapping the Java API for configuring, starting, stopping and deploying applications to all supported containers as well as parsing, creating and merging J2EE modules.

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
• Introduction to the Cargo Daemon

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
Geronimo 3.x	1.2.4	1.2.4	1.2.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
Glassfish 4.x	1.4.0	1.4.0	1.4.0
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
Jetty 9.x	1.3.0	1.3.0	1.3.0
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
Resin 4.x	1.4.0	1.4.0	1.4.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
WebLogic 12.x	1.2.4	1.2.4	1.2.4
WebSphere 8.5.x	1.3.0	1.3.0	1.3.0

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 16, 2013

CARGO 1.4.0 is here!

Dear CARGO enthusiasts Almost two months after CARGO 1.3.3, we've gone a long way through CARGO 1.4.0. Major enhancements, changes and bug fixes include: Core: [CARGO-365] - CARGO should check status of application server before attempting to start container [CARGO-1068] - Add support for port offset for containers Containers - Glassfish: [CARGO-1189] - Glassfish jvm-options should not be quoted [CARGO-1190] - Glassfish <systemProperties> should be XML-encoded when added to domain.</systemProperties>…

S. Ali Tokmen posted on Feb 14, 2013

CARGO 1.3.3 is here!

Dear CARGO enthusiasts CARGO 1.3.3 is here! This new version features the below fixes and improvements: Containers - General The configuration files option now overrides all existing files (CARGO-1176) Containers - Glassfish Glassfish deployment does not fail anymore on Windows when context is / (CARGO-1179) Containers - JBoss Support for the append parameter has been added to the JBoss logger configuration (CARGO-825) JBoss 7.x and 7.1.x now support JBossPropertySet.…

S. Ali Tokmen posted on Jan 12, 2013

Give a warm welcome to CARGO 1.3.2!

Dear CARGO enthusiasts CARGO's first version in 2013, version 1.3.2, is now ready! This new version fixes the below issues: Containers - JBoss: JBoss 7.x and JBoss 7.1.x containers now support ServletPropertySet.USERS (CARGO-1163) The JBoss 7.x and 7.1.x Remote Deployer now handles disconnections properly,…