nova/doc/source/devref
Chris Behrens 0fab78825e compute_api create*() and schedulers refactoring
Fixes bug 844160

Makes the servers create API call work with all schedulers, removes
'zone boot', and folds create_instance_helper back into servers
controller.

Notable changes:
1) compute API's create_at_all_once has been removed. It was only used
by zone boot.
2) compute API's create() no longer creates Instance DB entries. The
schedulers now do this. This makes sense, as only the schedulers will
know where the instances will be placed. They could be placed locally or
in a child zone. However, this comes at a cost. compute_api.create() now
does a 'call' to the scheduler instead of a 'cast' in most cases (* see
below). This is so it can receive the instance ID(s) that were created
back from the scheduler. Ultimately, we probably need to figure out a
way to generate UUIDs before scheduling and return only the information
we know about an instance before it is actually scheduled and created.
We could then revert this back to a cast. (Or maybe we always return a
reservation ID instead of an instance.)
3) scheduler* calls do not return a host now.  They return a value
that'll be returned if the caller does an rpc.call().  The casts to
hosts are now done by the scheduler drivers themselves.
4) There's been an undocumented feature in the OS API to allow multiple
instances to be built. I've kept it.
5) If compute_api.create() is creating multiple instances, only a single
call is made to the scheduler, vs the old way of sending many casts. All
schedulers now check how many instances have been requested.
6) I've added an undocumented option 'return_reservation_id' when
building. If set to True, only a reservation ID is returned to the API
caller, not the instance. This essentially gives you the old 'nova
zone-boot' functionality.
7) It was requested I create a stub for a zones extension, so you'll see
the empty extension in here. We'll move some code to it later.
8) Fixes an unrelated bug that merged into trunk recently where zones DB
calls were not being done with admin context always, anymore.
9) Scheduler calls were always done with admin context when they should
elevate only when needed.
10) Moved stub_network flag so individual tests can run again.

* Case #6 above doesn't wait for the scheduler response with instance
IDs. It does a 'cast' instead.

Change-Id: Ic040780a2e86d7330e225f14056dadbaa9fb3c7e
2011-09-27 05:32:24 +00:00
..
addmethod.openstackapi.rst Change all 2010 Copyright statements to 2010-2011 in doc source directory only 2011-01-04 16:58:08 -06:00
api.rst Change all 2010 Copyright statements to 2010-2011 in doc source directory only 2011-01-04 16:58:08 -06:00
architecture.rst removing compute monitor 2011-08-02 10:09:58 -04:00
auth.rst Change all 2010 Copyright statements to 2010-2011 in doc source directory only 2011-01-04 16:58:08 -06:00
cloudpipe.rst fix doc typo 2011-04-19 10:31:35 -07:00
compute.rst removing compute monitor 2011-08-02 10:09:58 -04:00
database.rst Change all 2010 Copyright statements to 2010-2011 in doc source directory only 2011-01-04 16:58:08 -06:00
development.environment.rst removing compute monitor 2011-08-02 10:09:58 -04:00
distributed_scheduler.rst compute_api create*() and schedulers refactoring 2011-09-27 05:32:24 +00:00
down.sh put up and down in the right dir 2011-04-20 21:06:56 -07:00
fakes.rst Change all 2010 Copyright statements to 2010-2011 in doc source directory only 2011-01-04 16:58:08 -06:00
glance.rst Change all 2010 Copyright statements to 2010-2011 in doc source directory only 2011-01-04 16:58:08 -06:00
index.rst Add multinic doc and distributed scheduler doc to developer guide front page 2011-07-13 09:04:20 -05:00
interfaces use simpler interfaces 2011-04-21 07:35:30 -07:00
modules.rst merge in trunk 2010-11-08 20:38:21 -08:00
multinic.rst Add multinic doc and distributed scheduler doc to developer guide front page 2011-07-13 09:04:20 -05:00
network.rst Change all 2010 Copyright statements to 2010-2011 in doc source directory only 2011-01-04 16:58:08 -06:00
nova.rst removing compute monitor 2011-08-02 10:09:58 -04:00
objectstore.rst Change all 2010 Copyright statements to 2010-2011 in doc source directory only 2011-01-04 16:58:08 -06:00
rabbit.rst Fixing merge conflicts with new branch 2011-01-03 16:58:45 -06:00
rc.local update documentation on cloudpipe 2011-04-11 21:43:12 +00:00
scheduler.rst Change all 2010 Copyright statements to 2010-2011 in doc source directory only 2011-01-04 16:58:08 -06:00
server.conf.template update documentation on cloudpipe 2011-04-11 21:43:12 +00:00
services.rst Change all 2010 Copyright statements to 2010-2011 in doc source directory only 2011-01-04 16:58:08 -06:00
up.sh put up and down in the right dir 2011-04-20 21:06:56 -07:00
volume.rst Change all 2010 Copyright statements to 2010-2011 in doc source directory only 2011-01-04 16:58:08 -06:00
zone.rst source illustrations added & spelling/grammar based on comstud's feedback 2011-06-10 09:48:17 -03:00