euca-install-image (1) - Linux Manuals

euca-install-image: Bundle, upload and register an image into the cloud

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 [at] 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 [at] 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