Atlassian Bamboo plugin

The XL Deploy plugin for Atlassian Bamboo enables two tasks:

  • Publish to XL Deploy
  • Deploy with XL Deploy

These tasks can be executed separately or combined sequentially.

For information about Bamboo requirements and the configuration items (CIs) that the plugin supports, see the Bamboo Plugin Reference.

To download the plugin, go to the Atlassian Marketplace.

Tip: To ensure that the Bamboo server is in sync with the XL Deploy server, restart the Bamboo server after each upgrade of the XL Deploy server.

Note: The Bamboo XL Deploy plugin cannot set values for hidden CI properties.

Features

  • Publish DAR package to XL Deploy
  • Trigger deployment in XL Deploy

    • Update mappings on upgrade
  • Execution on Windows/UNIX Slave nodes

Publish to XL Deploy

You can use the publish task to publish a deployment package (DAR file) to XL Deploy. The following properties can be configured:

  • Server URL (required): Address of the XL Deploy server.
  • XL Deploy Username (required): User ID to use when logging in to the XL Deploy server.
  • XL Deploy Password (required): Password for the XL Deploy user.
  • DAR file pattern (required): File pattern where the DAR file can be found. The result should be exactly one file. Example: **/*.dar searches for any file in any subfolder that has the .dar extension.
  • Work directory (optional): Changes the work directory location. The default is the work directory of the task used.

Deploy with XL Deploy

You can use the deploy task to deploy an application with XL Deploy. The application must already be published to XL Deploy (you can do this with the Publish to XL Deploy task).

The following properties can be configured:

  • Server URL (required): Address of the XL Deploy server.
  • XL Deploy Username (required): User ID to use when logging in to the XL Deploy server.
  • XL Deploy Password (required): Password for the XL Deploy user.
  • Environment (required): The environment to which the application will be deployed.
  • Application (required): The deployment package (DAR file).
  • Version (required): The version of the deployment package.
  • Orchestrators (optional): Orchestrator to use. The default is XL Deploy’s default used orchestrator. Use a comma (,) as a separator when specifying multiple orchestrators.
  • Update deployeds (optional): Update the deployeds and mappings on an update. This keeps any previous deployeds present in the deployment object, unless they cannot be deployed due to their tags. It will add all deployeds that are still missing.
  • Action on failure (optional): The action to perform on failure. You can choose to cancel the task (this is the default), to rollback the task, or to do nothing. If you do nothing, the task will stay in XL Deploy, and you can manually review, cancel, or roll back the task from XL Deploy.