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