euca-install-image (1)
NAME
euca-install-image - Bundle, upload and register an image into the cloud
SYNOPSIS
euca-install-image
-n NAME [--description DESCRIPTION]
- [--max-pending-parts MAX_PENDING_PARTS]
-
[--virtualization-type {paravirtual,hvm}]
[--platform windows] [--ec2-url EC2_URL] -i FILE
[-p PREFIX] [-d DIR] -r
{i386,x86_64,armhf,ppc,ppc64,ppc64le} [-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] [--show-empty-fields]
[-U URL] [--region USER@REGION] [-I KEY_ID] [-S KEY]
[--security-token TOKEN] [--debug] [--debugger]
[--version] [-h]
DESCRIPTION
Bundle, upload and register an image into the cloud
optional arguments:
- -n NAME, --name NAME
-
name of the new image (required)
- --description DESCRIPTION
-
description of the new image
- --max-pending-parts MAX_PENDING_PARTS
-
pause the bundling process when more than this number
of parts are waiting to be uploaded (default: 2)
- --virtualization-type {paravirtual,hvm}
-
virtualization type for the new image
- --platform windows
-
[Privileged] the new image's platform (windows)
- --ec2-url EC2_URL
-
compute service endpoint URL
- -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,ppc64le}, --arch {i386,x86_64,armhf,ppc,ppc64,ppc64le}
-
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)
- --show-empty-fields
-
show empty values as "(nil)"
- -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