Using this guide, you will complete the required build configuration and be able to run a test build on one of your repositories.
Before you begin
Bamboo OnDemand runs builds on elastic agents using Elastic Bamboo, and Elastic Bamboo utilises computing resources from the Amazon Elastic Compute Cloud (EC2). You will be charged by Amazon for your EC2 compute usage. These charges are separate to your Atlassian license cost and will be billed to your Amazon Web Services (AWS) account.
- Make sure that you have at least one project. If not, refer to the steps in the Getting started with JIRA OnDemand page to create a project. A project must exist before you can create a build plan.
- Make sure that you have an AWS account. If you do not have one, register for one on the AWS registration page.
Step 1. Configure Elastic Bamboo
- Log in as an administrator, and go to Administration > Builds > Elastic Bamboo > Configuration.
- Click the Enable button to enable Elastic Bamboo. You will then see the fields to enter the Elastic Bamboo configuration details.
- In the Configuration Details section, enter the AWS Access Key ID and AWS Secret Access Key.
- In the Elastic Bamboo Global Settings section, modify the Maximum Number of Elastic Instance field to be 1. As a start, we will create only 1 plan at this stage, and therefore one instance is enough. You can change this setting later as needed.
- In the Elastic Bamboo AWS Settings section, select Files will be uploaded from your PC and then choose the AWS private key file and certificate file.
- Leave all the other settings as default, and click the Save button.
Screenshot: Uploading your private key file and certificate file
Congratulations! You have enabled and configured Elastic Bamboo. Next, try starting an elastic instance.
Step 2. Start an elastic instance
- In the Builds the administration console, click Elastic Bamboo > Instances. The 'Manage Elastic Instances' page will appear.
- Click the 'Start New Elastic Instances' link. The 'Start New Elastic Instances' screen will appear.
- In the 'Number of instances' field, enter 1 .
- Leave the 'Elastic Image Configuration Name' field as 'Default'.
- Click the 'Submit' button. The 'Manage Elastic Instances' page will appear, showing the startup process of your new instances.
Congratulations! You have started an elastic instance to run your build on. Next, try creating a plan for your build.
Step 3. Create a build plan
- Go to Builds > Create Plan.
- In the Plan Details section, select your project, enter the name and key for the plan.
- In the Source Repository section, select the repository type and add your repository.
- Leave the Build Strategy settings as default for now.
- Click Configure Tasks to specify the actions you want your build plan to carry out. You can leave the task configuration settings as default and come back to customise them later.
- Select the check box in the Enable this Plan section so that the build will start running after the plan is created.
You will see the new plan displayed in the 'All Projects' tab on the 'Builds' dashboard. A build will start running and the progress is displayed along the process.
Congratulations! You have created a build plan and run a build for it. Next, try configuring some of the advanced features of Bamboo OnDemand:
- Grant permissions to your users so that they can work with Bamboo
- Branch and merge code
- Add shared repositories
- Save costs by shutting down elastic instances
- Configuring a plan's notifications
- Configuring concurrent builds