Showing results for 
Search instead for 
Did you mean: 
Sign up Log in

Earn badges and make progress

You're on your way to the next level! Join the Kudos program to earn points and save your progress.

Deleted user Avatar
Deleted user

Level 1: Seed

25 / 150 points

Next: Root


1 badge earned


Participate in fun challenges

Challenges come and go, but your rewards stay with you. Do more to earn more!


Gift kudos to your peers

What goes around comes around! Share the love by gifting kudos to your peers.


Rise up in the ranks

Keep earning points to reach the top of the leaderboard. It resets every quarter so you always have a chance!


Come for the products,
stay for the community

The Atlassian Community can help you and your team get more value out of Atlassian products and practices.

Atlassian Community about banner
Community Members
Community Events
Community Groups

Is there a reference of Bamboo YAML Specs

I am looking for a reference of the (current) complete Bamboo YAML specs or at least a good JSON schema file to see what options are available.

I have read bamboo-specs-docs 6.10.4 , but this is NOT a reference... this is a series of examples at best or a "how to start" at worst.

The ability to use the same build plan for multiple things, to share common parts of a build plan or just to have a clean versioned build plan in GIT sounds great.


1 answer

0 votes
Jeyanthan I
Atlassian Team
Atlassian Team members are employees working across the company in a wide variety of roles.
Mar 04, 2020

The link you have provided is the actual complete documentation reference for YAML. 

If you are looking for steps to implement this, this tutorial page might come handy - Tutorial: Bamboo Specs YAML stored in Bitbucket Server.


My issue with this document is that the text on the left has nearly no connection to the "example" on the right. A complete list of "what keys can I set for a plan/stage/job/task" would be a start. Something like a schema giving a complete reference what data is parsed by bamboo.

The "script task" description for example says that I can set an environment variable... but the YAML part has no example for this, it only contains USING an environment variable.

Victor Debone
Atlassian Team
Atlassian Team members are employees working across the company in a wide variety of roles.
Mar 05, 2020

Hello @Henning Rogge, I agree that a JSON Schema would be really helpful to write Bamboo Specs YAML and it would be more informative than what any reference can be. We have the open suggestion under BAM-20543. Please share your thoughts there.

Also, I see that the examples were not 100% helpful in your case. What do you miss on them?

Finally, I can also understand the misleading example of environment variables. In YAML the example is trying to convey the environment variables on the line:

- export ANT_OPTS=-Xmx700m 

 Anything else that was not clear on the Script task example?

The script task problem was just a symptom for the whole document. I rarely find a single description in the document which doesn't lead to more questions than answers.

I was looking for a way to use the same Bamboo plan for several different repositories and YAML specs looked like a first good shot.

We are using Bamboo to automatically build Debian files for several project. Each of the build plans use the same 5 stages:

- gather all build requirements
- construct a Docker container with installed build dependencies
- build debian package
- construct a Docker container with installed debian package (and runtime depenencies)
- run tests

We use the docker containers to prevent running building and testing with root permissions (which are necessary to install build/runtime dependencies).

At the moment this is a pain in the ass, because I have no way to easily keep the plans in sync, I have to go through all of them with the web-gui by hand as soon as I make an improvement.

Suggest an answer

Log in or Sign up to answer
AUG Leaders

Atlassian Community Events