4.1.3. deploy

Description

Deploys a bundle to an environment.

Usage

bw deploy BUNDLE_PATH ENV_PATH [NAME]

  • BUNDLE_PATH points to the bundle to be deployed.
  • ENV_PATH points to the destination environment.
  • NAME is an optional name for the deployment. If not specified, the bundle name will be used.

Ant Usage

<bw.deploy bundle="${bundle}" environment="${environment}" [name="${name}"] />

Examples

# Deploy a custom app to the 'dev' environment
bw deploy /opt/bundles/hello-1.5 /local/dev
# Deploy a tomcat instance to the 'prod' environment under a different name
bw deploy /opt/bundles/tomcat/5.5.25 /var/env/prod tomcat01

Notes

  • This command prompts for confirmation.
  • The deploy command is used for first time installations, upgrades, and rollbacks.
  • If the environment does not already contain the bundle, an installation is performed and the bundle hook 'install' is executed.
  • If the environment contains an older version of the bundle, an upgrade is performed and the bundle hook 'upgrade' is executed.
  • If the environment contains a newer version of the bundle, a rollback is performed and the bundle hook 'rollback' is executed.
  • BundleWorks uses the 'Created-Date' attribute inside the bundle info file to determine whether a bundle is older or newer.
  • If a NAME is provided, that name becomes the alias name for working with that deployment. In the example, above "tomcat01 start" would be used to start the deployed tomcat instance.