docs/parser_docs/intro/intro.rst

   1 ..
   2  This work is licensed under a Creative Commons Attribution 3.0 Unported
   3  License.
   4 ..
   5  http://creativecommons.org/licenses/by/3.0/legalcode
   6
   7 ============================
   8 Introduction of Parser Project
   9 ============================
  10
  11 In NFV, various templates (such as descriptors, records and so on) are utilized
  12 to describe the deployment requirements (such as basic VM requirements – vCPU,
  13 memory, storage, as well as the NFV acceleration management requirement such as
  14 Huge Pages support, SR-IOV, NUMA affinity, DPDK support etc.),
  15 the post-instaniation records (such as storage usage report, CPU performance
  16 report etc.) or other purposes. However in order to make these templates
  17 adaptable and feasible for purpose like deployment orchestration/automation,
  18 certain tooling mechanism that provides template translation is necessary.
  19
  20 Project Parser will help to provide such tooling mechanism, by parsing Telecom
  21 operators’ descriptors/records into TOSCA/CAMP templates and then further
  22 translate TOSCA/CAMP templates into certain common templates, which could be
  23 used in IaaS orchestration projects like OpenStack Heat.
  24
  25 For Release B, Parser offers the following capabilities:
  26
  27 * Integration of Heat-Translator Liberty release code. (both heat in-tree code and standalone package are provided)
  28
  29 * Yang2Tosca module which offers the capability to translate yang based
  30 scriptors to tosca formate templates. Users could further use Heat-translator
  31 module to translate this tosca template to Heat Orchestration template.
  32 Yang2Tosca module could be installed seperately after user installed
  33 OPNFV B release platform.
  34
  35 * The "parser_new_keywords" document demonstrate a set of keywords concluded by
  36 Parser team that need to be supported in tosca to heat translation. However
  37 it should be noted that these keywords only serve as a roadmap. We will start
  38 from Release C to indicate which specific set of keywords are supported in
  39 Parser.
  40
  41 * The "vRNC_tosca_intro" document describes Parser's use case analysis on vRNC scenario.
  42 The "example" folder contains examples of tosca-nfv standard and vRNC scenario.
  43 See also https://wiki.opnfv.org/parser.