openstack/nova
Code Issues Proposed changes

Correct info about volume-backed server rebuild

Browse Source 
In the evacuate vs rebuild doc, it is stated that nova does not
support volume-backed server rebuild which is not correct.
With the introduction of microversion 2.93, we support volume
backed server rebuild and this patch aims at correcting that
information.

Change-Id: I5da86ad115f628582404dee52bcbfb250fdb7cd4
This commit is contained in:
Rajat Dhasmana 2024-07-22 12:45:06 +05:30
parent 8c4a2e1b47
commit f57176dd29
1 changed files with 8 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

16
doc/source/contributor/evacuate-vs-rebuild.rst
View File

@ -25,12 +25,11 @@ evacuate process.
of the server (the user) performed on the **same** compute host to change of the server (the user) performed on the **same** compute host to change
certain aspects of the server, most notably using a **different** image. Note certain aspects of the server, most notably using a **different** image. Note
that the image does not *have* to change and in the case of volume-backed that the image does not *have* to change and in the case of volume-backed
servers the image `currently cannot change`_. Other attributes of the server servers the image `can be changed`_ with microversion `2.93`_. Other attributes
can be changed as well such as ``key_name`` and ``user_data``. See the of the server can be changed as well such as ``key_name`` and ``user_data``.
`rebuild API`_ reference for full usage details. When a user rebuilds a server See the `rebuild API`_ reference for full usage details. When a user rebuilds
they want to change it which requires re-spawning the guest in the hypervisor a server they want to change it which requires re-spawning the guest in the
but retain the UUID, volumes and ports attached to the server. For a hypervisor but retain the UUID, volumes and ports attached to the server.
non-volume-backed server the root disk image is rebuilt.
Scheduling Scheduling
~~~~~~~~~~ ~~~~~~~~~~
@ -47,7 +46,7 @@ Image
As noted above, the image that the server uses during an evacuate operation As noted above, the image that the server uses during an evacuate operation
does not change. The image used to rebuild a server *may* change but does not does not change. The image used to rebuild a server *may* change but does not
have to and in the case of volume-backed servers *cannot* change. have to.
Resource claims Resource claims
~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~
@ -92,7 +91,8 @@ server allocations remain intact.
.. _rebuild API: https://docs.openstack.org/api-ref/compute/#rebuild-server-rebuild-action .. _rebuild API: https://docs.openstack.org/api-ref/compute/#rebuild-server-rebuild-action
.. _conductor code: https://opendev.org/openstack/nova/src/tag/19.0.0/nova/conductor/manager.py#L944 .. _conductor code: https://opendev.org/openstack/nova/src/tag/19.0.0/nova/conductor/manager.py#L944
.. _compute code: https://opendev.org/openstack/nova/src/tag/19.0.0/nova/compute/manager.py#L3052 .. _compute code: https://opendev.org/openstack/nova/src/tag/19.0.0/nova/compute/manager.py#L3052
.. _currently cannot change: https://specs.openstack.org/openstack/nova-specs/specs/train/approved/volume-backed-server-rebuild.html .. _can be changed: https://specs.openstack.org/openstack/nova-specs/specs/zed/implemented/volume-backed-server-rebuild.html
.. _2.93: https://docs.openstack.org/nova/latest/reference/api-microversion-history.html#maximum-in-zed
.. _rebuilding with a different image: https://opendev.org/openstack/nova/src/tag/19.0.0/nova/compute/api.py#L3414 .. _rebuilding with a different image: https://opendev.org/openstack/nova/src/tag/19.0.0/nova/compute/api.py#L3414
.. _claims: https://opendev.org/openstack/nova/src/tag/19.0.0/nova/compute/claims.py .. _claims: https://opendev.org/openstack/nova/src/tag/19.0.0/nova/compute/claims.py
.. _rebuild claim: https://opendev.org/openstack/nova/src/tag/19.0.0/nova/compute/manager.py#L3104 .. _rebuild claim: https://opendev.org/openstack/nova/src/tag/19.0.0/nova/compute/manager.py#L3104