Bamboo Torque Plugin

Intro

This README explains how to install, configure, and use the bamboo-torque-plugin. When a developer commits code to the source control repository, a new build is triggered and a new artifact is created. While testing, Torque provides on-demand sandbox environments integrating with test tools and storage providers to pull the artifacts and push to Production.

Bamboo Torque Plugin integrates Torque into your Bamboo plan. You can use the available build tasks to create a sandbox from any blueprint, start your tests and end the sandbox when finished.

Installation

1. In the Bamboo administration page, scroll down to the Manage apps section and click Find new apps.

2. Search for Torque and install the Bamboo Torque Plugin.

Configuration

1. Generate an API token in Torque:
   a. In the desired Torque space, go to the Settings > Integrations page and click Bamboo.
   b. Click the New Token button.
   c. Copy the generated token.

2. Open the Bamboo administration page.

3. Open Torque Settings.

4. Fill in all fields.
   

Torque plan tasks

After installation, you will have three tasks added to your Bamboo task list:

• Start Torque Sandbox
• Wait for Torque Sandbox
• End Torque Sandbox

Start Torque Sandbox

1. Add the Start Torque Sandbox task.
   * Space name - enter a name for your Torque space.
   * Blueprint name - Enter the name of the blueprint you would like to use for creating this sandbox.
   * Sandbox name - Enter a name for the sandbox
   * Artifacts - If this blueprint has artifacts, you may specify them in a comma separated list of artifact names and their values. e.g., artifact1 name=value1, artifact2 name=value2
   * Inputs - If this blueprint has inputs, you may specify them in a comma separated list of input names and their values. e.g., input1 name=value1, input2 name=value2

This task uses the ${bamboo.SANDBOX_ID} variable to return the identifier of sandbox.

Wait for Torque Sandbox

The Wait for Sandbox task is used to wait for the sandbox to become Active. While the sandbox is launching, it cannot be used and the application links are unavailable.

• Add the Wait For Torque Sandbox task.
  * Space - enter a name for your Torque space.
  * Timeout - Set the timeout for this step, if your sandbox will not be ready when the timeout is reached, Bamboo will abort the deployment.

If the active sandbox has quick links, they will be stored in the following bamboo variables: ${bamboo.endpoint0}, ..., ${bamboo.endpointN}.

End Torque Sandbox

• Add the End Torque Sandbox task to your plan.
  * Space Name - Enter the name of your Torque space.

Note: Torque Bamboo plugin supports only one Sandbox per job.