Enabling repository-stored Bamboo Specs
Storing Bamboo Specs in a repository allows you to keep your project configuration together with the code and automatically publish any code changes. It also gives you access to history of plan specification, and makes it easy to revert to a particular moment in time.
Before you begin
Make sure you have the following:
- native Git installed
- access to Maven central repository
To enable Bitbucket Server repository-stored Bamboo Specs:
- Go to > Linked repositories.
Select your repository.
In the Bamboo Specs tab, enable Scan for Bamboo Specs.
Bamboo Specs from this repository will be able to modify your plans and deployments in Bamboo. Make sure that write permissions to this repository are properly set in Bitbucket Server as any commit to this repository will refresh Bamboo configuration.
In the Projects section, select which projects Bamboo Specs can access.All projectsAvailable only for Bamboo administrators. Use this option if you want to have a repository managing multiple build plans and deployment projects in your Bamboo instance. You can also use this option if you want to be able to create new build projects and deployment projects from Bamboo Specs.Build projects
You must have project administrator or Bamboo administrator permissions to add a build project. You can't add new projects here.
To add a Build project:
- From the Bamboo header, select Projects.
- Select your project.
- Select Project settings > Bamboo Specs repositories.
- Select your repository, and select Add.
In case a plan downloads artifacts from another project (the Artifact Downloader task) or triggers builds of plans in another projects (the Dependencies tab on Plan configuration page), you have to grant access to these projects as well.Deployment projects
You must have project administrator or Bamboo administrator permissions to add a deployment project. You can't add new projects here.
To add a Deployment project:
- From the Bamboo header, select Deploy > All deployment projects.
- Select on your project.
- In the top-right corner, select [...] > Edit project.
- Select Bamboo Spect repositories.
- Select your repository and select Add.
Now, Bamboo Specs from this repository will be able to modify this deployment project and environments.Once you have added your repositories, you can see them listed in the Projects section in Linked repositories.
Additional step for other repositories
Starting from version 6.5, you will be able to use Bamboo Specs Java and YAML with the following repositories:
- Bitbucket Cloud
Webhooks allow your repositories other than Bitbucket Server to communicate with Bamboo.
This is an example of webhook request using curl for a Git repository:
#!/bin/bash /usr/bin/curl -X POST -H "X-Atlassian-Token: no-check" http://[BAMBOO_URL]/bamboo/rest/api/latest/repository/scan\?repositoryId\=[REPOSITORY_ID]
Once you set up a webhook for a repository, it sends the HTTP request to Bamboo with every new commit. This HTTP request, in turn, triggers Bamboo Specs scan repository to see if there are any changes to Specs. If Bamboo detects any changes in a repository, it automatically updates necessary plans and deployments. Learn more about setting up webhooks.