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
|
.. This work is licensed under a Creative Commons Attribution 4.0 International License.
.. http://creativecommons.org/licenses/by/4.0
.. Copyright (c) 2017-2018 VMware, Inc.
=================
Image Service
=================
Because Multicloud provides a cloud mediation layer supporting multiple clouds. It's necessary to
introduces some function enhancements in it. Image Service could let user upload/download images
in a convinient way just by using Multicloud.
Problem Description
===================
The original functions which Multicloud possesses are to use urls to upload images, while in this
spec we intend to upload images as raw file which means it has to store a copy in Multicloud then
upload the images to the backend openstack. So this spec is to extend multicloud to support
download/upload images as raw file rather than a through a url
Use Cases
===================
One typical use case is to allow users to upload/download images by Multicloud
Proposed change
===================
The proposed change mainly means introducing glance python APIs to enable multicloud support openstack
image service. This feature needs two changes: Upload API to import an image to backend OpenStack
and the image that just imported can be queried from MultiCloud. Download API to download an image
from backend Openstack and the image can be downloaded from MultiCloud.
The eventual work flow looks like as follows:
user request to upload image
|
V
+------------------+
| |
| image file(iso, |
| vmdk... ) |
| |
+---------+--------+
|
|
|
+-----------|----------+
| multicloud| |
| V |
| +------------------+ |
| | image service API| |
| +---------+--------+ |
+-----------|----------+
| glance
|
V
+----------------------+
| openstack |
+----------------------+
The APIs look like this:
upload:
Input of /{vimid}/{tenantid}/images/file will be
::
required: image file
{
"imageType": string, // image type: ami, ari, aki, vhd, vhdx, vmdk, raw, qcow2, vdi, iso
"containerFormat": string, // image container format: ami, ari, aki, bare, ovf, ova, docker
"visibility": string, // public, private, shared, or community
"properties": arrary // list of properties
}
Output of upload_image will be
::
"responses": {
"201": {
"description": "upload successfully",
},
"404": {
"description": "the vim id or tenant UUID is wrong"
},
"500": {
"description": "the vim image is not accessable"
}
download:
Input of /{vimid}/{tenantid}/images/file/{imageid} will be
::
{
"imagepath": string, // the path of the downloaded image
"properties": arrary // list of properties
}
Output of download_image will be
::
"responses": {
"200": {
"description": "download successfully",
},
"404": {
"description": "the vim id or tenant UUID is wrong"
},
"500": {
"description": "the vim image is not accessable"
}
|