Permalink
Browse files

Added description of operators for extra_specs

There are several new operators added for extra_specs that are used
in compute capability filter and aggregate filter. These are
described in document in this patch. Fixed bug 1047036.

Change-Id: Id86c6672d7bda458ecb918f1900d6f8a9526ad41
  • Loading branch information...
1 parent 93c7652 commit 611ee3b213409d07f2569ce8d600fb0ec105d4be @josephsuh josephsuh committed Sep 11, 2012
Showing with 25 additions and 0 deletions.
  1. +25 −0 doc/source/devref/filter_scheduler.rst
View
25 doc/source/devref/filter_scheduler.rst
@@ -36,9 +36,34 @@ There are some standard filter classes to use (:mod:`nova.scheduler.filters`):
host compute service satisfy any extra specifications associated with the
instance type (that have no scope, see |TrustedFilter| for details). It
passes hosts that can create the specified instance type.
+
+ The extra specifications can have an operator at the beginning of the value
+ string of a key/value pair. If there is no operator specified, then a
+ default operator of 's==' is used. Valid operators are:
+
+::
+
+ * = (equal to or greater than as a number; same as vcpus case)
+ * == (equal to as a number)
+ * != (not equal to as a number)
+ * >= (greater than or equal to as a number)
+ * <= (less than or equal to as a number)
+ * s== (equal to as a string)
+ * s!= (not equal to as a string)
+ * s>= (greater than or equal to as a string)
+ * s> (greater than as a string)
+ * s<= (less than or equal to as a string)
+ * s< (less than as a string)
+ * <in> (substring)
+ * <or> (find one of these)
+
+ Examples are: ">= 5", "s== 2.1.0", "<in> gcc", and "<or> fpu <or> gpu"
+
* |AggregateInstanceExtraSpecsFilter| - checks that the aggregate metadata
satisfies any extra specifications associated with the instance type (that
have no scope). It passes hosts that can create the specified instance type.
+ The extra specifications can have the same operators as
+ |ComputeCapabilityFilter|.
* |ComputeFilter| - passes all hosts that are operational and enabled.
* |CoreFilter| - filters based on CPU core utilization. It passes hosts with
sufficient number of CPU cores.

0 comments on commit 611ee3b

Please sign in to comment.