nova/doc
Matt Riedemann 771b9eaa71 Null out instance.availability_zone on shelve offload
When a user shelve offloads a server, the compute manager
nulls out the instance host and node attributes. However
the availability_zone attribute is left set on the instance
so the API will show the instance as in an AZ when really
it's not, because an instance that is not on a host is not
in a host aggregate so it can't be in an AZ.

Keep in mind that there are two ways an instance can be in
an AZ:

1. The user specifically requests to create the server in
   the AZ.

2. The user does not request an AZ and one is assigned via
   the selected host during server create (or resize, etc).

For the first case, the server will always remain in the
user-requested AZ even after shelve/unshelve. But in the
second case, unshelving the server can result in the server
being spawned on a new host in a different AZ - the scheduler
does not restrict the AZ in that second case.

This change nulls out the instance.availability_zone just like
the host and node fields on shelve offload since it's
confusing to show a shelved offloaded server in an AZ that
doesn't have a host.

Final note: the _nil_out_instance_obj_host_and_node method
is also called during server create if the build fails and
is aborted or rescheduled to another host, and in the case
that unshelve fails. In the case of a server build reschedule,
conductor will set the instance.availability_zone appropriately
based on the alternate host for the reschedule. In the other
failure cases, leaving the instance AZ null is appropriate.

Change-Id: I25a4f36027390def83cfe25f4f3b4af9660da502
Closes-Bug: #1790221
2018-09-27 08:49:41 -04:00
..
api_samples api-ref: add 'migrations' param to GET /os-migrations 2018-09-25 17:06:02 -04:00
ext Replace support matrix ext with common library 2018-07-16 15:04:00 +01:00
notification_samples Null out instance.availability_zone on shelve offload 2018-09-27 08:49:41 -04:00
source Merge "cells: Be explicit in docs about service restarts" 2018-09-26 20:51:35 +00:00
test [doc]remove nova-cert leftover in doc 2018-05-03 17:47:49 +08:00
README.rst Fix the file name of development-environment.rst 2018-06-07 15:26:08 +09:00
requirements.txt Replace support matrix ext with common library 2018-07-16 15:04:00 +01:00

README.rst

OpenStack Nova Documentation README

Both contributor developer documentation and REST API documentation are sourced here.

Contributor developer docs are built to: https://docs.openstack.org/nova/latest/

API guide docs are built to: https://developer.openstack.org/api-guide/compute/

For more details, see the "Building the Documentation" section of doc/source/contributor/development-environment.rst.