summaryrefslogtreecommitdiffstats
path: root/docs/Chapter5/Heat
diff options
context:
space:
mode:
Diffstat (limited to 'docs/Chapter5/Heat')
-rw-r--r--docs/Chapter5/Heat/ONAP Heat Cinder Volumes.rst2
-rw-r--r--docs/Chapter5/Heat/ONAP Heat Orchestration Template Format.rst11
-rw-r--r--docs/Chapter5/Heat/ONAP Heat Orchestration Templates Overview.rst27
-rw-r--r--docs/Chapter5/Heat/ONAP Heat Resource ID and Parameter Naming Convention/Resource IDs.rst20
4 files changed, 42 insertions, 18 deletions
diff --git a/docs/Chapter5/Heat/ONAP Heat Cinder Volumes.rst b/docs/Chapter5/Heat/ONAP Heat Cinder Volumes.rst
index 447768b..36a4deb 100644
--- a/docs/Chapter5/Heat/ONAP Heat Cinder Volumes.rst
+++ b/docs/Chapter5/Heat/ONAP Heat Cinder Volumes.rst
@@ -10,7 +10,7 @@ ONAP Heat Cinder Volumes
Cinder Volumes are created with the heat resource OS::Cinder::Volume.
As stated in :need:`R-46119`, :need:`R-90748`, :need:`R-03251`, a
-VNF's Heat Orchestration Template's Resource OS::Heat::CinderVolume
+VNF's Heat Orchestration Template's Resource ``OS::Heat::CinderVolume``
**MAY** be defined in a Base Module, Incremental Module, or Cinder
Volume Module.
diff --git a/docs/Chapter5/Heat/ONAP Heat Orchestration Template Format.rst b/docs/Chapter5/Heat/ONAP Heat Orchestration Template Format.rst
index a97827c..d9b70f0 100644
--- a/docs/Chapter5/Heat/ONAP Heat Orchestration Template Format.rst
+++ b/docs/Chapter5/Heat/ONAP Heat Orchestration Template Format.rst
@@ -566,12 +566,21 @@ be provided in place, or via a function
:target: VNF
:keyword: MUST
:validation_mode: static
- :updated: casablanca
+ :updated: dublin
If a VNF's Heat Orchestration Template resource attribute
``property:`` uses a nested ``get_param``, the nested
``get_param`` **MUST** reference an index.
+ That is, to obtain a property value, two ``get_param`` intrinsic
+ functions are used. The second ``get_param`` must be used
+ to obtain an index value used to reference a parameter value in
+ a parameter defined as ``type: comma_delimited_list``. For
+ example:
+
+ * ``name: {get_param: [ name, get_param: index ] }``
+
+
metadata
++++++++++
diff --git a/docs/Chapter5/Heat/ONAP Heat Orchestration Templates Overview.rst b/docs/Chapter5/Heat/ONAP Heat Orchestration Templates Overview.rst
index 7f6045a..41be142 100644
--- a/docs/Chapter5/Heat/ONAP Heat Orchestration Templates Overview.rst
+++ b/docs/Chapter5/Heat/ONAP Heat Orchestration Templates Overview.rst
@@ -98,7 +98,7 @@ after initial VNF deployment to add capacity.
:target: VNF
:keyword: MAY
- A VNF's Heat Orchestration Template's Resource OS::Heat::CinderVolume
+ A VNF's Heat Orchestration Template's Resource ``OS::Heat::CinderVolume``
**MAY** be defined in a Base Module.
.. req::
@@ -106,7 +106,7 @@ after initial VNF deployment to add capacity.
:target: VNF
:keyword: MAY
- A VNF's Heat Orchestration Template's Resource OS::Heat::CinderVolume
+ A VNF's Heat Orchestration Template's Resource ``OS::Heat::CinderVolume``
**MAY** be defined in an Incremental Module.
.. req::
@@ -114,14 +114,14 @@ after initial VNF deployment to add capacity.
:target: VNF
:keyword: MAY
- A VNF's Heat Orchestration Template's Resource OS::Heat::CinderVolume
+ A VNF's Heat Orchestration Template's Resource ``OS::Heat::CinderVolume``
**MAY** be defined in a Cinder Volume Module.
ONAP also supports the concept of an optional, independently deployed Cinder
volume via a separate Heat Orchestration Templates, referred to as a Cinder
Volume Module. This allows the volume to persist after a Virtual Machine
(VM) (i.e., OS::Nova::Server) is deleted, allowing the volume to be reused
-on another instance (e.g., during a failover activity).
+on another instance (e.g., during a fail over activity).
.. req::
:id: R-11200
@@ -339,6 +339,22 @@ Cinder Volume Modules
be named identical to the base or incremental module it is supporting with
``_volume`` appended.
+
+.. req::
+ :id: R-589037
+ :keyword: MUST
+ :validation_mode: static
+ :introduced: dublin
+
+ A VNF Heat Orchestration Template's Cinder Volume Module resources section
+ **MUST** only be defined using one of the following:
+
+ * one of more ``OS::Cinder::Volume`` resources
+ * one or more ``OS::Heat::ResourceGroup`` resources that call a nested YAML
+ file that contains only ``OS::Cinder::Volume`` resources
+ * a resource that calls a nested YAML file (static nesting) that contains
+ only ``OS::Cinder::Volume`` resources
+
.. req::
:id: R-31141
:target: VNF
@@ -455,8 +471,7 @@ ONAP Volume Module Output Parameters
A VNF's Heat Orchestration Template's Cinder Volume Module Output
Parameter(s)
**MUST** include the
- UUID(s) of the Cinder Volumes created in template,
- while others **MAY** be included.
+ UUID(s) of the Cinder Volumes created in template.
A VNF's Heat Orchestration Template's Cinder Volume Module Output Parameter(s)
are only available for the module (base or incremental) that the volume
diff --git a/docs/Chapter5/Heat/ONAP Heat Resource ID and Parameter Naming Convention/Resource IDs.rst b/docs/Chapter5/Heat/ONAP Heat Resource ID and Parameter Naming Convention/Resource IDs.rst
index 45f6ecf..5534a8b 100644
--- a/docs/Chapter5/Heat/ONAP Heat Resource ID and Parameter Naming Convention/Resource IDs.rst
+++ b/docs/Chapter5/Heat/ONAP Heat Resource ID and Parameter Naming Convention/Resource IDs.rst
@@ -384,13 +384,13 @@ OS::Neutron::Port
.. req::
:id: R-27469
:target: VNF
- :keyword: MUST
- :validation_mode: static
- :updated: casablanca
+ :keyword: SHOULD
+ :validation_mode: none
+ :updated: dublin
A VNF's Heat Orchestration Template's Resource ``OS::Neutron::Port``
- that is creating a *Reserve Port* with an IPv4 address Resource ID **MUST**
- use the naming convention
+ that is creating a *Reserve Port* with an IPv4 address Resource ID
+ **SHOULD** use the naming convention
* ``reserve_port_{vm-type}_{network-role}_floating_ip_{index}``
@@ -405,13 +405,13 @@ OS::Neutron::Port
.. req::
:id: R-68520
:target: VNF
- :keyword: MUST
- :validation_mode: static
- :updated: casablanca
+ :keyword: SHOULD
+ :validation_mode: none
+ :updated: dublin
A VNF's Heat Orchestration Template's Resource ``OS::Neutron::Port``
- that is creating a *Reserve Port* with an IPv6 address Resource ID **MUST**
- use the naming convention
+ that is creating a *Reserve Port* with an IPv6 address Resource ID
+ **SHOULD** use the naming convention
* ``reserve_port_{vm-type}_{network-role}_floating_v6_ip_{index}``