|Euca2ools Guide / EC2-Compatible Commands|
Bundles an image for use with Eucalyptus or Amazon EC2.
euca-bundle-image -i image_path -r [i386,x86_64,armhf] [-u, --user account-id] [-p, --prefix prefix][--kernel kernel_id] [--ramdisk ramdisk_id] [--product-codes product_codes] [-b, --block-device-mapping mapping] [-d, --destination destination] [--ec2cert ec2cert_path ][--batch]
|-i,--image||Path to the image file to bundle.||Yes|
|-r,--arch||Architecture of the image to bundle.||Yes|
|-u,--user||12-digit account ID of the person who is bundling the image.||No|
|-c,--cert||Path to the user's PEM-encoded certificate.||No|
|-k,--privatekey||Path to user's PEM-encoded private key.||No|
|-p,--prefix||The prefix for the bundle image files.||No|
|--kernel||ID of the kernel you want to associate with
the image. You can override this ID in euca-register and euca-run-instances at
If you are bundling a kernel image, set to true.
|--ramdisk||ID of the ramdisk to be associated with the
image. You can override this ID in euca-register and euca-run-instances at
If you are bundling a ramdisk image, set to true.
|-b,--block-device-mapping||Default block device mapping for the image. The format of the mapping is a comma-separated list of key=value pairs.||No|
|-d,--destination||Directory to store the bundled image in. We
recommend that you include this option where
|--ec2cert||Path to the cloud's X.509 certificate.||No|
|--batch||Run in batch mode. This is for compatibility only, and has no effect.||No|
|--productcodescode1 [, code2, ...]||Comma-delimited list of product codes.||No|
|--progress||Show a progress bar during command execution. This is the default when this command is run interactively.||No|
|--no-progress||Do not show a progress bar during command execution. This is the default when this command is run non-interactively.||No|
|--region region||Region to direct requests to. Only valid for EC2 endpoints.|
|-U,--url url||URL of the cloud to connect to. Expects an EC2 endpoint /services/Eucalyptus.|
|-I,--access-key-id access_key_id||User's access key ID|
|-S,--secret-key secret_key||User's secret key|
|--config configuration_path||Read credentials and cloud settings from the
specified config file.
Default: $HOME/.eucarc or /etc/euca2ools/eucarc.
|--debug||Prints what the command sends to the server and what it receives from the server. Use when you're trying to debug Euca2ools.|
|--debugger||Enable interactive debugger on error|
|-h,--help||Display the manual page for the command.|
|--version||Display the version of this tool|
This command displays a progress bar while the image file is uploaded. For example:
[root@c-31 ~]# euca-bundle-image --arch i386 -i test.img 37% |============= | 3.75 GB 151.70 MB/s ETA: 0:00:44
This is followed by output that looks similar to the following example:
100% |=====================================| 10.00 GB 151.06 MB/s Time: 0:01:11 Wrote /var/tmp/bundle-cUuznJ/test.img.part.0 Wrote manifest /var/tmp/bundle-cUuznJ/test.img.manifest.xml
Once the initial upload is complete, you can use euca-describe-bundle-tasks to check on pending bundle tasks.