openstack/ironic
Code Issues Proposed changes

Merge "Docs: Document using operators with root device hints"

Browse Source
This commit is contained in:
Jenkins 2016-11-16 16:09:03 +00:00 committed by Gerrit Code Review
commit 6ef7e23aa3
2 changed files with 44 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

40
install-guide/source/include/root-device-hints.rst
View File

@ -47,5 +47,45 @@ That will guarantee that Bare Metal service will pick the disk device that
has the ``wwn`` equal to the specified wwn value, or fail the deployment if it
can not be found.
The hints can have an operator at the beginning of the value string. If
no operator is specified the default is ``==`` (for numerical values)
and ``s==`` (for string values). The supported operators are:
* For numerical values:
* ``=`` equal to or greater than. This is equivalent to ``>=`` and is
supported for `legacy reasons <http://docs.openstack.org/developer/nova/filter_scheduler.html#ComputeCapabilitiesFilter>`_
* ``==`` equal to
* ``!=`` not equal to
* ``>=`` greater than or equal to
* ``>`` greater than
* ``<=`` less than or equal to
* ``<`` less than
* For strings (as python comparisons):
* ``s==`` equal to
* ``s!=`` not equal to
* ``s>=`` greater than or equal to
* ``s>`` greater than
* ``s<=`` less than or equal to
* ``s<`` less than
* ``<in>`` substring
* For collections:
* ``<all-in>`` all elements contained in collection
* ``<or>`` find one of these
Examples are:
* Finding a disk larger or equal to 60 GiB and non-rotational (SSD)::
ironic node-update <node-uuid> add properties/root_device='{"size": ">= 60", "rotational": false}'
* Finding a disk whose vendor is ``samsung`` or ``winsys``::
ironic node-update <node-uuid> add properties/root_device='{"vendor": "<or> samsung <or> winsys"}'
.. note::
If multiple hints are specified, a device must satisfy all the hints.

7
releasenotes/notes/support-root-device-hints-with-operators-96cf34fa37b5b2e8.yaml
View File

@ -1,6 +1,7 @@
---
features:
- Adds support for using operators with the root device hints mechanism.
The currently supported operators are, ``=``, ``==``, ``!=``, ``>=``,
``<=``, ``>``, ``<``, ``s==``, ``s!=``, ``s>=``, ``s>``, ``s<=``,
``s<``, ``<in>``, ``<all-in>`` and ``<or>``.
The supported operators are, ``=``, ``==``, ``!=``, ``>=``,
``<=``, ``>``, ``<``, ``s==``, ``s!=``, ``s>=``, ``s>``,
``s<=``, ``s<``, ``<in>``, ``<all-in>`` and ``<or>``. See
http://docs.openstack.org/project-install-guide/baremetal/draft/advanced.html#specifying-the-disk-for-deployment-root-device-hints