Copy Page

You are not logged in. Any changes you make will be marked as anonymous. You may want to Log In if you already have an account. You can also Sign Up for a new account.

<h3>Definition</h3><table class="wysiwyg-macro" data-macro-name="excerpt" data-macro-parameters="atlassian-macro-output-type=BLOCK" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e2V4Y2VycHQ6YXRsYXNzaWFuLW1hY3JvLW91dHB1dC10eXBlPUJMT0NLfQ&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="RICH_TEXT"><tr><td class="wysiwyg-macro-body"><p>Deploy an expanded WAR that will be started when the container starts</p></td></tr></table><h3>Example using the Java API</h3><table class="wysiwyg-macro" data-macro-name="code" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e2NvZGV9&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="PLAIN_TEXT"><tr><td class="wysiwyg-macro-body"><pre>InstalledLocalContainer container = new Resin3xInstalledLocalContainer(
    new Resin3xStandaloneConfiguration("target/resin3x"));
container.setHome("c:/apps/resin-3.0.27");

Deployable war = new WAR("some/expanded/war/directory");
war.setContext("application-context");
container.getConfiguration().addDeployable(war);

container.start();
</pre></td></tr></table><h3>Example using the Ant API</h3><p>Starting Tomcat 6.x with a WAR to deploy:</p><table class="wysiwyg-macro" data-macro-name="code" data-macro-default-parameter="xml" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e2NvZGU6eG1sfQ&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="PLAIN_TEXT"><tr><td class="wysiwyg-macro-body"><pre>&lt;cargo containerId="tomcat6x" home="c:/tomcat/tomcat-6.0.33" action="start">
  &lt;configuration>
    &lt;deployable type="war" file="some/expanded/war/directory">
      &lt;property name="context" value="application-context"/>
    &lt;/deployable>
  &lt;/configuration>
&lt;/cargo>
</pre></td></tr></table><h3>Example using the Maven2/Maven3 API</h3><p>Here is the plugin configuration defining a Tomcat 6.x container with a WAR to deploy expanded:</p><table class="wysiwyg-macro" data-macro-name="code" data-macro-default-parameter="xml" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e2NvZGU6eG1sfQ&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="PLAIN_TEXT"><tr><td class="wysiwyg-macro-body"><pre>&lt;dependencies>
  &lt;dependency>
    &lt;groupId>org.codehaus.cargo&lt;/groupId>
    &lt;artifactId>simple-war&lt;/artifactId>
    &lt;version>${simple-war.version}&lt;/version>
    &lt;type>war&lt;/type>
  &lt;/dependency>
&lt;/dependencies>

&lt;plugins>
  &lt;plugin>
    &lt;groupId>org.codehaus.cargo&lt;/groupId>
    &lt;artifactId>cargo-maven2-plugin&lt;/artifactId>
    &lt;version>${cargo.version}&lt;/version>
    &lt;configuration>
      &lt;containerId>tomcat6x&lt;/containerId>
      &lt;zipUrlInstaller>
        &lt;url>http://archive.apache.org/dist/tomcat/tomcat-6/v6.0.33/bin/apache-tomcat-6.0.33.zip&lt;/url>
      &lt;/zipUrlInstaller>
      &lt;deployables>
        &lt;deployable>
          &lt;groupId>org.codehaus.cargo&lt;/groupId>
          &lt;artifactId>simple-war&lt;/artifactId>
          &lt;type>war&lt;/type>
          &lt;!--
            Override location to point to the exploded webapp.
            -->
          &lt;location>some/expanded/war/directory&lt;/location>
          &lt;properties>
            &lt;context>application-context&lt;/context>
          &lt;/properties>
        &lt;/deployable>
      &lt;/deployables>
    &lt;/configuration>
  &lt;/plugin>
&lt;/plugins>
</pre></td></tr></table><h3>For more information...</h3><p>For more information about how deployment in CARGO works, please read:</p><ul><li><a class="confluence-link" href="/display/CARGO/Deployable" data-linked-resource-id="13115" data-linked-resource-type="page" data-linked-resource-default-alias="Deployable" data-base-url="http://docs.codehaus.org">How deployables work</a>, which explains how to instanciate and personalize deployables.</li><li><a class="confluence-link" href="/display/CARGO/Deployer" data-linked-resource-id="22203" data-linked-resource-type="page" data-linked-resource-default-alias="Deployer" data-base-url="http://docs.codehaus.org">How deployers work</a>, which explains how the different deployers work.</li></ul>