Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 4.0

Definition

Excerpt

A configuration for a container that is already started

Explanation

This configuration represents a container that is already running somewhere, be it on the same machine as Cargo or not, that might have been started by Cargo or not. Cargo accesses that container using a remote access protocol and the container is considered as a black box.

This configuration is typically used in order to remotely deploy applications.

Support Matrix

Java

Ant

Maven2

IntelliJ IDEA

Netbeans

(tick)

(tick)

(tick)

(question)

(question)

Java API

There are different ways of using a runtime configuration:

  • By directly instantiating the configuration matching your container. For example:
Code Block
[...]
Configuration configuration = new TomcatRuntimeConfiguration();
[...]
  • By using the DefaultConfigurationFactory which automatically maps the right implementation for the container you're using. For example:
Code Block
[...]
ConfigurationFactory factory = new DefaultConfigurationFactory();
Configuration configuration = factory.createConfiguration("tomcat5x", 
    ContainerType.REMOTE, ConfigurationType.RUNTIME);
[...]

Ant Task

Example:

Code Block
xml
xml
<cargo containerId="tomcat5x" [...]>
  <configuration type="runtime"/>
  [...]
</cargo>

Maven2 Plugin

Example:

Code Block
xml
xml
[...]
<container>
  <containerId>tomcat5x</containerId>
  [...]
</container>
<configuration>
  <type>runtime</type>
</configuration>
[...]

Note that the Maven2 Archetype showing remote deployer support is a complete and easy-to-use example for remote deployment. Please read: Webapp Creation and Remote Deployment Archetype.