summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorZuul <zuul@review.openstack.org>2019-03-15 17:47:53 +0000
committerGerrit Code Review <review@openstack.org>2019-03-15 17:47:53 +0000
commitca39bdd17e3eb17cc97469f82912237d4c91e990 (patch)
tree4b5388c7fe07afe7e30c896044503a1ab680935f
parente272b280f1ebac3c5ceb2bfa9addc81c67c1831e (diff)
parent6cc88bab4fd1894934596546028b13701f6082d4 (diff)
Merge "Add descriptions of numbered resource classes and traits"
-rw-r--r--doc/source/user/flavors.rst45
1 files changed, 45 insertions, 0 deletions
diff --git a/doc/source/user/flavors.rst b/doc/source/user/flavors.rst
index 51d990e..b30e2f0 100644
--- a/doc/source/user/flavors.rst
+++ b/doc/source/user/flavors.rst
@@ -732,3 +732,48 @@ Forbidden traits
732 Traits can be managed using the `osc-placement plugin`_. 732 Traits can be managed using the `osc-placement plugin`_.
733 733
734.. _osc-placement plugin: https://docs.openstack.org/osc-placement/latest/index.html 734.. _osc-placement plugin: https://docs.openstack.org/osc-placement/latest/index.html
735
736Numbered groupings of resource classes and traits
737 Added in the 18.0.0 Rocky release.
738
739 Specify numbered groupings of resource classes and traits.
740
741 The syntax is as follows (``N`` and ``VALUE`` are integers):
742
743 .. parsed-literal::
744
745 resources\ *N*:*<resource_class_name>*\ =\ *VALUE*
746 trait\ *N*:*<trait_name>*\ =required
747
748 A given numbered ``resources`` or ``trait`` key may be repeated to
749 specify multiple resources/traits in the same grouping,
750 just as with the un-numbered syntax.
751
752 Specify inter-group affinity policy via the ``group_policy`` key,
753 which may have the following values:
754
755 * ``isolate``: Different numbered request groups will be satisfied by
756 *different* providers.
757 * ``none``: Different numbered request groups may be satisfied
758 by different providers *or* common providers.
759
760 For example, to create a server with the following VFs:
761
762 * One SR-IOV virtual function (VF) on NET1 with bandwidth 10000 bytes/sec
763 * One SR-IOV virtual function (VF) on NET2 with bandwidth 20000 bytes/sec
764 on a *different* NIC with SSL acceleration
765
766 It is specified in the extra specs as follows::
767
768 resources1:SRIOV_NET_VF=1
769 resources1:NET_EGRESS_BYTES_SEC=10000
770 trait1:CUSTOM_PHYSNET_NET1=required
771 resources2:SRIOV_NET_VF=1
772 resources2:NET_EGRESS_BYTES_SEC:20000
773 trait2:CUSTOM_PHYSNET_NET2=required
774 trait2:HW_NIC_ACCEL_SSL=required
775 group_policy=isolate
776
777 See `Granular Resource Request Syntax`_ for more details.
778
779.. _Granular Resource Request Syntax: https://specs.openstack.org/openstack/nova-specs/specs/rocky/implemented/granular-resource-requests.html