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]
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 |
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. |
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.