Metadata Elements

Version

tosca_definitions_version is a top level element of the Service Template which is used to specify the version of TOSCA to be used.

Use tosca_simple_unfurl_1_0_0 to enable Unfurl extensions or the standard tosca_simple_yaml_1_3.

Example

tosca_definitions_version: tosca_simple_unfurl_1_0_0

node_templates:
    ...

The version declaration must be included in the main service template file.

Description

This optional element provides a means to include single or multiline description of the template.

Example

description: >

This is an example of a multi-line description using YAML. It permits line

  breaks for easier readability...

Metadata

metadata allows a declaration of a map of key to string values or, as an Unfurl extension, any JSON type. It is used to associate domain-specific metadata with the Service Template.

Example

metadata:

  creation_date: 2015-04-14
  date_updated: 2015-05-01
  status: developmental

While this is just an example, it is recommended that you set the following metadata:

metadata:

 template_name: example
 template_author: <author>
 template_version: 1.0.0

DSL Definitions

dsl_definitions section can be used to define arbitrary data structures that can then be reused in different parts of the service templates using YAML anchors and aliases.