euca-bundle-image

Bundles an image for use with Eucalyptus or Amazon EC2.

Syntax

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]

Options

Option Description Required
-i,--image Path to the image file to bundle. If a dash ("-") is provided, stdin will be used, and the --prefix and --image-size parameters are required. Yes
-p prefix, --prefix prefix The file name prefix to give the bundle image files. Required when bundling stdin; otherwise defaults to the image's file name. Conditional
-d directory, --destination directory Directory where the bundle image files go. Eucalyptus recommends that you include this option where allowed. This is the directory specified by TMPDIR, TEMP, or TMP environment variables.

Default: /var/tmp

No
-r architecture, --arch architecture Target architecture for the image.

Default: x86_64

Valid values: i386 | x86_64 | armhf | ppc | ppc64

Yes
-u account,--user account 12-digit account ID of the person who is bundling the image. No
-c file, --cert file File containing your X.509 certificate. No
--ec2cert file File containing your cloud's X.509 certificate. No
-k file, --privatekey file File containing your private key to sign the bundle's manifest with. This private key will also be required to unbundle the image in the future. 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 runtime.

If you are bundling a kernel image, set to true.

No
--ramdisk ID of the ramdisk to be associated with the image. You can override this ID in euca-register and euca-run-instances at runtime.

If you are bundling a ramdisk image, set to true.

No
-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
--batch Run in batch mode. This is for compatibility only, and has no effect. No
-\-productcodescode1 [, code2, ...] Comma-delimited list of product codes. No
--image-size size The size of the image. Required when reading from stdin. Conditional
--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

Common Options

Option Description
--show-empty-fields Show empty fields as "(nil)".
--region user@region Region and/or user name to search when looking up config file data. Only valid for EC2 endpoints.
-U,--url url URL of the cloud service to connect to. For administrative commands, this should be <ip_address>:8773/services/Empyrean.
-I,--access-key-id key_id User's access key ID.
-S,--secret-key secret_key User's secret key.
--security-token token User's security token.
--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.

Output

Example

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.

x