1EUCA-BUNDLE-AND-UPLOAD-IMAGE(1)  User Commands EUCA-BUNDLE-AND-UPLOAD-IMAGE(1)
2
3
4

NAME

6       euca-bundle-and-upload-image  -  Prepare and upload an image for use in
7       the cloud
8

SYNOPSIS

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

DESCRIPTION

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