ec2-bundle-vol

-k, --privatekey private_key

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

Example: -k pk-HKZYKTAIG2ECMXYIBH3HXV4ZBEXAMPLE.pem

Yes

-u, --user user_id

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

Example: -u 111122223333

Yes

-c, --cert cert

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

Example: -c cert-HKZYKTAIG2ECMXYIBH3HXV4ZBEXAMPLE.pem

Yes

-r, --arch architecture

Image architecture. If you don't provide this on the command line, you'll be prompted to provide it when the bundling starts.

Valid Values: i386 | x86_64

Example: -r x86_64

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 and files to exclude from the bundle operation. This parameter overrides the --all option. When exclude is specified, the directories and subdirectories listed with the parameter will not be bundled with the volume.

Example: Assuming the mount point of the volume is -v /foo, and you want to exclude directories /foo/bar and /foo/baz, specify -e /bar,/baz.

No

-i, --include file_1,file_2,...

A list of files to include in the bundle operation. This option overrides the exclusion of files that are by default filtered out because they might contain sensitive information.

Use this option to explicitly include a file that might contain sensitive data — i.e., '*.sw', '*.swo', '*.swp', '*.pem', '*.priv', '*.gpg', '*.jks', '*/.ssh/authorized_keys', '*/.bash_history'. The files listed with the parameter will be bundled with the volume.

Example: Assuming the mount point of the volume is -v /mnt/myvol/ and you want to include file /mnt/myvol/foo/bar.pem, specify -i /foo/bar.pem.

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 cert_path

The path to the Amazon EC2 X.509 public key certificate.

Default: /etc/ec2/amitools/cert-ec2.pem (varies, depending on tools)

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

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: --generate-fstab

No

--kernel kernel_id

The ID of the kernel to select.

Example: --kernel 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: --ramdisk ari-badbad00

No

--block-device-mapping mappings

Default block-device-mapping scheme with which to launch the AMI. This defines how block devices are exposed to an instance of this AMI if the instance type supports the specified device.

The scheme is a comma-separated list of key=value pairs, where each key is a virtual name and each value is the desired device name. Virtual names include:

Example: --block-device-mapping ami=sda1,root=/dev/sda1,ephemeral0=sda2,swap=sda3

Example: --block-device-mapping ami=0,root=/dev/dsk/c0d0s0,ephemeral0=1

No

--[no-]inherit

Whether the image should inherit the instance's metadata (the default is to inherit). Bundling will fail if you enable inherit but the instance metadata is not accessible.

Example: --inherit

No

--productcodes product_code

Product code to attach to the image at registration time.

Example: --productcodes 1234abcd

No