euca-bundle-and-upload-image man page

euca-bundle-and-upload-image — Prepare and upload an image for use in the cloud

Synopsis

euca-bundle-and-upload-image [--preserve-bundle]

[--max-pending-parts MAX_PENDING_PARTS] -i
FILE [-p PREFIX] [-d DIR] -r {i386,x86_64,armhf,ppc,ppc64} [-k FILE] [-c FILE] [--ec2cert FILE] [-u ACCOUNT] [--kernel IMAGE] [--ramdisk IMAGE] [--bootstrap-url BOOTSTRAP_URL] [-B VIRTUAL1=DEVICE1,VIRTUAL2=DEVICE2,...] [--productcodes CODE1,CODE2,...] [--image-size IMAGE_SIZE] -b BUCKET[/PREFIX] [--acl {public-read,aws-exec-read,ec2-bundle-read}] [--upload-policy POLICY | --upload-policy-file FILE] [--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]

Description

Prepare and upload an image for use in the cloud

optional arguments

--preserve-bundle
do not delete the bundle as it is being uploaded
--max-pending-parts MAX_PENDING_PARTS
pause the bundling process when more than this number of parts are waiting to be uploaded (default: 2)
-i FILE, --image FILE
file containing the image to bundle (required)
-p PREFIX, --prefix PREFIX
the file name prefix to give the bundle's files (required when bundling stdin; otherwise defaults to the image's file name)
-d DIR, --destination DIR
location to place the bundle's files (default: dir named by TMPDIR, TEMP, or TMP environment variables, or otherwise /var/tmp)
-r {i386,x86_64,armhf,ppc,ppc64}, --arch {i386,x86_64,armhf,ppc,ppc64}
the image's architecture (required)
-k FILE, --privatekey FILE
file containing your private key to sign the bundle's manifest with. If one is not available the bundle will not be signed.
-c FILE, --cert FILE
file containing your X.509 certificate. If one is not available it will not be possible to unbundle the bundle without cloud administrator assistance.
--ec2cert FILE
file containing the cloud's X.509 certificate. If one is not available locally it must be available from the bootstrap service.
-u ACCOUNT, --user ACCOUNT
your account ID
--kernel IMAGE
ID of the kernel image to associate with this machine image
--ramdisk IMAGE
ID of the ramdisk image to associate with this machine image
--bootstrap-url BOOTSTRAP_URL
[Eucalyptus only] bootstrap service endpoint URL (used for obtaining --ec2cert automatically
-B VIRTUAL1=DEVICE1,VIRTUAL2=DEVICE2,..., --block-device-mappings VIRTUAL1=DEVICE1,VIRTUAL2=DEVICE2,...
block device mapping scheme with which to launch instances of this machine image
--productcodes CODE1,CODE2,...
comma-separated list of product codes for the image
--image-size IMAGE_SIZE
the image's size (required when bundling stdin)
-b BUCKET[/PREFIX], --bucket BUCKET[/PREFIX]
bucket to upload the bundle to (required)
--acl {public-read,aws-exec-read,ec2-bundle-read}
canned ACL policy to apply to the bundle (default: aws-exec-read)
--upload-policy POLICY
upload policy to use for authorization
--upload-policy-file FILE
file containing an upload policy to use for authorization
--upload-policy-signature SIGNATURE
signature for the upload policy (required when an 'upload policy is used)
--location LOCATION
location constraint of the destination bucket (default: inferred from s3-location-constraint in configuration, or otherwise none)
--retry
retry failed uploads up to 5 times
--progress
show progress (the default when run interactively)
--no-progress
do not show progress (the default when run noninteractively)
-U URL, --url URL
object storage service endpoint URL
--region USER@REGION
region and/or user names to search when looking up config file data

-I KEY_ID, --access-key-id KEY_ID

-S KEY, --secret-key KEY

--security-token TOKEN

--debug
show debugging output
--debugger
launch interactive debugger on error
--version
show the program's version and exit
-h, --help
show this help message and exit

Referenced By

euca2ools(7), euca2ools.ini(5).

October 2015 euca2ools 3.3.0 User Commands