diff --git a/doc/source/admin/configuration/schedulers.rst b/doc/source/admin/configuration/schedulers.rst index 4eff11e95a..eea264fd98 100644 --- a/doc/source/admin/configuration/schedulers.rst +++ b/doc/source/admin/configuration/schedulers.rst @@ -825,7 +825,7 @@ Hosts and cells are weighted based on the following options in the * - [filter_scheduler] - ``build_failure_weight_multiplier`` - Multiplier used for weighing hosts which have recent build failures. A - positive value increases the significance of build falures reported by + positive value increases the significance of build failures reported by the host recently, making them less likely to be chosen. * - [metrics] - ``weight_multiplier`` diff --git a/doc/source/user/filter-scheduler.rst b/doc/source/user/filter-scheduler.rst index 2bd2ccc88f..ffcb04aad5 100644 --- a/doc/source/user/filter-scheduler.rst +++ b/doc/source/user/filter-scheduler.rst @@ -451,6 +451,10 @@ The Filter Scheduler weighs hosts based on the config option a negative value would mean that the anti-affinity weigher would prefer collocating placement. +* |BuildFailureWeigher| Weigh hosts by the number of recent failed boot attempts. + It considers the build failure counter and can negatively weigh hosts with + recent failures. This avoids taking computes fully out of rotation. + Filter Scheduler makes a local list of acceptable hosts by repeated filtering and weighing. Each time it chooses a host, it virtually consumes resources on it, so subsequent selections can adjust accordingly. It is useful if the customer @@ -504,3 +508,4 @@ in :mod:`nova.tests.scheduler`. .. |ServerGroupSoftAffinityWeigher| replace:: :class:`ServerGroupSoftAffinityWeigher ` .. |ServerGroupSoftAntiAffinityWeigher| replace:: :class:`ServerGroupSoftAntiAffinityWeigher ` .. |DiskWeigher| replace:: :class:`DiskWeigher ` +.. |BuildFailureWeigher| replace:: :class:`BuildFailureWeigher `