Problem Definition

Build plans in Bamboo allows us to create branch plans within to branches in repository from the main branch associated with the main plan.

Whenever we create a Branch Plan in Bamboo, this plan's repository setting can be:

1. Override the plan's default repository and use it's own repository
2. Don't override and use the default repository.

The current behavior when using option 2 is that all configuration is reused, including the repository branch configuration. The ultimate result is that the branch associated with the branch plan is not used, but the one defined in the main plan and the branch plan ends up behaving just like the parent. The branch associated with the branch plan is ignored.

Regarding this configuration:

1. It's not clear in the documentation that the branch plan will use the branch from the main plan
2. This documentation says:

   Plan branches are used to represent a branch in your version control repository, with the plan branch using the same build configuration as your plan.

   • This implies that you can use a different branch when creating a branch plan, but this currently can only be accomplished when overriding the repository settings.

Suggested Solution

Change the documentation to make it clear that not overriding the repository settings will cause the branch plan to not use it's own branch, but the branch configured in the main plan.

Notes

This is for this version of Bamboo: 5.10-OD-15-001 (and some previous versions).