diff --git a/doc/admin-guide-cloud/compute/section_compute-images-instances.xml b/doc/admin-guide-cloud/compute/section_compute-images-instances.xml index fa25de3111..26c345aafb 100644 --- a/doc/admin-guide-cloud/compute/section_compute-images-instances.xml +++ b/doc/admin-guide-cloud/compute/section_compute-images-instances.xml @@ -99,6 +99,7 @@ +
diff --git a/doc/admin-guide-cloud/image/section_glance-nova-image-download.xml b/doc/admin-guide-cloud/image/section_glance-nova-image-download.xml new file mode 100644 index 0000000000..81201ef1b6 --- /dev/null +++ b/doc/admin-guide-cloud/image/section_glance-nova-image-download.xml @@ -0,0 +1,46 @@ + + +%openstack; +]> +
+ Image download: how it works + + Prior to starting a virtual machine, the virtual machine image + used must be transferred to the compute node from the Image + Service. How this works can change depending on the settings + chosen for the compute node and the Image Service. + + + Typically, the Compute service will use the image identifier + passed to it by the scheduler service and request the image from the + Image API. Though images are not stored in glance—rather in a + back end, which could be Object Storage, a filesystem or any other + supported method—the connection is made from the compute node + to the Image Service and the image is transferred over this + connection. The Image Service streams the image from the back end to the + compute node. + + + Certain back ends support a more direct method, where on request + the Image Service will return a URL that can be used to + download the image directly from the back-end store. Currently the + only store to support the direct download approach is the + filesystem store. It can be configured using the + option in the + image_file_url section of the + nova.conf file on compute nodes. + + + Compute nodes also implement caching of images, meaning that if an + image has been used before it won't necessarily be downloaded + every time. Information on the configuration options for caching + on compute nodes can be found in the Configuration + Reference. + +