1 Problem Statement

Motivation

To perform an indepth analysis of the current TOSCA types as defined and supported in SDC, and use it as input for the feasibility assessement and requirement analysis for implementing ONAP Generic Tosca Parser to be used by different consumers in run time dealing with TOSCA CSARs packages either externally onboarded via External API or internally distributed from SDC.

Analysis input

Mainly focus on the TOSCA types currently included and used in SDC which can be found  in https://gerrit.onap.org/r/gitweb?p=sdc.git;a=tree;f=catalog-be/src/main/resources/import/tosca;hb=refs/heads/master,  except the heat-types (directory)

References

The analysis is based on the following specifications :

[TOSCA-YAML-1.2]  TOSCA Simple Profile YAML 1.2 Referecne:  http://docs.oasis-open.org/tosca/TOSCA-Simple-Profile-YAML/v1.2/TOSCA-Simple-Profile-YAML-v1.2.html  

[SOL001]                   ESTI NFV-SOL 001 V2.5.1 Reference: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/001/02.05.01_60/gs_NFV-SOL001v020501p.pdf  

                                                           https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/001/02.05.01_60/gs_NFV-SOL001v020501p0.zip (YAML definitions)

[TOSCA-NFV]            TOSCA Simple Profile YAML NFV 1.0 Referecne:  http://docs.oasis-open.org/tosca/tosca-nfv/v1.0/tosca-nfv-v1.0.html   

Note: (According to shitao liTOSCA-NFV's conent has already been incorporated by the early version of  [SOL001], and no longer being updated).

Methodology: Analysis by different types

• annotation-types
• artifact-types
• capability-types
• categories
• data-types
• group-types
• interface-lifecycle-types
• nfv-types
• normative-types
• policy-types
• relationship-types

2 Analysis Output

According to the analysis results, the model problems found can be summarized into four categories:

• A :  Not comply with tosca grammar 
  This classification is used to record types that don't comply with the basic tosca  syntax specification
• B1:  Not comply with existing TOSCA-simple-YAML-1.2
• B2: Not comply with existing SOL001-v2.5.1
  Type definitions quite like the types which defined in specification, but still have some difference， such as base type difference, property difference, etc
• C:  SDC private extension 
  This classification is used to record SDC private extension 
  
  
• D:  Use Case private extension
  This classification is used to record  the extension types which used to support specific use case 

2.1 Analysis Statistics and Suggestion

org.openecomp.annotations.Source:
    description: Indicates the origin source of an input
    properties:
        source_type:
          type: string
        vf_module_label:
          type: list
          description: List of VF Modules this input was originated from
          entry_schema:
            type: string
        param_name:
            type: string
            description: Source parameter name

2.2 Options to fix the above issues

2.3 Considerations for TIDM Design and Generic Parser Implementation

The rules for designing TIDM and implementing generic parser have to be considered and decided in Dublin release, e.g.,

1. Compliant with TOSCA standards, so that Issue A and B1 have to be avoided
2. Compliant with ETSI NFV SOL standards, i.e. B2 should align with the SOL001 spec
3. C should be covered and priortized by TIDM
4. D should be covered and priortized by TIDM

All the existing Data model should be managed and published by modeling subcommittee，and modeling subcommittee also need consider how to manage the different version of model.