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