docs/Chapter8/TOSCA-model.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 TOSCA model
   6 -----------
   7
   8 Table D1. ONAP Resource DM TOSCA/YAML constructs
   9 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  10
  11 Standard TOSCA/YAML definitions agreed by VNF SDK Modeling team to be used by
  12 VNF vendors to create a standard VNF descriptor.
  13
  14 All definitions are summarized in the table below based on the agreed ONAP
  15 Resource DM TOSCA/YAML constructs for Beijing. Their syntax is specified in
  16 ETSI GS NFV-SOL001 stable draft for VNF-D.
  17
  18 +------------+------------------------------+---------------------------------+
  19 | Requirement| Resource IM Info Elements    | TOSCA Constructs as per SOL001  |
  20 | Number     |                              |                                 |
  21 +============+==============================+=================================+
  22 | R-02454    | VNFD.vnfSoftwareVersion      | For VDU.Compute -               |
  23 |            |                              | tosca.artifacts.nfv.SwImage     |
  24 |            |                              |                                 |
  25 |            | SwImageDesc.Version          | For Virtual Storage -           |
  26 |            |                              | tosca.artifacts.Deployment.Image|
  27 +------------+------------------------------+---------------------------------+
  28 | R-03070    | vnfExtCpd's with virtual     | tosca.nodes.nfv.VnfExtCp with a |
  29 |            | NetworkInterfaceRequirements | property tosca.datatypes.nfv.\  |
  30 |            | (vNIC)                       | VirtualNetworkInterface\        |
  31 |            |                              | Requirements                    |
  32 +------------+------------------------------+---------------------------------+
  33 | R-09467    | VDU.Compute descriptor       | tosca.nodes.nfv.Vdu.Compute     |
  34 +------------+------------------------------+---------------------------------+
  35 | R-16065    | VDU.Compute. Configurable    | tosca.datatypes.nfv.Vnfc        |
  36 |            | Properties                   | ConfigurableProperties          |
  37 +------------+------------------------------+---------------------------------+
  38 | R-30654    | VNFD.lifeCycleManagement     | Interface construct tosca.\     |
  39 |            | Script - IFA011 LifeCycle\   | interfaces.nfv.vnf.lifecycle.Nfv|
  40 |            | ManagementScript             | with a list of standard LCM     |
  41 |            |                              | operations                      |
  42 +------------+------------------------------+---------------------------------+
  43 | R-35851    | CPD: VduCp, VnfExtCp,        | tosca.nodes.nfv.VduCp, tosca.\  |
  44 |            | VnfVirtualLinkDesc, QoS      | nodes.nfv.VnfVirtualLink,       |
  45 |            | Monitoring info element  -   | tosca.nodes.nfv.VnfExtCp        |
  46 |            | TBD                          |                                 |
  47 +------------+------------------------------+---------------------------------+
  48 | R-41215    | VNFD/VDU Profile and scaling | tosca.datatypes.nfv.VduProfile  |
  49 |            | aspect                       | and tosca.datatypes.nfv.\       |
  50 |            |                              | ScalingAspect                   |
  51 +------------+------------------------------+---------------------------------+
  52 | R-66070    |  VNFD meta data              | tosca.datatypes.nfv.            |
  53 |            |                              | VnfInfoModifiableAttributes -   |
  54 |            |                              | metadata?                       |
  55 +------------+------------------------------+---------------------------------+
  56 | R-96634    | VNFD.configurableProperties  | tosca.datatypes.nfv.Vnf\        |
  57 |            | describing scaling           | ConfigurableProperties,         |
  58 |            | characteristics.  VNFD.\     | tosca.datatypes.nfv.ScaleInfo   |
  59 |            | autoscale defines the rules  |                                 |
  60 |            | for scaling based on specific|                                 |
  61 |            | VNF  indications             |                                 |
  62 +------------+------------------------------+---------------------------------+
  63 | ?          |  VDU Virtual Storage         | tosca.nodes.nfv.Vdu.\           |
  64 |            |                              | VirtualStorage                  |
  65 +------------+------------------------------+---------------------------------+
  66 | R-01478    | Monitoring Info Element (TBD)| tosca.capabilities.nfv.Metric - |
  67 |            | - SOL001 per VNF/VDU/VLink   | type for monitoring             |
  68 | R-01556    | memory-consumption,          |                                 |
  69 |            | CPU-utilization,             | monitoring_parameter  of above  |
  70 |            | bandwidth-consumption, VNFC  | type per VNF/VDU/VLink          |
  71 |            | downtime, etc.               |                                 |
  72 +------------+------------------------------+---------------------------------+
  73
  74
  75 Table D2. TOSCA CSAR structure
  76 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  77
  78 This section defines the requirements around the CSAR structure.
  79
  80 The table below describes the numbered requirements for CSAR structure as
  81 agreed with SDC. The format of the CSAR is specified in SOL004.
  82
  83 +------------+-------------------------------------+--------------------------+
  84 | Requirement| Description                         | CSAR artifact directory  |
  85 | Number     |                                     |                          |
  86 +============+=====================================+==========================+
  87 | R-26881    | The VNF provider MUST provide the   | ROOT\\Artifacts\         |
  88 |            | binaries and images needed to       | \\VNF_Image.bin          |
  89 |            | instantiate the VNF (VNF and VNFC   |                          |
  90 |            | images).                            |                          |
  91 +------------+-------------------------------------+--------------------------+
  92 | R-30654    | VNFD.lifeCycleManagementScript that | ROOT\\Artifacts\         |
  93 |            | includes a list of events and       | \\Informational\         |
  94 |            | corresponding management scripts    | \\Install.csh            |
  95 |            | performed for the VNF - SOL001      |                          |
  96 +------------+-------------------------------------+--------------------------+
  97 | R-35851    | All VNF topology related definitions| ROOT\\Definitions\       |
  98 |            | in yaml files VNFD/Main Service     | \\VNFC.yaml              |
  99 |            | template at the ROOT                |                          |
 100 |            |                                     | ROOT\                    |
 101 |            |                                     | \\MainService\           |
 102 |            |                                     | \\Template.yaml          |
 103 +------------+-------------------------------------+--------------------------+
 104 | R-40827    | CSAR License directory - SOL004     | ROOT\\Licenses\          |
 105 |            |                                     | \\License_term.txt       |
 106 +------------+-------------------------------------+--------------------------+
 107 | R-77707    | CSAR Manifest file - SOL004         | ROOT\                    |
 108 |            |                                     | \\MainServiceTemplate.mf |
 109 +------------+-------------------------------------+--------------------------+
 110
 111