Skip to main content
System StatusContact Support
VersionOne Community

Configuring the Bamboo Plugin

The Bamboo plugin is maintained by Continuum for pulling build data from Bamboo and triggering build jobs as well.

Configuration

Before using the Bamboo plugin, you must set up one or more Bamboo server instances.

  1. Select Plugins from the Administration menu (cogwheel icon) and select  Bamboo from the list of plugins available. 
  2. Click Add and enter the following information:
    • Name: Type a name for the Bamboo server instance. 
    • User and Password: Type the username and password that should be used to log on to the Bamboo server. Leave blank if no authentication is required. 
    • URL: Type the URL of the Bamboo server. 
  3. Click Test Connection and make sure you are able to connect to the Bamboo server successfully.
  4. Repeat steps 2 and 3 to add more instances.
  5. When you have more than one server instance, click Set As Default to set one of the instances as the default.

Using the Bamboo Plugin 

Once one or more Bamboo server instances have been set up, you can set up pipelines that use the Bamboo plugin. You can either create a new Stage and add a step that uses the Bamboo plugin or add the Bamboo plugin to an existing Stage.

Functions

There are two functions available with the Bamboo plugin, which you can use in your Pipelines. 

  • Build: Used to trigger a build of a specified Bamboo job. 
  • Get Build Info: Used to get the build information (running or completed).

Build

The Build function triggers a specified job on the Bamboo server. If the "wait" value was set to "true" it will poll Bamboo until the job is finished. Once the job is finished, job data will be pulled back and stored with the Pipeline Instance.

Properties

  • Build Plan Id (required): Top level Bamboo plan ID (projectKey-planKey).
  • Revision ID (optional): Source control revision ID required to create the build. For example, Git ref.
  • Parameters (optional): YAML formatted parameters document. 
  • Wait (true/false) (optional): Whether or not to wait on the Job to complete. The default is 'true'.
  • Inherit Build Status (true/false) (optional): Whether or not to inherit the build status (success/failure). The default is 'true'.
  • Bamboo Instance Name (optional)The name of the Bamboo instance where the build is triggered. Leave blank to connect to the default server instance.
  • API Expand Parameter (optional): Comma-separated expand parameters.
  • Result Key (optional)A name (workspace key) that is used to receive the result of this function.

Get Build Info 

The Get Build Info function is used to get the build status information ("success" or "failure"). This function is typically useful when you want to bring back and store the data from a Bamboo build job in Continuum as a permanent record and it allows you to see the test information and even the logs inside Continuum.

Properties 

  • Build Plan Id (required): Top level Bamboo plan ID (projectKey-planKey).
  • Build Number (required): Bamboo build number. 
  • Revision ID (optional): Source control revision ID required to create the build. For example, Git ref.
  • Wait (true/false) (optional): Whether or not to wait on the Job to complete. The default is 'true'.
  • Inherit Build Status (true/false) (optional): Whether or not to inherit the build status (success/failure). The default is 'true'.
  • Bamboo Instance Name (optional)The name of the Bamboo instance where the build is triggered. Leave blank to connect to the default server instance.
  • API Expand Parameter (optional): Comma-separated expand parameters.
  • Result Key (optional): A name (workspace key) that is used to receive the result of this function.
  • Was this article helpful?