Jump to: navigation, search

Difference between revisions of "Glance-new-download-workflow"

(Created page with "This is the full specification for blueprint:https://blueprints.launchpad.net/glance/+spec/new-download-workflow")
 
Line 1: Line 1:
 
This is the full specification for blueprint:https://blueprints.launchpad.net/glance/+spec/new-download-workflow
 
This is the full specification for blueprint:https://blueprints.launchpad.net/glance/+spec/new-download-workflow
 +
 +
== Motivation ==
 +
Here's why we want an alternative to the "normal" Glance download workflow:
 +
* want to allow a cloud provider the opportunity to "scrub" or otherwise process an image that's going to be pulled out of that provider's cloud
 +
** they don't have to, but want to make the option available
 +
* want to push all efforts associated with getting images out of the cloud to the cloud periphery so the bandwidth/compute required doesn't affect normal cloud functionality
 +
 +
 +
We propose calling this functionality "export" (to keep symmetry with the proposed new "import" functionality <ref>https://wiki.openstack.org/wiki/Glance-new-upload-workflow</ref>)
 +
 +
== Example  Workflow (API View) ==
 +
 +
=== Initial Export Request ===
 +
<pre>
 +
Request 1: POST /v2/images//export
 +
{ "some-stuff" : "whatever" }
 +
</pre>
 +
<pre>
 +
Response 1: 201 created
 +
Location: "http://glance-server/v2/image-exports/12345678-1234-1234-1234-123456789abc"
 +
</pre>
 +
<pre>
 +
Request 2 - N: GET /v2/image-exports/12345678-1234-1234-1234-123456789abc
 +
</pre>
 +
<pre>
 +
Response 2 - N-1: 200 OK
 +
{ "status" : "waiting", "image_uuid" : }
 +
</pre>
 +
<pre>
 +
Response N:
 +
</pre>
 +
<pre>
 +
</pre>
 +
 +
 +
== References ==
 +
<references />

Revision as of 18:43, 21 May 2013

This is the full specification for blueprint:https://blueprints.launchpad.net/glance/+spec/new-download-workflow

Motivation

Here's why we want an alternative to the "normal" Glance download workflow:

  • want to allow a cloud provider the opportunity to "scrub" or otherwise process an image that's going to be pulled out of that provider's cloud
    • they don't have to, but want to make the option available
  • want to push all efforts associated with getting images out of the cloud to the cloud periphery so the bandwidth/compute required doesn't affect normal cloud functionality


We propose calling this functionality "export" (to keep symmetry with the proposed new "import" functionality [1])

Example Workflow (API View)

Initial Export Request

Request 1: POST /v2/images//export
{ "some-stuff" : "whatever" }
Response 1: 201 created
Location: "http://glance-server/v2/image-exports/12345678-1234-1234-1234-123456789abc"
Request 2 - N: GET /v2/image-exports/12345678-1234-1234-1234-123456789abc
Response 2 - N-1: 200 OK
{ "status" : "waiting", "image_uuid" : }
Response N:


References

  1. https://wiki.openstack.org/wiki/Glance-new-upload-workflow