docs/Chapter5/Heat/ONAP Heat Support of Environment Files.rst

   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 .. _ONAP Heat Support of Environment Files:
   6
   7 ONAP Heat Support of Environment Files
   8 -----------------------------------------
   9
  10 The use of an environment file in OpenStack is optional.  In ONAP, it is
  11 mandatory. A Heat Orchestration Template uploaded to ONAP must have a
  12 corresponding environment file, even if no parameters are required to
  13 be enumerated.
  14
  15 *(Note that ONAP does not programmatically enforce the use of
  16 an environment file.)*
  17
  18 As stated in :need:`R-38474`, :need:`R-81725`, and :need:`R-53433`:
  19
  20   * A VNF's Base Module **MUST** have a corresponding Environment File.
  21   * A VNF's Incremental Module **MUST** have a corresponding Environment File.
  22   * A VNF's Cinder Volume Module **MUST** have a corresponding environment File.
  23
  24 A nested heat template must not have an environment file; OpenStack does
  25 not support it.
  26
  27 The environment file must contain parameter values for the ONAP
  28 Orchestration Constants and VNF Orchestration Constants. These
  29 parameters are identical across all instances of a VNF type, and
  30 expected to change infrequently. The ONAP Orchestration Constants are
  31 associated with OS::Nova::Server image and flavor properties (See
  32 :ref:`Property image` and :ref:`Property flavor`). Examples of VNF
  33 Orchestration Constants are the networking parameters associated
  34 with an internal network (e.g., private IP ranges) and Cinder
  35 volume sizes.
  36
  37 The environment file must not contain parameter values for parameters
  38 that are instance specific (ONAP Orchestration Parameters, VNF
  39 Orchestration Parameters). These parameters are supplied to the Heat by
  40 ONAP at orchestration time.
  41
  42 SDC Treatment of Environment Files
  43 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  44
  45 Parameter values enumerated in the environment file are used by SDC as
  46 the default value. However, the SDC user may use the SDC GUI to
  47 overwrite the default values in the environment file.
  48
  49 SDC generates a new environment file for distribution to SO based on
  50 the uploaded environment file and the user provided GUI updates. The
  51 user uploaded environment file is discarded when the new file is
  52 created. Note that if the user did not change any values via GUI
  53 updates, the SDC generated environment file will contain the same values
  54 as the uploaded file.
  55
  56 Use of Environment Files when using OpenStack "heat stack-create" CLI
  57 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  58
  59 When ONAP is instantiating the Heat Orchestration Template, certain
  60 parameter must not be enumerated in the environment file. This document
  61 provides the details of what parameters should not be enumerated.
  62
  63 If the Heat Orchestration Template is to be instantiated from the
  64 OpenStack Command Line Interface (CLI) using the command "heat
  65 stack-create", all parameters must be enumerated in the environment
  66 file.
  67