openstack/nova
Code Issues Proposed changes

Merge "Add image caching to the support matrix"

Browse Source
This commit is contained in:
Zuul 2019-11-14 08:29:51 +00:00 committed by Gerrit Code Review
commit 59d4cfef7d
3 changed files with 34 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
doc/source/admin/aggregates.rst
View File

@ -365,12 +365,14 @@ requesting that images be pre-cached for performance reasons.
.. note:: .. note::
Some of the virt drivers provide image caching support, which improves performance `Some of the virt drivers`_ provide image caching support, which improves performance
of second-and-later boots of the same image by keeping the base image in an on-disk of second-and-later boots of the same image by keeping the base image in an on-disk
cache. This avoids the need to re-download the image from Glance, which reduces cache. This avoids the need to re-download the image from Glance, which reduces
network utilization and time-to-boot latency. Image pre-caching is the act of priming network utilization and time-to-boot latency. Image pre-caching is the act of priming
that cache with images ahead of time to improve performance of the first boot. that cache with images ahead of time to improve performance of the first boot.
.. _Some of the virt drivers: https://docs.openstack.org/nova/latest/user/support-matrix.html#operation_cache_images
Assuming an aggregate called ``my-aggregate`` where two images should Assuming an aggregate called ``my-aggregate`` where two images should
be pre-cached, running the following command will initiate the be pre-cached, running the following command will initiate the
request: request:

5
doc/source/admin/image-caching.rst
View File

@ -3,8 +3,9 @@ Image Caching
============= =============
Nova supports caching base images on compute nodes when using a Nova supports caching base images on compute nodes when using a
supported virt driver. As of the Ussuri release, that list includes `supported virt driver`_.
``hyperv``, ``libvirt``, and ``vmwareapi``.
.. _supported virt driver: https://docs.openstack.org/nova/latest/user/support-matrix.html#operation_cache_images
What is Image Caching? What is Image Caching?
---------------------- ----------------------

28
doc/source/user/support-matrix.ini
View File

@ -1723,3 +1723,31 @@ driver.libvirt-vz-vm=missing
driver.libvirt-vz-ct=missing driver.libvirt-vz-ct=missing
driver.powervm=missing driver.powervm=missing
driver.zvm=missing driver.zvm=missing
[operation.cache-images]
title=Cache base images for faster instance boot
status=optional
notes=Drivers supporting this feature cache base images on the compute host so
that subsequent boots need not incur the expense of downloading them. Partial
support entails caching an image after the first boot that uses it. Complete
support allows priming the cache so that the first boot also benefits. Image
caching support is tunable via config options in the [image_cache] group.
cli=openstack server create <usual server create parameters>
driver.xenserver=missing
driver.libvirt-kvm-x86=complete
driver.libvirt-kvm-aarch64=complete
driver.libvirt-kvm-ppc64=complete
driver.libvirt-kvm-s390x=complete
driver.libvirt-qemu-x86=complete
driver.libvirt-lxc=unknown
driver.libvirt-xen=complete
driver.vmware=partial
driver.hyperv=partial
driver.ironic=missing
driver.libvirt-vz-vm=complete
driver.libvirt-vz-ct=complete
driver.powervm=partial
driver-notes.powervm=The PowerVM driver does image caching natively when using
the SSP disk driver. It does not use the config options in the [image_cache]
group.
driver.zvm=missing