Browse Source

Merge "Add descriptions of numbered resource classes and traits"

tags/19.0.0.0rc1
Zuul 2 months ago
parent
commit
ca39bdd17e
1 changed files with 45 additions and 0 deletions
  1. 45
    0
      doc/source/user/flavors.rst

+ 45
- 0
doc/source/user/flavors.rst View File

@@ -732,3 +732,48 @@ Forbidden traits
732 732
     Traits can be managed using the `osc-placement plugin`_.
733 733
 
734 734
 .. _osc-placement plugin: https://docs.openstack.org/osc-placement/latest/index.html
735
+
736
+Numbered 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

Loading…
Cancel
Save