- unmigrated-wiki-markup
Documentation for Tasks for AWS 2.7 – other releases are available in the Tasks for AWS Documentation Directory.
View
or visit the current documentation home.
Using the Amazon EC2 Image task in Bamboo
You can use the Amazon EC2 Image task to create, delete or backup images (AMIs) of EBS backed Amazon Elastic Compute Cloud (Amazon EC2) instances; in particular, the task provides backup management with retention handling and backup set correlation.
On this page:
Related Pages:
Configuration
To configure an Amazon EC2 Image task:
Navigate to the Tasks configuration tab for the job (this will be the default job if creating a new plan).
Click the name of an existing Amazon EC2 Image task, or click Add Task and then Amazon EC2 Image Task to create a new task.
Complete the following settings:
Common to all tasks
Actions supported by this task:
Create
Instance ID
(Optional) Specify one or more instance IDs (semicolon separated).
Filters
(Optional) Specify resource filters in JSON format. Insert fragments from the inline Examples dialog to get started.
Refer to the --filters specification for describe-instances for details on available filters.
Refer to Listing and Filtering Using the CLI and API for details on filter value syntax.
Don't fail for empty filter result
Check to prevent the task failing if no matching resources are found.
No reboot
If unchecked (default) Amazon EC2 attempts to shut down the instance cleanly before image creation and then reboots the instance. If checked, Amazon EC2 doesn't shut down the instance before creating the image.
When this option is used, file system integrity on the created image can't be guaranteed.
Backup Set
Specify the name of the backup set, which determines retention correlation.
Delete
Instance ID
see Create above
Filters
see Create above
Don't fail for empty filter result
see Create above
Backup Set
see Create above
Backup Retention
Specify the number of backups that should be retained.
Backup
custom action to combine Create and Delete, effectively capping the number of retained backups
Instance ID
see Create above
Filters
see Create above
Don't fail for empty filter result
see Create above
No reboot
see Create above
Backup Set
see Create above
Backup Retention
see Delete above
Variables
Create
Creating image 'ami-afdc01c4' of 'i-a316b842':
... tagging resource 'ami-afdc01c4' with key 'Name' and value 'taws-it-2.0.0.20150716T080402Z' ...
... tagging resource 'ami-afdc01c4' with key 'Backup Policy' and value 'taws-it-200' ...
... images still transitioning (pending: 1) ...
... images transitioned (available: 1).
Task affects 1 resources:
... Id: ami-afdc01c4 | Status: available
Creating common variables for 1 resources affected by task:
... custom.aws.ec2.image.resources: ami-afdc01c4
Creating resource variables for image 'ami-afdc01c4':
... custom.aws.ec2.image.resources.ami-afdc01c4.ImageId: ami-afdc01c4
... custom.aws.ec2.image.resources.ami-afdc01c4.State: available
... custom.aws.ec2.image.resources.ami-afdc01c4.tags: Name;Backup Policy
... custom.aws.ec2.image.resources.ami-afdc01c4.tags.Name: taws-it-2.0.0.20150716T080402Z
... custom.aws.ec2.image.resources.ami-afdc01c4.tags.Backup Policy: taws-it-200
Creating common variables for first resource affected by task:
Creating resource variables for image 'ami-afdc01c4':
... custom.aws.ec2.image.first.ImageId: ami-afdc01c4
... custom.aws.ec2.image.first.State: available
... custom.aws.ec2.image.first.tags: Name;Backup Policy
... custom.aws.ec2.image.first.tags.Name: taws-it-2.0.0.20150716T080402Z
... custom.aws.ec2.image.first.tags.Backup Policy: taws-it-200
Delete
N/A
Backup
See Create above.
How-to Articles
Frequently Asked Questions (FAQ)