diff --git a/doc/source/dev/glossary.rst b/doc/source/dev/glossary.rst index c57765449..d5c38c1a6 100644 --- a/doc/source/dev/glossary.rst +++ b/doc/source/dev/glossary.rst @@ -41,7 +41,8 @@ of the OpenStack :ref:`Cluster ` such as: - Changing the current state of an hypervisor (enable or disable) with Nova In most cases, an :ref:`Action ` triggers some concrete -commands on an existing OpenStack module (Nova, Neutron, Cinder, Ironic, etc.). +commands on an existing OpenStack module (Nova, Neutron, Cinder, Ironic, etc.) +via a :ref:`Primitive `. An :ref:`Action ` has a life-cycle and its current state may be one of the following: @@ -521,6 +522,24 @@ specific domain. Please, read `the official OpenStack definition of a Project `_. + +.. _primitive_definition + +Primitive +========= + +A :ref:`Primitive ` is the component that carries out a +certain type of atomic :ref:`Actions ` on a given +:ref:`Managed resource ` (nova, swift, neutron, +glance,..). A :ref:`Primitive ` is a part of the +:ref:`Watcher Applier ` module. + +For example, there can be a :ref:`Primitive ` which is +responsible for creating a snapshot of a given instance on a Nova compute node. +This :ref:`Primitive ` knows exactly how to send +the appropriate commands to Nova for this type of +:ref:`Actions `. + .. _sla_definition: SLA