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]
Creates a bundled AMI by compressing, encrypting and signing a snapshot of the local machine's root file system.
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 ephemeral 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. |
Note | |
---|---|
This tool does not support the Common Options |
Option | Description | Required | |
---|---|---|---|
|
The path to the user's PEM-encoded RSA key file. Example: |
Yes |
|
|
The user's PEM encoded RSA public key certificate file. Example: |
Yes |
|
|
The user's AWS account number without dashes. Do not use the Access Key ID. Example: |
Yes |
|
|
Specifies 32-bit (m1.small) or 64-bit architecture (m1-large and m1-xlarge). Example: |
Yes |
|
|
The size, in MB (1024 * 1024 bytes), of the image file to create. The maximum size is 10240 MB. Default: 10240 Example: |
No |
|
|
The directory in which to create the bundle. Default: Example: |
No |
|
|
A list of absolute directory paths to exclude from the
bundle operation. This overrides the Example: |
No |
|
|
The filename prefix for bundled AMI files. Default: Example: |
No |
|
|
The absolute path to the mounted volume from which to create the bundle. Default: The root directory (/) Example: |
No |
|
|
Bundle all directories, including those on remotely mounted filesystems. Example: |
No |
|
|
The path to the Amazon EC2 X509 public key certificate. Default: Example: |
No |
|
|
Display the help message. Example: |
No |
|
|
Display the manual entry. Example: |
No |
|
|
The path to the fstab to bundle into the image. If this is not specified, Amazon EC2 bundles /etc/fstab. Example: |
No |
|
|
Causes Amazon EC2 to bundle the volume using an Amazon EC2-provided fstab. Example: |
No |
|
|
Runs without interaction and suppresses all warnings. Will attempt to automatically determine architecture. Example: |
No |
|
|
The ID of the kernel to select. For information on finding available kernel IDs, see ec2-describe-images. Example: |
No |
|
|
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: |
No |
|
|
Specifies how block devices are exposed. . Virtual name example: Device name example: |
No |
Status messages describing the stages and status of the bundling
This example creates a bundled AMI by compressing, encrypting and signing a snapshot of the local machine's root file system.
$
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.