euca-install-image(1)

1EUCA-INSTALL-IMAGE(1)            User Commands           EUCA-INSTALL-IMAGE(1)
2
3
4

NAME

6       euca-install-image  -  Bundle,  upload  and  register an image into the
7       cloud
8

SYNOPSIS

10       euca-install-image -n NAME [--description DESCRIPTION]
11
12       [--max-pending-parts MAX_PENDING_PARTS]
13              [--virtualization-type {paravirtual,hvm}]  [--platform  windows]
14              [--ec2-url   EC2_URL]   -i   FILE   [-p   PREFIX]  [-d  DIR]  -r
15              {i386,x86_64,armhf,ppc,ppc64,ppc64le}  [-k   FILE]   [-c   FILE]
16              [--ec2cert FILE] [-u ACCOUNT] [--kernel IMAGE] [--ramdisk IMAGE]
17              [--bootstrap-url   BOOTSTRAP_URL]   [-B    VIRTUAL1=DEVICE1,VIR‐
18              TUAL2=DEVICE2,...]        [--productcodes       CODE1,CODE2,...]
19              [--image-size  IMAGE_SIZE]  -b  BUCKET[/PREFIX]   [--acl   {pub‐
20              lic-read,aws-exec-read,ec2-bundle-read}] [--upload-policy POLICY
21              | --upload-policy-file FILE]  [--upload-policy-signature  SIGNA‐
22              TURE]    [--location    LOCATION]    [--retry]   [--progress   |
23              --no-progress]   [--show-empty-fields]   [-U   URL]    [--region
24              USER@REGION]  [-I  KEY_ID]  [-S  KEY]  [--security-token  TOKEN]
25              [--debug] [--debugger] [--version] [-h]
26

DESCRIPTION

28       Bundle, upload and register an image into the cloud
29
30   optional arguments:
31       -n NAME, --name NAME
32              name of the new image (required)
33
34       --description DESCRIPTION
35              description of the new image
36
37       --max-pending-parts MAX_PENDING_PARTS
38              pause the bundling process when more than this number  of  parts
39              are waiting to be uploaded (default: 2)
40
41       --virtualization-type {paravirtual,hvm}
42              virtualization type for the new image
43
44       --platform windows
45              [Privileged] the new image's platform (windows)
46
47       --ec2-url EC2_URL
48              compute service endpoint URL
49
50       -i FILE, --image FILE
51              file containing the image to bundle (required)
52
53       -p PREFIX, --prefix PREFIX
54              the  file  name prefix to give the bundle's files (required when
55              bundling stdin; otherwise defaults to the image's file name)
56
57       -d DIR, --destination DIR
58              location to place the bundle's  files  (default:  dir  named  by
59              TMPDIR,   TEMP,  or  TMP  environment  variables,  or  otherwise
60              /var/tmp)
61
62       -r            {i386,x86_64,armhf,ppc,ppc64,ppc64le},             --arch
63       {i386,x86_64,armhf,ppc,ppc64,ppc64le}
64              the image's architecture (required)
65
66       -k FILE, --privatekey FILE
67              file  containing  your private key to sign the bundle's manifest
68              with. If one is not available the bundle will not be signed.
69
70       -c FILE, --cert FILE
71              file containing your X.509 certificate. If one is not  available
72              it  will  not  be  possible to unbundle the bundle without cloud
73              administrator assistance.
74
75       --ec2cert FILE
76              file containing the cloud's X.509 certificate.  If  one  is  not
77              available  locally  it must be available from the bootstrap ser‐
78              vice.
79
80       -u ACCOUNT, --user ACCOUNT
81              your account ID
82
83       --kernel IMAGE
84              ID of the kernel image to associate with this machine image
85
86       --ramdisk IMAGE
87              ID of the ramdisk image to associate with this machine image
88
89       --bootstrap-url BOOTSTRAP_URL
90              [Eucalyptus only]  bootstrap  service  endpoint  URL  (used  for
91              obtaining --ec2cert automatically
92
93       -B  VIRTUAL1=DEVICE1,VIRTUAL2=DEVICE2,..., --block-device-mappings VIR‐
94       TUAL1=DEVICE1,VIRTUAL2=DEVICE2,...
95              block device mapping scheme with which to  launch  instances  of
96              this machine image
97
98       --productcodes CODE1,CODE2,...
99              comma-separated list of product codes for the image
100
101       --image-size IMAGE_SIZE
102              the image's size (required when bundling stdin)
103
104       -b BUCKET[/PREFIX], --bucket BUCKET[/PREFIX]
105              bucket to upload the bundle to (required)
106
107       --acl {public-read,aws-exec-read,ec2-bundle-read}
108              canned   ACL   policy   to   apply   to   the  bundle  (default:
109              aws-exec-read)
110
111       --upload-policy POLICY
112              upload policy to use for authorization
113
114       --upload-policy-file FILE
115              file containing an upload policy to use for authorization
116
117       --upload-policy-signature SIGNATURE
118              signature for the upload policy (required when an 'upload policy
119              is used)
120
121       --location LOCATION
122              location constraint of the destination bucket (default: inferred
123              from s3-location-constraint in configuration, or otherwise none)
124
125       --retry
126              retry failed uploads up to 5 times
127
128       --progress
129              show progress (the default when run interactively)
130
131       --no-progress
132              do not show progress (the default when run noninteractively)
133
134       --show-empty-fields
135              show empty values as "(nil)"
136
137       -U URL, --url URL
138              object storage service endpoint URL
139
140       --region USER@REGION
141              region and/or user names to search when looking up  config  file
142              data
143
144       -I KEY_ID, --access-key-id KEY_ID
145
146       -S KEY, --secret-key KEY
147
148       --security-token TOKEN
149
150       --debug
151              show debugging output
152
153       --debugger
154              launch interactive debugger on error
155
156       --version
157              show the program's version and exit
158
159       -h, --help
160              show this help message and exit
161
162
163
164euca2ools 3.4                    December 2016           EUCA-INSTALL-IMAGE(1)