gerrit.onap Code Review - vnfrqts/requirements.git/blob

   1 .. Licensed under a Creative Commons Attribution 4.0 International License.
   2 .. http://creativecommons.org/licenses/by/4.0
   3 .. Copyright 2017 AT&T Intellectual Property.  All rights reserved.
   4
   5 .. _Nova Server - Metadata Parameters:
   6
   7 Resource: OS::Nova::Server Metadata Parameters
   8 --------------------------------------------------------------------------------
   9
  10 The ``OS::Nova::Server`` resource property ``metadata`` is an optional
  11 OpenStack property.
  12 Table 2 summarizes the mandatory and optional ``metadata`` supported by ONAP.
  13 The sections that follow provides the requirements associated with each
  14 ``metadata`` parameter.
  15
  16
  17 .. csv-table:: **Table 2 OS::Nova::Server Mandatory and Optional Metadata**
  18    :header: Resource, Property, Parameter Name, Parameter Type, Required, Parameter Value Provided to Heat
  19    :align: center
  20    :widths: auto
  21
  22    OS::Nova::Server, metadata, vnf_id, string, **MUST**, ONAP
  23    OS::Nova::Server, metadata, vf_module_id, string, **MUST**, ONAP
  24    OS::Nova::Server, metadata, vnf_name, string, **MUST**, ONAP
  25    OS::Nova::Server, metadata, vf_module_name, string, **SHOULD**, ONAP
  26    OS::Nova::Server, metadata, vm_role, string, **MAY**, YAML or Environment File
  27    OS::Nova::Server, metadata, vf_module_index, number, **MAY**, ONAP
  28    OS::Nova::Server, metadata, workload_context, string, **MUST**, ONAP
  29    OS::Nova::Server, metadata, environment_context, string, **MUST**, ONAP
  30
  31 vnf_id
  32 ^^^^^^^^^
  33
  34 The ``OS::Nova::Server`` resource property ``metadata`` key/value pair
  35 ``vnf_id`` is an ONAP generated UUID that identifies the VNF.  The value
  36 is provided by ONAP to the VNF's Heat Orchestration
  37 Template at orchestration time.
  38
  39 .. req::
  40     :id: R-37437
  41     :target: VNF
  42     :keyword: MUST
  43     :validation_mode: static
  44     :updated: casablanca
  45
  46     A VNF's Heat Orchestration Template's ``OS::Nova::Server``
  47     resource property ``metadata`` **MUST**
  48     contain the  key/value pair ``vnf_id``
  49     and the value **MUST** be obtained via a ``get_param``.
  50
  51 .. req::
  52     :id: R-07507
  53     :target: VNF
  54     :keyword: MUST
  55     :validation_mode: static
  56     :updated: casablanca
  57
  58     A VNF's Heat Orchestration Template's ``OS::Nova::Server``
  59     resource property
  60     ``metadata`` key/value pair ``vnf_id`` parameter
  61     **MUST** be declared as ``vnf_id`` and the parameter **MUST**
  62     be defined as type: ``string``.
  63
  64 .. req::
  65     :id: R-55218
  66     :target: VNF
  67     :keyword: MUST NOT
  68     :validation_mode: static
  69     :updated: casablanca
  70
  71     A VNF's Heat Orchestration Template's ``OS::Nova::Server``
  72     resource property
  73     ``metadata`` key/value pair ``vnf_id`` parameter ``vnf_id`` **MUST NOT**
  74     have parameter constraints defined.
  75
  76 .. req::
  77     :id: R-20856
  78     :target: VNF
  79     :keyword: MUST NOT
  80     :validation_mode: static
  81     :updated: casablanca
  82
  83     A VNF's Heat Orchestration Template's ``OS::Nova::Server``
  84     resource property
  85     ``metadata`` key/value pair ``vnf_id`` parameter ``vnf_id`` **MUST NOT**
  86     be enumerated in the Heat Orchestration Template's environment file.
  87
  88 *Example 'vnf_id' Parameter Definition*
  89
  90 .. code-block:: yaml
  91
  92   parameters:
  93
  94     vnf_id:
  95       type: string
  96       description: Unique ID for this VNF instance
  97
  98 vf_module_id
  99 ^^^^^^^^^^^^^^^^^^^^
 100
 101 The OS::Nova::Server Resource ``metadata`` map value parameter ``vf_module_id``
 102 is an ONAP generated UUID that identifies the VF Module (e.g., Heat
 103 Orchestration Template).  The value
 104 is provided by ONAP to the VNF's Heat Orchestration
 105 Template at orchestration time.
 106
 107 .. req::
 108     :id: R-71493
 109     :target: VNF
 110     :keyword: MUST
 111     :validation_mode: static
 112     :updated: casablanca
 113
 114     A VNF's Heat Orchestration Template's ``OS::Nova::Server`` resource
 115     property ``metadata`` **MUST**
 116     contain the key/value pair ``vf_module_id``
 117     and the value MUST be obtained via a ``get_param``.
 118
 119 .. req::
 120     :id: R-82134
 121     :target: VNF
 122     :keyword: MUST
 123     :validation_mode: static
 124     :updated: casablanca
 125
 126     A VNF's Heat Orchestration Template's ``OS::Nova::Server`` resource property
 127     ``metadata`` key/value pair ``vf_module_id`` parameter **MUST**
 128     be declared as ``vf_module_id`` and the parameter **MUST**
 129     be defined as type: ``string``.
 130
 131 .. req::
 132     :id: R-98374
 133     :target: VNF
 134     :keyword: MUST NOT
 135     :validation_mode: static
 136     :updated: casablanca
 137
 138     A VNF's Heat Orchestration Template's ``OS::Nova::Server`` resource property
 139     ``metadata`` key/value pair ``vf_module_id`` parameter ``vf_module_id``
 140     **MUST NOT**
 141     have parameter constraints defined.
 142
 143 .. req::
 144     :id: R-72871
 145     :target: VNF
 146     :keyword: MUST NOT
 147     :validation_mode: static
 148     :updated: casablanca
 149
 150     A VNF's Heat Orchestration Template's ``OS::Nova::Server`` resource property
 151     ``metadata`` key/value pair ``vf_module_id`` parameter ``vf_module_id``
 152     **MUST NOT**
 153     be enumerated in the Heat Orchestration Template's environment file.
 154
 155 *Example 'vf_module_id' Parameter Definition*
 156
 157 .. code-block:: yaml
 158
 159   parameters:
 160
 161     vnf_module_id:
 162       type: string
 163       description: Unique ID for this VNF module instance
 164
 165
 166 vnf_name
 167 ^^^^^^^^^
 168
 169 The ``OS::Nova::Server`` Resource ``metadata`` map value parameter ``vnf_name``
 170 is the ONAP (SDN-C) generated alphanumeric name of the deployed VNF instance.
 171 The value
 172 is provided by ONAP to the VNF's Heat Orchestration
 173 Template at orchestration time.
 174
 175 .. req::
 176     :id: R-72483
 177     :target: VNF
 178     :keyword: MUST
 179     :validation_mode: static
 180     :updated: casablanca
 181
 182     A VNF's Heat Orchestration Template's ``OS::Nova::Server`` resource property
 183     ``metadata`` **MUST** contain the key/value pair ``vnf_name`` and the
 184     value **MUST** be obtained via a ``get_param``.
 185
 186 .. req::
 187     :id: R-62428
 188     :target: VNF
 189     :keyword: MUST
 190     :validation_mode: static
 191     :updated: casablanca
 192
 193     A VNF's Heat Orchestration Template's ``OS::Nova::Server`` resource
 194     property ``metadata`` key/value pair ``vnf_name`` parameter **MUST**
 195     be declared as ``vnf_name`` and the parameter **MUST** be defined as
 196     type: ``string``.
 197
 198 .. req::
 199     :id: R-44318
 200     :target: VNF
 201     :keyword: MUST NOT
 202     :validation_mode: static
 203     :updated: casablanca
 204
 205     A VNF's Heat Orchestration Template's ``OS::Nova::Server`` resource
 206     property ``metadata`` key/value pair ``vnf_name``
 207     parameter ``vnf_name`` **MUST NOT**
 208     have parameter constraints defined.
 209
 210 .. req::
 211     :id: R-36542
 212     :target: VNF
 213     :keyword: MUST NOT
 214     :validation_mode: static
 215     :updated: casablanca
 216
 217     A VNF's Heat Orchestration Template's ``OS::Nova::Server`` resource
 218     property ``metadata`` key/value pair ``vnf_name`` parameter
 219     ``vnf_name`` **MUST NOT**
 220     be enumerated in the Heat Orchestration Template's environment file.
 221
 222
 223 *Example 'vnf_name' Parameter Definition*
 224
 225 .. code-block:: yaml
 226
 227   parameters:
 228
 229     vnf_name:
 230       type: string
 231       description: Unique name for this VNF instance
 232
 233 vf_module_name
 234 ^^^^^^^^^^^^^^^^^^
 235
 236 The ``OS::Nova::Server`` Resource ``metadata`` map value parameter
 237 ``vf_module_name``
 238 is the deployment name of the heat stack created (e.g., ``<STACK_NAME>``)
 239 from the
 240 VNF's Heat Orchestration template
 241 in the command ``Heat stack-create``
 242 (e.g., ``Heat stack-create [-f <FILE>] [-e <FILE>] <STACK_NAME>``).
 243 The ``vf_module_name`` (e.g., ``<STACK_NAME>`` is specified as
 244 part of the orchestration process.
 245
 246 .. req::
 247     :id: R-100400
 248     :keyword: SHOULD
 249     :introduced: 2019-1
 250     :target: VNF
 251
 252     A VNF's Heat Orchestration Template's ``OS::Nova::Server`` resource
 253     property metadata **SHOULD** contain the key/value pair ``vf_module_name``.
 254
 255
 256 .. req::
 257     :id: R-68023
 258     :keyword: MUST
 259     :validation_mode: static
 260     :target: VNF
 261     :updated: 2019-1
 262
 263     A VNF's Heat Orchestration Template's ``OS::Nova::Server`` resource
 264     property ``metadata`` key/value pair ``vf_module_name``
 265     value **MUST**
 266     be obtained via a ``get_param``.
 267
 268 .. req::
 269     :id: R-39067
 270     :target: VNF
 271     :keyword: MUST
 272     :validation_mode: static
 273     :updated: casablanca
 274
 275     A VNF's Heat Orchestration Template's ``OS::Nova::Server`` resource
 276     property
 277     ``metadata`` key/value pair ``vf_module_name`` parameter **MUST** be
 278     declared as ``vf_module_name`` and the parameter **MUST**
 279     be defined as type: ``string``.
 280
 281 .. req::
 282     :id: R-15480
 283     :target: VNF
 284     :keyword: MUST NOT
 285     :validation_mode: static
 286     :updated: casablanca
 287
 288     A VNF's Heat Orchestration Template's ``OS::Nova::Server`` resource
 289     property
 290     ``metadata`` key/value pair ``vf_module_name`` parameter ``vf_module_name``
 291     **MUST NOT** have parameter constraints defined.
 292
 293 .. req::
 294     :id: R-80374
 295     :target: VNF
 296     :keyword: MUST NOT
 297     :validation_mode: static
 298     :updated: casablanca
 299
 300
 301     A VNF's Heat Orchestration Template's ``OS::Nova::Server`` resource
 302     property ``metadata`` key/value pair ``vf_module_name``
 303     parameter ``vf_module_name`` **MUST NOT**
 304     be enumerated in the Heat Orchestration Template's environment file.
 305
 306
 307 *Example 'vf_module_name' Parameter Definition*
 308
 309 .. code-block:: yaml
 310
 311   parameters:
 312
 313     vf_module_name:
 314       type: string
 315       description: Unique name for this VNF Module instance
 316
 317 vm_role
 318 ^^^^^^^^^
 319
 320 The ``OS::Nova::Server`` Resource ``metadata`` map value parameter ``vm_role``
 321 is a ``metadata`` tag that describes the role of the Virtual Machine.
 322
 323 .. req::
 324     :id: R-85328
 325     :target: VNF
 326     :keyword: MAY
 327     :updated: casablanca
 328
 329     A VNF's Heat Orchestration Template's ``OS::Nova::Server`` resource property
 330     ``metadata`` **MAY**
 331     contain the key/value pair ``vm_role`` and the value **MUST** be
 332     obtained either via
 333
 334     - ``get_param``
 335     - hard coded in the key/value pair ``vm_role``.
 336
 337 .. req::
 338     :id: R-95430
 339     :target: VNF
 340     :keyword: MAY
 341     :validation_mode: none
 342     :updated: dublin
 343
 344     If a VNF's Heat Orchestration Template's ``OS::Nova::Server``
 345     resource property
 346     ``metadata`` key/value pair ``vm_role`` value is obtained via
 347     ``get_param``, the parameter **MAY** be declared as
 348
 349     * ``vm_role`` and the parameter defined as ``type: string``.
 350     * ``vm_roles`` and the parameter defined as ``type: comma_delimited_list``.
 351     * ``{vm-type}_vm_role`` and the parameter defined as ``type: string``.
 352
 353 .. req::
 354     :id: R-67597
 355     :target: VNF
 356     :keyword: MUST NOT
 357     :validation_mode: static
 358     :updated: casablanca
 359
 360     A VNF's Heat Orchestration Template's ``OS::Nova::Server`` resource
 361     property ``metadata`` key/value pair ``vm_role`` parameter ``vm_role``
 362     **MUST NOT** have parameter constraints defined.
 363
 364 Defining the ``vm_role`` as the ``{vm-type}`` is a recommended convention
 365
 366
 367 .. req::
 368     :id: R-86476
 369     :target: VNF
 370     :keyword: MUST
 371     :validation_mode: static
 372     :updated: casablanca
 373
 374     A VNF's Heat Orchestration Template's ``OS::Nova::Server`` resource
 375     property ``metadata`` key/value pair ``vm_role`` value **MUST**
 376     only contain alphanumeric characters and underscores (i.e., '_').
 377
 378
 379 *Example 'vm_role' Parameter Definition*
 380
 381 .. code-block:: yaml
 382
 383   parameters:
 384
 385     vm_role:
 386       type: string
 387       description: Unique role for this VM
 388
 389 *Example: 'vm_role' Definition: Hard Coded in
 390 OS::Nova::Resource metadata property*
 391
 392 .. code-block:: yaml
 393
 394   resources:
 395
 396     dns_server_0
 397       type: OS::Nova::Server
 398       properties:
 399         . . . .
 400         metadata:
 401           vm_role: dns
 402
 403 *Example 'vm_role' Definition: Defined in Environment file
 404 and retrieved via 'get_param'*
 405
 406 .. code-block:: yaml
 407
 408   resources:
 409
 410     dns_server_0:
 411       type: OS::Nova::Server
 412       properties:
 413         . . . .
 414         metadata:
 415           vm_role: { get_param: vm_role }
 416
 417 Example vnf_id, vf_module_id, vnf_name, vf_module_name, vm_role
 418 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 419
 420 The example below depicts part of a Heat Orchestration Template that
 421 uses the five of the ``OS::Nova::Server`` resource
 422 ``metadata`` map value parameters discussed in this
 423 section. The ``{vm-type}`` has been defined as ``lb`` for load balancer.
 424
 425 .. code-block:: yaml
 426
 427   parameters:
 428     lb_name_0
 429       type: string
 430       description: VM Name for lb VM 0
 431     vnf_name:
 432       type: string
 433       description: Unique name for this VNF instance
 434     vnf_id:
 435       type: string
 436       description: Unique ID for this VNF instance
 437     vf_module_name:
 438       type: string
 439       description: Unique name for this VNF Module instance
 440     vf_module_id:
 441       type: string
 442       description: Unique ID for this VNF Module instance
 443     vm_role:
 444       type: string
 445       description: Unique role for this VM
 446   resources:
 447     lb_server_0:
 448       type: OS::Nova::Server
 449       properties:
 450         name: { get_param: lb_name_0 }
 451         ...
 452         metadata:
 453           vnf_name: { get_param: vnf_name }
 454           vnf_id: { get_param: vnf_id }
 455           vf_module_name: { get_param: vf_module_name }
 456           vf_module_id: { get_param: vf_module_id }
 457           vm_role: lb
 458
 459 vf_module_index
 460 ^^^^^^^^^^^^^^^^^^
 461
 462
 463 .. req::
 464     :id: R-100410
 465     :keyword: MAY
 466     :introduced: 2019-1
 467     :target: VNF
 468
 469     A VNF's Heat Orchestration Template's ``OS::Nova::Server``
 470     resource  property ``metadata`` **MAY**
 471     contain the key/value pair ``vf_module_index``.
 472
 473
 474 .. req::
 475     :id: R-50816
 476     :keyword: MUST
 477     :target: VNF
 478     :validation_mode: static
 479     :updated: 2019-1
 480
 481     A VNF's Heat Orchestration Template's ``OS::Nova::Server``
 482     resource  property ``metadata``
 483     key/value pair ``vf_module_index``
 484     value **MUST** be obtained via a ``get_param``.
 485
 486 .. req::
 487     :id: R-54340
 488     :target: VNF
 489     :keyword: MUST
 490     :validation_mode: static
 491     :updated: casablanca
 492
 493     A VNF's Heat Orchestration Template's ``OS::Nova::Server`` resource
 494     property
 495     ``metadata`` key/value pair ``vf_module_index`` parameter **MUST**
 496     be declared as ``vf_module_index`` and the parameter **MUST** be
 497     defined as type: ``number``.
 498
 499
 500 .. req::
 501     :id: R-09811
 502     :target: VNF
 503     :keyword: MUST NOT
 504     :validation_mode: static
 505     :updated: casablanca
 506
 507
 508     A VNF's Heat Orchestration Template's ``OS::Nova::Server`` resource
 509     property ``metadata`` key/value pair ``vf_module_index`` **MUST NOT**
 510     have parameter constraints defined.
 511
 512 .. req::
 513     :id: R-37039
 514     :target: VNF
 515     :keyword: MUST NOT
 516     :validation_mode: static
 517     :updated: casablanca
 518
 519     A VNF's Heat Orchestration Template's ``OS::Nova::Server`` resource
 520     property
 521     ``metadata`` key/value pair ``vf_module_index`` parameter
 522     ``vf_module_index`` **MUST NOT**
 523     be enumerated in the Heat Orchestration Template's environment file.
 524
 525 .. req::
 526     :id: R-55306
 527     :target: VNF
 528     :keyword: MUST NOT
 529     :validation_mode: static
 530     :updated: casablanca
 531
 532     A VNF's Heat Orchestration Template's ``OS::Nova::Server`` resource
 533     property ``metadata`` key/value pair ``vf_module_index`` **MUST NOT**
 534     be used in a ``OS::Cinder::Volume`` resource and **MUST NOT** be
 535     used in VNF's Volume template;
 536     it is not supported.
 537
 538 The ``vf_module_index`` parameter indicates which instance of the module is
 539 being deployed into the VNF.
 540 This parameter may be used in cases where multiple instances of the same
 541 incremental module may be instantiated for scaling purposes. The index
 542 can be used in the Heat Orchestration Template for indexing into a
 543 pseudo-constant array parameter when unique values are required for each
 544 module instance, e.g., for fixed private IP addresses on VM types.
 545
 546 The ``vf_module_index`` will start at 0 for the first instance of a module
 547 type. Subsequent instances of the same module type will receive the
 548 lowest unused index. This means that indexes will be reused if a module
 549 is deleted and re-added. As an example, if three copies of a module are
 550 deployed with ``vf_module_index`` values of 0, 1, and 2 then subsequently
 551 the second one is deleted (index 1), and then re-added, index 1 will be
 552 reused.
 553
 554 *Example*
 555
 556 In this example, the ``{vm-type}`` has been defined as ``oam_vm`` to represent
 557 an OAM VM. An incremental heat module is used to deploy the OAM VM. The
 558 OAM VM attaches to an internal control network which has a
 559 ``{network-role}`` of ``ctrl``. A maximum of four OAM VMs can be deployed. The
 560 environment file contains the four IP addresses that each successive OAM
 561 VM will be assigned. The ``vf_module_index`` is used as the index to
 562 determine the IP assignment.
 563
 564 Environment File
 565
 566 .. code-block:: yaml
 567
 568   parameters:
 569     oam_vm_int_ctrl_ips: 10.10.10.1,10.10.10.2,10.10.10.3,10.10.10.4
 570
 571 YAML File
 572
 573 .. code-block:: yaml
 574
 575   parameters:
 576     vf_module_index:
 577       type: number
 578       description: Unique index for this VNF Module instance
 579     oam_vm_name_0:
 580       type: string
 581       description: VM Name for lb VM 0
 582     int_ctrl_net_id:
 583       type: string
 584       description: Neutron UUID for the internal control network
 585     oam_vm_int_ctrl_ips:
 586       type: comma_delimited_list
 587       description: Fixed IP assignments for oam VMs on the internal control
 588                    network
 589   resources:
 590     oam_vm_server_0:
 591       type: OS::Nova::Server
 592       properties:
 593         name: { get_param: oam_vm_name_0 }
 594         networks:
 595           - port: { get_resource: oam_vm_0_int_ctrl_port_0 }
 596   #     . . .
 597         metadata:
 598           vf_module_index: { get_param: vf_module_index }
 599     oam_vm_0_int_ctrl_port_0:
 600       type: OS::Neutron::Port
 601       properties:
 602         network: { get_param: int_ctrl_net_id }
 603         fixed_ips: [ { "ip_address": {get_param: [ oam_vm_int_ctrl_ips, { get_param: vf_module_index} ]}}]
 604
 605 workload_context
 606 ^^^^^^^^^^^^^^^^^^^^^
 607
 608 .. req::
 609     :id: R-47061
 610     :target: VNF
 611     :keyword: SHOULD
 612     :updated: casablanca
 613
 614     A VNF's Heat Orchestration Template's OS::Nova::Server
 615     Resource **SHOULD** contain the metadata map value parameter
 616     'workload_context'.
 617
 618 .. req::
 619     :id: R-74978
 620     :target: VNF
 621     :keyword: MUST
 622     :validation_mode: static
 623     :updated: casablanca
 624
 625     A VNF's Heat Orchestration Template's ``OS::Nova::Server`` resource
 626     property ``metadata`` key/value pair ``workload_context``
 627     parameter **MUST**
 628     be declared as ``workload_context`` and the parameter **MUST**
 629     be defined as type: ``string``.
 630
 631 .. req::
 632     :id: R-34055
 633     :target: VNF
 634     :keyword: MUST NOT
 635     :validation_mode: static
 636     :updated: casablanca
 637
 638     A VNF's Heat Orchestration Template's ``OS::Nova::Server`` resource
 639     property ``metadata`` key/value pair ``workload_context``
 640     parameter ``workload_context`` **MUST NOT**
 641     have parameter constraints defined.
 642
 643 .. req::
 644     :id: R-02691
 645     :target: VNF
 646     :keyword: MUST NOT
 647     :validation_mode: static
 648     :updated: casablanca
 649
 650
 651     A VNF's Heat Orchestration Template's ``OS::Nova::Server`` resource
 652     property ``metadata`` key/value pair ``workload_context``
 653     parameter ``workload_context`` **MUST NOT**
 654     be enumerated in the Heat Orchestration Template's environment file.
 655
 656 The 'workload\_context' parameter value will be chosen by the Service Model
 657 Distribution context client in VID and will be supplied to the
 658 Heat Orchestration Template by ONAP at orchestration time.
 659
 660 *Example Parameter Definition*
 661
 662 .. code-block:: yaml
 663
 664   parameters:
 665     workload_context:
 666       type: string
 667       description: Workload Context for this VNF instance
 668
 669
 670 *Example OS::Nova::Server with metadata*
 671
 672 .. code-block:: yaml
 673
 674   resources:
 675     . . .
 676
 677     {vm-type}_server_{index}:
 678        type: OS::Nova::Server
 679        properties:
 680          name:
 681          flavor:
 682          image:
 683         ...
 684        metadata:
 685           vnf_name: { get_param: vnf_name }
 686           vnf_id: { get_param: vnf_id }
 687           vf_module_name: { get_param: vf_module_name }
 688           vf_module_id: { get_param: vf_module_id }
 689           workload_context: {get_param: workload_context}
 690
 691 environment_context
 692 ^^^^^^^^^^^^^^^^^^^^^
 693
 694 .. req::
 695     :id: R-88536
 696     :target: VNF
 697     :keyword: SHOULD
 698     :updated: casablanca
 699
 700     A VNF's Heat Orchestration Template's OS::Nova::Server
 701     Resource **SHOULD** contain the metadata map value parameter
 702     'environment_context'.
 703
 704 .. req::
 705     :id: R-20308
 706     :target: VNF
 707     :keyword: MUST
 708     :validation_mode: static
 709     :updated: casablanca
 710
 711     A VNF's Heat Orchestration Template's ``OS::Nova::Server`` resource
 712     property ``metadata`` key/value pair ``environment_context``
 713     parameter **MUST** be declared as ``environment_context`` and the
 714     parameter type **MUST** be defined as type: ``string``.
 715
 716 .. req::
 717     :id: R-56183
 718     :target: VNF
 719     :keyword: MUST NOT
 720     :validation_mode: static
 721     :updated: casablanca
 722
 723     A VNF's Heat Orchestration Template's ``OS::Nova::Server`` resource
 724     property ``metadata``key/value pair ``environment_context``
 725     parameter ``environment_context`` **MUST NOT**
 726     have parameter constraints defined.
 727
 728 .. req::
 729     :id: R-13194
 730     :target: VNF
 731     :keyword: MUST NOT
 732     :validation_mode: static
 733     :updated: casablanca
 734
 735     A VNF's Heat Orchestration Template's ``OS::Nova::Server`` resource
 736     property
 737     ``metadata`` key/value pair ``environment_context`` **MUST NOT**
 738     be enumerated in the Heat Orchestration Template's environment file.
 739
 740 The 'environment_context' parameter value will be defined by the
 741 service designer as part of the service model during the SDC
 742 on-boarding process and will be supplied to the Heat Orchestration
 743 Template by ONAP at orchestration time.
 744
 745
 746 *Example Parameter Definition*
 747
 748 .. code-block:: yaml
 749
 750   parameters:
 751     environment_context:
 752       type: string
 753       description: Environment Context for this VNF instance
 754
 755
 756 *Example OS::Nova::Server with metadata*
 757
 758 .. code-block:: yaml
 759
 760   resources:
 761     . . .
 762
 763     {vm-type}_server_{index}:
 764        type: OS::Nova::Server
 765        properties:
 766          name:
 767          flavor:
 768          image:
 769         ...
 770        metadata:
 771           vnf_name: { get_param: vnf_name }
 772           vnf_id: { get_param: vnf_id }
 773           vf_module_name: { get_param: vf_module_name }
 774           vf_module_id: { get_param: vf_module_id }
 775           workload_context: {get_param: workload_context}
 776           environment_context: {get_param: environment_context }