YAML v1.2: CSAR zip without TOSCA-Metadata directory clarification

["Nguyenphu, Thinh (Nokia - US/Dallas)" <thinh.nguyenphu@nokia.com>]

Hello,

I may discover an inconsistence within TOSCA YAML v1.2 and v1.3

 

https://docs.oasis-open.org/tosca/TOSCA-Simple-Profile-YAML/v1.2/os/TOSCA-Simple-Profile-YAML-v1.2-os.html#_Toc528072962

 

states The CSAR-Version is defined by the template_version metadata section. In 6.3

 

6.3 Archive without TOSCA-Metadata

In case the archive doesn’t contains a TOSCA-Metadata directory the archive is required to contains a single YAML file at the root of the archive (other templates may exits in sub-directories).

This file must be a valid TOSCA definitions YAML file with the additional restriction that the metadata section (as defined in 3.9.3.2) is required and template_name and template_version metadata are also required.

TOSCA processors should recognized this file as being the CSAR Entry-Definitions file. The CSAR-Version is defined by the template_version metadata section. The Created-By value is defined by the template_author metadata.

6.3.1 Example

The following represents a valid TOSCA template file acting as the CSAR Entry-Definitions file in an archive without TOSCA-Metadata directory.

tosca_definitions_version: tosca_simple_yaml_1_1

 

metadata:

  template_name: my_template

  template_author: OASIS TOSCA TC

  template_version: 1.0

 

but in 3.10.3.5 template_version

This optional metadata keyname can be used to declare a domain specific version of the service template as a single-line string value.

3.10.3.5.3 Example

template_version: 2.0.17

 

 

In YAML v1.2 or 1.3, there is two different version numbers. For the case of Archive without TOSCA-Metadata, the template_version: 1.0. Whereas, CSAR with TOSCA-Metadata directory, the CSAR-Version: 1.1

 

So, what is template_version the CSAR version for both type of CSAR structure?  What is normative requirement and value for template_version?

 

Regards,

Thinh

 

 

Thinh Nguyenphu

Bell Labs CTO

Nokia

thinh.nguyenphu@nokia.com

+1 817-313-5189