blob: ca9585fd5b9d1e77b52f9534957534ffe4bf665d (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
|
.. Licensed under a Creative Commons Attribution 4.0 International License.
.. http://creativecommons.org/licenses/by/4.0
.. Copyright 2017 AT&T Intellectual Property. All rights reserved.
Resource Property "name"
----------------------------
The parameter naming convention of the property ``name`` for the resource
``OS::Nova::Server`` has been defined in
:ref:`Nova Server - Metadata Parameters`.
This section provides specifies how the property ``name`` for non
``OS::Nova::Server`` resources must be defined when the property is used.
Not all resources require the property ``name`` (e.g., it is optional) and
some resources do not support the property.
.. req::
:id: R-85734
:target: VNF
:keyword: MUST
:validation_mode: static
:updated: casablanca
If a VNF's Heat Orchestration Template contains the property ``name``
for a non ``OS::Nova::Server`` resource, the intrinsic function
``str_replace`` **MUST** be used in conjunction with the ONAP
supplied metadata parameter ``vnf_name`` to generate a unique value.
Additional data **MAY** be used in the ``str_replace`` construct
to generate a unique value.
This approach prevents the enumeration of a unique value for the property
``name`` in a per instance environment file.
In most cases the use of the metadata value ``vnf_name`` will create
a unique property name. If this does not create a unique value,
additional dynamic or constant data can be added to the ``str_replace``
construct.
For example, the Heat Orchestration Template pseudo parameter
``OS::stack_name`` can be used in the ``str_replace`` construct.
For resources created in a nested heat file invoked by an
``OS::Heat::ResourceGroup``, the ``index`` can be used to
construct a unique value.
.. req::
:id: R-99812
:target: VNF
:keyword: MUST NOT
:validation_mode: static
:updated: casablanca
A value for VNF's Heat Orchestration Template's property ``name``
for a non ``OS::Nova::Server`` resource **MUST NOT** be declared
in the VNF's Heat Orchestration Template's Environment File.
*Example: Property 'name' for resource 'OS::Neutron::SecurityGroup'*
.. code-block:: yaml
resources:
DNS_SECURITY_GROUP:
type: OS::Neutron::SecurityGroup
properties:
description: vDNS security group
name:
str_replace:
template: VNF_NAME_sec_grp_DNS
params:
VNF_NAME: {get_param: vnf_name}
rules: [. . . . .]
*Example: Property 'name' for resource 'OS::Cinder::Volume'*
.. code-block:: yaml
resources:
dns_volume_0:
type: OS::Cinder::Volume
properties:
description: Cinder Volume
name:
str_replace:
template: VNF_NAME_STACK_NAME_dns_volume
params:
VNF_NAME: {get_param: vnf_name}
STACK_NAME: { get_param: 'OS::stack_name' }
. . . .
*Example: Property 'name' for resource 'OS::Cinder::Volume' invoked by a
'OS::Heat::ResourceGroup'*
.. code-block:: yaml
resources:
dns_volume_0:
type: OS::Cinder::Volume
properties:
description: Cinder Volume
name:
str_replace:
template: VNF_NAME_STACK_NAME_dns_volume_INDEX
params:
VNF_NAME: { get_param: vnf_name }
STACK_NAME: { get_param: 'OS::stack_name' }
INDEX: { get_param: index }
. . . .
Contrail Issue with Values for the Property Name
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
.. req::
:id: R-84517
:target: VNF
:keyword: SHOULD
:updated: casablanca
The Contrail GUI has a limitation displaying special characters.
The issue is documented in
https://bugs.launchpad.net/juniperopenstack/+bug/1590710.
It is recommended that special **SHOULD** characters be avoided.
However, if special characters must be used, note that for
the following resources:
* Virtual Machine
* Virtual Network
* Port
* Security Group
* Policies
* IPAM Creation
the only special characters supported
are - \" ! $\ \ ' ( ) = ~ ^ | @ ` { } [ ] > , . _"
|
