...
- Subscribe to the cargo dev mailing list and ask as many question you'd like there!
- Create a JIRA issue on http://jira.codehaus.org (you'll need to register). IWe'll then add you to the cargo-developers group in JIRA and assign the issue to you
- Checkout Cargo from SVN trunk
- Understand the Cargo project's directory structure. Container implementations are located in
trunk/core/containers/ContainerName
. - Have a look at existing container implementations (search for example for
Resin3xLocalContainer
orOrion2xLocalContainer
). - Create a
org.codehaus.cargo.container.containerName
package if it doesn't already exist. - Create the following classes:
- A container implementation class named
_ServerNameNxContainerType_Container
whereServerName
is the name of the container,N
Nx
the version andContainerType
the type of container (LocalInstalledLocal
orRemote
). For example:JBoss3xLocalContainer
. - A One or several configuration implementation class classes named
_ServerNameConfigurationType_Configuration
whereConfigurationType
can beStandaloneLocal
,ExistingLocal
orExistingLocal
Runtime
. For exampleJBossStandaloneLocalConfiguration
. - One or several deployer implementation classes named
_ServerNameDeployerType_Deployer
whereDeployerType
can beInstalledLocal
orRemote
. For example:JBossInstalledLocalDeployer
. - You may need to implement some ancillary classes but those are the main 2 required. Check how the other container are implemented to see how to implement them and what other classes you may need to implement.
- A container implementation class named
- Cargo has an SPI that you should use and that should make it easy for you. Your container class should extend
org.codehaus.cargo.container.spi.Abstract_ContainerType_Container
and your configuration class should extendorg.codehaus.cargo.container.spi.configuration.Abstract_ConfigurationType_Configuration
. - Register your new classes in the generic API in the Factory classes
trunk/core/api/generic
so that users can use your new container by using the generic API.Verify that your container passes the samples tests. - Run the Cargo build to ensure everything is working. You'll probably find that you haven't followed the Cargo project's coding conventions... Fix those and build again until it passes! Please note that when you run the build it'll automatically run the samples test suites in your container (provided you've added your container to the generic API as described in the previous step and provided you've defined the right capabilities for your container). See the Building page for more details on the build.
- Register on Codehaus' confluence. Once this is done I'll add you to the cargo-developers user group so that you have the right to edit yourself the Cargo web site pages
- Document the new container on the Cargo web site
- Create a SVN patch and attach it to the JIRA issue you have created above
...