Euca2ools Guide / EC2-Compatible Commands |
Prepares and uploads an image for use in the Eucalyptus cloud.
euca-bundle-and-upload-image -i filename [--preserve-bundle] [--max-pending-parts max_pending_parts] [-p prefix] [-d DIR] [-k filename] -r {i386,x86_64,armhf,ppc,ppc64} [-c filename] [--ec2cert filename] [-u account] [--kernel image] [--ramdisk image] [--block-device-mapping virtual1=device1,[virtual2=device2,...] [--productcodes code1,code2,...] [--image-size image_size] -b bucketname[/PREFIX] [--acl {public-read,aws-exec-read,ec2-bundle-read}] [--upload-policy policyname | --upload-policy-file filename] [--upload-policy-signature signature] [--location location] [--retry] [--progress | --no-progress] [-U URL] [--region user@region] [-I key_ID] [-S key] [--security-token token] [--debug] [--debugger] [--version] [-h]
Option | Description | Required |
---|---|---|
-i,--image | Path to the image file to prepare. | Yes |
-r,--arch | Architecture of the image to bundle. Valid values: i386,x86_64,armhf,ppc,ppc64 |
Yes |
-b bucket[/prefix] | Bucket to upload the bundle to. | Yes |
-u,--user | 12-digit account ID of the person who is bundling the image. | No |
-c file, --cert file | File containing your 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 |
-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 |
--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 |
-d, --destination | Directory to store bundle files. Defaults to the TMPDIR, TEMP, or TMP environment variables; if those are not present, defaults to /var/tmp. | No |
--ec2cert file | File containing your 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 |
--acl | Pre-defined ACL policy to apply to the bundle. Valid values: public-read,aws-exec-read,ec2-bundle-read Default value: aws-exec-read |
No |
--upload-policy | S3 post policy to use for upload authorization, in JSON format. | No |
--upload-policy-file | Filename of the file containing the S3 post policy file to use for upload authorization. | No |
--upload-policy-signature | Signature for the S3 post policy. This parameter is required if --upload-policy-file or --upload-policy are specified. | 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. |