ec2-bundle-vol

Amazon Elastic Compute Cloud: 2008-08-08

previous page next page

ec2-bundle-vol

Syntax

ec2-bundle-vol -k private_key -u user_id -c ec2_cert -r {i386 | x86_64} [-s size] [-d destination] [-e exclude_directory_1,exclude_directory_1,...] [-p ami_prefix] [-v volume] [--ec2cert ami_path] [--fstab fstab_path] [--generate-fstab] [--kernel kernel-id] [--ramdisk ramdisk_id] [--block-device-mappingblock_device_mapping] [-b, --batch]

Description

Creates a bundled AMI by compressing, encrypting and signing a snapshot of the local machine's root file system.

[Note]Note

Scripts that require a copy of the public key from the launch key pair must obtain the key from the instance's metadata (not the key file in the instance store) for instances bundled with the 2007-08-29 AMI tools and later. AMIs bundled before this release will continue to work normally.

On a running instance, Amazon EC2 attempts to inherit product codes, kernel settings, RAM disk settings, and block device mappings with which the instance launched.

Options

[Note]Note

This tool does not support the

Common Options
Option Description Required

-k, --privatekey private_key

The path to the user's PEM-encoded RSA key file.

Example: -k pk-HKZYKTAIG2ECMXYIBH3HXV4ZBZQ55CLO.pem

Yes

-c, --cert ec2_cert

The user's PEM encoded RSA public key certificate file.

Example: -c cert-HKZYKTAIG2ECMXYIBH3HXV4ZBZQ55CLO.pem

Yes

-u, --user user_id

The user's AWS account number without dashes. Do not use the Access Key ID.

Example: -u 495219933132

Yes

-r, --arch {i386 | x86_64}

Specifies 32-bit (m1.small) or 64-bit architecture (m1-large and m1-xlarge).

Example: -r i386

Yes

-s, --size size

The size, in MB (1024 * 1024 bytes), of the image file to create. The maximum size is 10240 MB.

Default: 10240

Example: -s 2048

No

-d, --destination destination

The directory in which to create the bundle.

Default: /tmp

Example: -d /var/run/my-bundle

No

-e, --exclude directory_1,directory_2,...

A list of absolute directory paths to exclude from the bundle operation. This overrides the --all parameter.

Example: -e /tmp,/home/secret-data

No

-p, --prefix ami_prefix

The filename prefix for bundled AMI files.

Default: image

Example: -p my-image-is-special

No

-v, --volume volume

The absolute path to the mounted volume from which to create the bundle.

Default: The root directory (/)

Example: -v /mnt/my-customized-ami

No

-a, --all

Bundle all directories, including those on remotely mounted filesystems.

Example: -a

No

--ec2cert ami_path

The path to the Amazon EC2 X509 public key certificate.

Default: /etc/ec2/amiutil/cert-ec2.pem

Example: --ec2cert /etc/ec2/amiutil/cert-ec2.pem

No

--help

Display the help message.

Example: --help

No

--manual

Display the manual entry.

Example: --manual

No

--fstab fstab_path

The path to the fstab to bundle into the image. If this is not specified, Amazon EC2 bundles /etc/fstab.

Example: --fstab /etc/fstab

No

--generate-fstab

Causes Amazon EC2 to bundle the volume using an Amazon EC2-provided fstab.

Example: --fstab /etc/fstab

No

-b, --batch

Runs without interaction and suppresses all warnings. Will attempt to automatically determine architecture.

Example: -b

No

--kernel kernel_id

The ID of the kernel to select. For information on finding available kernel IDs, see ec2-describe-images.

Example: aki-ba3adfd3

No

--ramdisk ramdisk_id

The ID of the RAM disk to select.

Some kernels require additional drivers at launch. Check the kernel requirements for information on whether you need to specify a RAM disk. To find the kernel requirements, go to the Resource Center and search for the kernel ID.

Example: ari-badbad00

No

--block-device-mappings mappings

Specifies how block devices are exposed. .

Virtual name example: instancestore0

Device name example: sdb

No

Output

Status messages describing the stages and status of the bundling

Example

This example creates a bundled AMI by compressing, encrypting and signing a snapshot of the local machine's root file system. 

PROMPT> ec2-bundle-vol -d /mnt -k pk-HKZYKTAIG2ECMXYIBH3HXV4ZBZQ55CLO.pem -c cert-HKZYKTAIG2ECMXYIBH3HXV4ZBZQ55CLO.pem -u 495219933132 -r x86_64
Copying / into the image file /mnt/image.img...
Excluding:
     sys
     dev/shm
     proc
     dev/pts
     proc/sys/fs/binfmt_misc
     dev
     media
     mnt
     proc
     sys
     tmp/image.img
     mnt/img-mnt
1+0 records in
1+0 records out
mke2fs 1.38 (30-Jun-2005)
warning: 256 blocks unused.

Splitting /mnt/image.gz.crypt...
Created image.part.00
Created image.part.01
Created image.part.02
Created image.part.03
...
Created image.part.22
Created image.part.23
Generating digests for each part...
Digests generated.
Creating bundle manifest...
Bundle Volume complete.

Related Topics

previous page start next page