Register an AMI

Objective

Table of Contents

1. Objective
2. Overview
3. Steps
1. 3.1. Upload your AWS key and certificate
2. 3.2. Bundle the Instance
3. 3.3. Upload AMI to an S3 Bucket
4. 3.4. Register the AMI

Overview

Images must be registered before they can be launched in EC2. Note that Servers launched directly from images cannot be added to Deployments in your Dashboard. See the Help Text in the RightScale Dashboard for a more comprehensive discussion about image types.

Steps

Upload your AWS key and certificate

The first step is to upload your key and certificate to the running instance on /mnt.

Bundle the Instance

SSH into the instance and perform the following commands. Replace "rightscale_ami" with your own information.

# ec2-bundle-vol -d /mnt -k /mnt/pk-XXX.pem -c /mnt/cert-YYY.pem -u 123456789012 -r i386 -p 
rightscale_ami Copying / into the image file /mnt/rightscale_ami...
[...]
Created demo.rightscale.part.89
Generating digests for each part...
Digests generated.
Creating bundle manifest...
ec2-bundle-vol complete.

Upload AMI to an S3 Bucket

# ec2-upload-bundle -b rightscale_ami -m /mnt/rightscale_ami.manifest.xml -a MYACCESSKEY -s MYSECRETKEY
Uploading bundled image parts to https://s3.amazonaws.com:443/rightscale_ami ...
Uploaded demo.rightscale.part.00 to https://s3.amazonaws.com:443/rightscale_ami/demo.rightscale.part.00.
[...]
Uploading manifest ...
Uploaded manifest to https://s3.amazonaws.com:443/rightscale_ami/demo.rightscale.manifest.xml.
Bundle upload completed.

Register the AMI

# ec2-register -C /mnt/cert-XXX -K /mnt/pk-XXX -U " https://ec2.amazonaws.com" rightscale_ami/demo.rightscale.manifest.xml
IMAGE   ami-77f81c1e

Support