Exporting existing plan configuration to Bamboo YAML Specs

To ease migration of your Bamboo plans to configuration as code, we have prepared the export feature.

Note: This will not export historical data for the plans.


In order to export an existing build plan to Bamboo Specs source code:

  1. If you don't have Bamboo Specs project, create one
  2. Go to your build plan and select Actions > Configure plan.
  3. On the plan configuration page, select Actions > View plan as YAML Specs.
  4. Copy generated YAML code to your code editor by putting it into the bamboo-specs/bamboo.yaml file.

To export an existing deployment plan to Bamboo Specs source code:

  1. If you don't have Bamboo Specs project, create one
  2. Go to your deployment project and select ... > Edit project.
  3. On the deployment project configuration page, select ... > View project as YAML Specs.
  4. Copy generated YAML code to your code editor by putting it into the bamboo-specs/bamboo.yaml.


The code is ready to be put into repository, with a few exceptions:

  • manually created branches are not exported - you can add them manually in the UI

We advise you to cross-check the generated code with Bamboo Specs reference manual and to compare original and generated plan.

Sensitive data such as passwords or keys are exported as values encrypted using Bamboo's System-wide encryption algorithm. You will see BAMSCRT@0@... exported in place of the secret string. For details on generating encrypted secrets for new values, see Bamboo Specs encryption.

You will find equivalent classes for the vast majority of Bamboo concepts in the generated code, such as: plans, stages, jobs, tasks of different kinds, permissions, deployments. The export feature doesn't handle all tasks known to Bamboo. Export of such tasks should be implemented by apps vendors.

Last modified on Aug 10, 2021

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.