...
width | 64% |
---|
...
...
...
...
Available Tasks
...
AWS CloudFormation
...
Panel |
---|
AWS CloudFormation Stack |
...
Create, update or delete |
...
CloudFormation |
...
stacks defined by a template provided via URL or inline and specify template parameters and advanced options. See Using the AWS CloudFormation Stack task in Bamboo for details. |
...
Amazon EC2 Instance
This Task enables you to start, stop or reboot provisioned Elastic Compute Cloud instances on demand, e.g. only when needed by the build itself (development) or at specific times of the day (operations).
Amazon EC2 Image
...
AWS CodeDeploy
Panel |
---|
AWS CodeDeploy ApplicationCreate, update or delete CodeDeploy applications on demand. See Using the AWS CodeDeploy Application task in Bamboo for details. |
Panel |
---|
AWS CodeDeploy Deployment GroupCreate, update or delete CodeDeploy deployment groups on demand. See Using the AWS CodeDeploy Deployment Group task in Bamboo for details. |
Panel |
---|
AWS CodeDeploy DeploymentCreate, update or delete CodeDeploy deployments on demand. See Using the AWS CodeDeploy Deployment task in Bamboo for details. |
AWS Elastic Beanstalk
Panel |
---|
AWS Elastic Beanstalk ApplicationCreate, update or delete Elastic Beanstalk applications on demand. See Using the AWS Elastic Beanstalk Application task in Bamboo for details. |
Panel |
---|
AWS Elastic Beanstalk Application VersionCreate, update or delete Elastic Beanstalk application versions on demand. See Using the AWS Elastic Beanstalk Application Version task in Bamboo for details. |
Panel |
---|
AWS Elastic Beanstalk EnvironmentCreate, update, rebuild, restart, swap or terminate Elastic Beanstalk environments on demand. See Using the AWS Elastic Beanstalk Environment task in Bamboo for details. |
Amazon EC2
Panel |
---|
Amazon EBS SnapshotCreate, delete or backup snapshots of Elastic Block Store volumes; in particular, the Task provides backup management with retention handling and backup set correlation. |
...
task in Bamboo for details. |
Panel |
---|
Amazon EC2 ImageCreate, delete or backup |
...
images of |
...
EBS backed Elastic Compute Cloud instances; in particular, the Task provides backup management with retention handling and backup set correlation. |
...
See Using the Amazon EC2 Image task in Bamboo for details. |
Panel |
---|
Amazon EC2 InstanceStart, stop or reboot provisioned Elastic Compute Cloud instances on demand, e.g. only when needed by the build itself (development) or at specific times of the day (operations). See Using the Amazon EC2 Instance task in Bamboo for details. |
Amazon S3
Panel |
---|
Amazon S3 Object |
...
Upload, download, delete or copy Structured Storage Service objects (files); in particular you can upload your Bamboo job's build artifacts or select local files and directories (optionally via Ant Patterns) - when addressing S3 objects (files), it matches those by key prefix, which allows to operate on multiple objects at once (virtual directories resp. folder hierarchies). |
...
See Using the Amazon S3 Object task in Bamboo for details. |
Bamboo Variable Substitution/Definition
Info |
---|
To empower advanced build and automation scenarios, it his highly recommended to become acquainted with Using Global, Plan or Build-specific Variables. . |
All Tasks support Bamboo variables, both substituting them within parameters for AWS resource management and defining them from created AWS resources.
Variable Substitution
Variables are substituted in all Task configuration text fields (e.g. Stack Name, Template URL, Instance ID, Volume ID etc.).
Please note the following feature:
- if the variable key contains the phrase "password", the value will be masked with "********" in the build logs; e.g. if the key is "password", "awsAccessKeyPassword" or "awsSecretKeyPassword" the build log will show the substituted value as "********"
Variable Definition
Variables are defined by all Tasks for reuse in subsequent Tasks as follows:
- variables have a dedicated prefix like
bamboo.custom.aws.*
, with*
being a task specific prefix, e.g.bamboo.custom.aws.cfn.stack
- variables refering to a collection of resources provide their ids in a semicolon separated list (i.e. the same format available on input), e.g.
${bamboo.custom.aws.ec2.image.resources}
with valuesami-985b21f1;ami-9a5b21f3
- you can refer to these variables from subsequent tasks via something like
${bamboo.custom.aws.cfn.stack.sampleStackOutputKey}
- these variables are also available as environment variables in the Script Task for example, albeit named slightly different, e.g.
$bamboo_custom_aws_cfn_stack_StringWithRegex
(Unix) or%bamboo_custom_aws_cfn_stack_StringWithRegex%
(Windows)
Please note the following constraints:
- variables are only reusable in subsequent tasks and not in other jobs/stages due to the implied concurrency, see the following discussion and workaround
Available variables per Task are as follows:
- AWS CloudFormation Stack
- the collection of affected stack resources, e.g.
bamboo.custom.aws.cfn.stack.resources=i-3280997f;vol-e1debbcd;test-stack-SecurityGroup-KZWPADIUPCL6
- the status of each affected stack resource, e.g.
bamboo.custom.aws.cfn.stack.i-3280997f=CREATE_COMPLETE
- the collection of generated stack outputs, e.g.
bamboo.custom.aws.cfn.stack.outputs=sampleStackOutputKey;StringWithRegex;...
- the value of each generated stack output, e.g.
bamboo.custom.aws.cfn.stack.StringWithRegex=Hello
- Note: The variables with legacy naming without prefix remain available for compatibility (e.g.
bamboo.StringWithRegex=Hello
)
- Note: The variables with legacy naming without prefix remain available for compatibility (e.g.
- the collection of affected stack resources, e.g.
- AWS EC2 Instance
- the collection of affected instances, e.g.
bamboo.custom.aws.ec2.instance.resources=i-fa7b4596;i-080eec64
- the status of each affected instance, e.g.
bamboo.custom.aws.ec2.instance.i-fa7b4596=started
- the collection of affected instances, e.g.
- AWS EC2 Image
- the collection of affected images, e.g.
bamboo.custom.aws.ec2.image.resources=ami-985b21f1;ami-9a5b21f3
- the status of each affected instance, e.g.
bamboo.custom.aws.ec2.image.ami-985b21f1=available
- the collection of affected images, e.g.
- AWS EBS Snapshots
- the collection of affected snapshots, e.g.
bamboo.custom.aws.ec2.snapshots.resources=snap-f4dc35a1
- the status of each affected snapshots, e.g.
bamboo.custom.aws.ec2.snapshots.snap-f4dc35a1=completed
- the collection of affected snapshots, e.g.
AWS Credentials
The AWS credentials need to be specified for each task currently, which can be cumbersome quickly. Pending a more generic solution, it is already possible to ease this a bit via variable substitution as follows:
...
See Bamboo Variable Substitution/Definition for details.
AWS Configuration
AWS Security Credentials
See AWS Security Credentials for details.
AWS Client Configuration
See AWS Client Configuration for details
...
Limitations
You should be aware of the following limitations regarding AWS API coverage and integration:
AWS CloudFormation
...
.
...
- A stack rolled back successfully by CloudFormation is treated as a failed build by Bamboo.
- A stack not rolled back due to rollback being disabled explicitly is still treated as a failed build by Bamboo.
Amazon Elastic Compute Cloud (EC2)
- We currently consider instance lifecycle goals (i.e. create/terminate) to be sufficiently addressed by the CloudFormation Task, hopefully covering the majority of use cases (please let us know otherwise).
...