openstack/nova
Code Issues Proposed changes
755d82a7eb
nova/doc/source/reference/index.rst
Matt Riedemann 579e0cfd57 Document differences and similaries between extra specs and hints 
Scheduler hints are not really documented very well at all except
for being mentioned per scheduler filter in the admin configuration
guide, nor are they documented within relation to flavor extra
specs which are both used for impacting scheduling decisions and
are choices that a deployer has to make based on how they configure
their cloud.

This change adds a document about scheduler hints and how they are
similar to and different from flavor extra specs, including end
user discoverability and interoperability, and thoughts on which
should be used if writing a custom scheduler filter.

The TODO in the API guide is also resolved by linking to this
document.

Change-Id: Ib1f35baacf59efafb9e4bccfcc4f0025d99ad5b2
2018-08-29 19:09:11 -04:00

2.2 KiB
Raw Blame History

Technical Reference Deep Dives

The nova project is large, and there are lots of complicated parts in it where it helps to have an overview to understand how the internals of a particular part work.

Internals

The following is a dive into some of the internals in nova.

  • /reference/rpc: How nova uses AMQP as an RPC transport
  • /reference/scheduling: The workflow through the scheduling process
  • /reference/scheduler-hints-vs-flavor-extra-specs: The similarities and differences between flavor extra specs and scheduler hints.
  • /reference/live-migration: The live migration flow
  • /reference/services: Module descriptions for some of the key modules used in starting / running services
  • /reference/vm-states: Cheat sheet for understanding the life cycle of compute instances
  • /reference/threading: The concurrency model used in nova, which is based on eventlet, and may not be familiar to everyone.
  • /reference/notifications: How the notifications subsystem works in nova, and considerations when adding notifications.
  • /reference/update-provider-tree: A detailed explanation of the ComputeDriver.update_provider_tree method.

Debugging

  • /reference/gmr: Inspired by Amiga, a way to trigger a very comprehensive dump of a running service for deep debugging.

Forward Looking Plans

The following section includes documents that describe the overall plan behind groups of nova-specs. Most of these cover items relating to the evolution of various parts of nova's architecture. Once the work is complete, these documents will move into the "Internals" section.

If you want to get involved in shaping the future of nova's architecture, these are a great place to start reading up on the current plans.

  • /user/cells: Comparison of Cells v1 and v2, and how v2 is evolving
  • /reference/policy-enforcement: How we want policy checks on API actions to work in the future
  • /reference/stable-api: What stable api means to nova
  • /reference/scheduler-evolution: Motivation behind the scheduler / placement evolution