diff --git a/.gitlab-ci.yml b/.gitlab-ci.yml new file mode 100644 index 0000000000000000000000000000000000000000..8728a5200e5b35a13d0fa721c1420c0c488382f5 --- /dev/null +++ b/.gitlab-ci.yml @@ -0,0 +1,48 @@ +# CI/CD: +# * branch Continuously Builds & Push TOSCA parser image + +#image: docker:latest + +#services: +# - docker:dind + +variables: + GIT_DEPTH: "3" + +stages: + - build + - test + +build-tosca-toolbox: + stage: build + script: + - echo "Building Cloudnet-TOSCA-toolbox image..." + - ./scripts/build_tosca_parser.sh -v "Cloudnet-TOSCA-toolbox" + - echo "Build finished" + +build-tosca-puccini: + stage: build + script: + - echo "Building Puccini image..." + - ./scripts/build_tosca_parser.sh -v "Puccini" + - echo "Build finished" + +test-definitions-cloudnet: + stage: test + script: + - echo "Parsing TOSCA definitions" + - ./scripts/parse_tosca_definitions.sh -v "Cloudnet-TOSCA-toolbox" + artifacts: + when: always + paths: + - debugCloudnet.log + +test-definitions-puccini: + stage: test + script: + - echo "Parsing TOSCA definitions" + - ./scripts/parse_tosca_definitions.sh -v "Puccini" + artifacts: + when: always + paths: + - debugPuccini.log diff --git a/Example-data/example_A.10-01.yaml b/Example-data/example_A.10-01.yaml new file mode 100644 index 0000000000000000000000000000000000000000..740cae5758884356801003fa721f37cee2e551bc --- /dev/null +++ b/Example-data/example_A.10-01.yaml @@ -0,0 +1,69 @@ +# A.10-01.yaml +tosca_definitions_version: tosca_simple_yaml_1_3 + +description: the service template of a PNFD + +imports: + - etsi_nfv_sol001_pnfd_types.yaml + +node_types: + MyCompany.examplePnf.1_0: + derived_from: tosca.nodes.nfv.PNF + properties: + descriptor_id: + type: string + constraints: [ equal: b1bb0ce7-ebca-4fa7-95ed-4840d70a2233 ] + default: b1bb0ce7-ebca-4fa7-95ed-4840d70a2233 + function_description: + type: string + constraints: [ equal: an example PNF ] + default: an example PNF + provider: + type: string + constraints: [ equal: MyCompany ] + default: MyCompany + version: + type: string + constraints: [ equal: '1.0' ] + default: '1.0' + descriptor_invariant_id: + type: string + constraints: [ equal: 1111-2222-ccaa-bbdd ] + default: 1111-2222-ccaa-bbdd + name: + type: string + constraints: [ equal: ExamplePnf ] + default: ExamplePnf + requirements: + - virtual_link: + capability: tosca.capabilities.nfv.VirtualLinkable + +topology_template: + substitution_mappings: + node_type: MyCompany.examplePnf.1_0 + requirements: + virtual_link: [ pnfExtCp_1, external_virtual_link ] + + node_templates: + pnf_mainPart: + type: MyCompany.examplePnf.1_0 + properties: + descriptor_id: b1bb0ce7-ebca-4fa7-95ed-4840d70a2233 + function_description: an example PNF + provider: MyCompany + version: '1.0' + descriptor_invariant_id: 1111-2222-ccaa-bbdd + name: ExamplePnf + + pnfExtCp_1: + type: tosca.nodes.nfv.PnfExtCp + properties: + trunk_mode: false + layer_protocols: [ ipv4 ] + role: leaf + description: External connection point to access this pnf + requirements: + # - external_virtual_link: + - dependency: pnf_mainPart + + diff --git a/Example-data/example_A.11-MyExampleNs.yaml b/Example-data/example_A.11-MyExampleNs.yaml new file mode 100644 index 0000000000000000000000000000000000000000..26b27c0da8f90dcb0b6ac4c613fa76198b8b3128 --- /dev/null +++ b/Example-data/example_A.11-MyExampleNs.yaml @@ -0,0 +1,31 @@ +# A.11-MyExampleNs.yaml +tosca_definitions_version: tosca_simple_yaml_1_3 + +description: my service +imports: + - etsi_nfv_sol001_nsd_types.yaml + - MyExampleNs_Type.yaml # contains the NS node type definition + + +topology_template: + inputs: + flavour_id: + type: string + description: NS deployment flavour selected by the consumer. It is provided in the SOL005 API + + node_templates: + myexampleNs: + type: tosca.MyExampleNS + directives: + - substitute + properties: + descriptor_id: b1bb0ce7-ebca-4fa7-95ed-4840d70a1177 + designer: MyCompany + name: ExampleService + version: '1.0' + invariant_id: 1111-2222-aaaa-bbbb + flavour_id: {get_input: flavour_id } + + # requirements: + #- virtual_link # mapped in lower-level templates + diff --git a/Example-data/example_A.11-MyExampleNs_Type.yaml b/Example-data/example_A.11-MyExampleNs_Type.yaml new file mode 100644 index 0000000000000000000000000000000000000000..897bd0bb3717543bac19862e4f21f917a3b84788 --- /dev/null +++ b/Example-data/example_A.11-MyExampleNs_Type.yaml @@ -0,0 +1,63 @@ +# A.11-MyExampleNs_Type.yaml +tosca_definitions_version: tosca_simple_yaml_1_3 + +description: type definition of tosca.MyExampleNS + +imports: + - etsi_nfv_sol001_nsd_types.yaml # all of TOSCA NSD types as defined in ETSI GS NFVSOL 001 + +data_types: + MyCompany.datatypes.nfv.NsInstantiateNsAdditionalParameters: + derived_from: tosca.datatypes.nfv.NsOperationAdditionalParameters + properties: + parameter_1: + type: string + required: true + default: value_1 + parameter_2: + type: string + required: true + default: value_2 + +node_types: + tosca.MyExampleNS: + derived_from: tosca.nodes.nfv.NS + properties: + descriptor_id: + type: string + constraints: [ valid_values: [ b1bb0ce7-ebca-4fa7-95ed-4840d70a1177 ] ] + default: b1bb0ce7-ebca-4fa7-95ed-4840d70a1177 + designer: + type: string + constraints: [ valid_values: [ MyCompany] ] + default: MyCompany + name: + type: string + constraints: [ valid_values: [ ExampleService ] ] + default: ExampleService + version: + type: string + constraints: [ valid_values: [ '1.0' ] ] + default: '1.0' + invariant_id: + type: string + constraints: [ valid_values: [ 1111-2222-aaaa-bbbb ] ] + default: 1111-2222-aaaa-bbbb + flavour_id: + type: string + constraints: [ valid_values: [ small, big ] ] + default: small + requirements: + - virtual_link: + capability: tosca.capabilities.nfv.VirtualLinkable + relationship: tosca.relationships.nfv.VirtualLinksTo + interfaces: + Nslcm: + type: tosca.interfaces.nfv.Nslcm + operations: + instantiate: + inputs: + additional_parameters: + type: MyCompany.datatypes.nfv.NsInstantiateNsAdditionalParameters + required: false + diff --git a/Example-data/example_A.11-MyExampleNs_big.yaml b/Example-data/example_A.11-MyExampleNs_big.yaml new file mode 100644 index 0000000000000000000000000000000000000000..d08377400f904a0048b2861137b950ec3eb318b7 --- /dev/null +++ b/Example-data/example_A.11-MyExampleNs_big.yaml @@ -0,0 +1,83 @@ +# A.11-MyExampleNs_big.yaml +tosca_definitions_version: tosca_simple_yaml_1_3 + +description: myExampleNs with big flavour +imports: + - etsi_nfv_sol001_nsd_types.yaml # all of TOSCA NSD types as defined in ETSI GS NFVSOL 001 + - MyExampleNs_Type.yaml # contains the NS node type definition + - example_VNF1.yaml # uri of the yaml file which contains the tosca.nodes.nfv.example_VNF1 node type definition, this file might be included in the NSD file structure + - example_VNF2.yaml # uri of the yaml file which contains the tosca.nodes.nfv.example_VNF2 node type definition, this file might be included in the NSD file structure + - example_VNF3.yaml # uri of the yaml file which contains the tosca.nodes.nfv.example_VNF3 node type definition, this file might be included in the NSD file structure + +topology_template: + substitution_mappings: + node_type: tosca.MyExampleNS + substitution_filter: + properties: + - flavour_id: { equal: big } + requirements: + virtual_link: [ VNF_1, virtual_link_2 ] + + node_templates: + MyExampleNS: + type: tosca.MyExampleNS + # properties: + # + interfaces: + Nslcm: + operations: + instantiate: + implementation: instantiate.workflow.yaml + terminate: + implementation: terminate.workflow.yaml + scale: + implementation: scale.workbook.yaml + + VNF_1: + type: tosca.nodes.nfv.example_VNF1 + properties: + # no property assignments needed for required properties that have a default value assigned in the node type definition, e.g. descriptor_id + flavour_id: simple + vnf_profile: + instantiation_level: level_1 + min_number_of_instances: 2 + max_number_of_instances: 6 + requirements: + - virtual_link_1: Ns_VL + # - virtual_link_2: # map to virtual_link requirement of the NS node + + VNF_2: + type: tosca.nodes.nfv.example_VNF2 + properties: + flavour_id: simple + vnf_profile: + instantiation_level: level_1 + min_number_of_instances: 1 + max_number_of_instances: 3 + requirements: + - virtual_link_1: Ns_VL + + VNF_3: + type: tosca.nodes.nfv.example_VNF3 + properties: + flavour_id: simple + vnf_profile: + instantiation_level: level_1 + min_number_of_instances: 1 + max_number_of_instances: 3 + requirements: + - virtual_link_1: Ns_VL + + Ns_VL: + type: tosca.nodes.nfv.NsVirtualLink + properties: + connectivity_type: + layer_protocols: [ipv4] + flow_pattern: mesh + vl_profile: + max_bitrate_requirements: + root: 1000 + min_bitrate_requirements: + root: 1000 + + diff --git a/Example-data/example_A.11-MyExampleNs_small.yaml b/Example-data/example_A.11-MyExampleNs_small.yaml new file mode 100644 index 0000000000000000000000000000000000000000..0d2025e7c26f245f4b5f322c0bde994a4f5170e1 --- /dev/null +++ b/Example-data/example_A.11-MyExampleNs_small.yaml @@ -0,0 +1,69 @@ +# A.11-MyExampleNs_small.yaml +tosca_definitions_version: tosca_simple_yaml_1_3 + +description: myExampleNs with small flavour +imports: + - etsi_nfv_sol001_nsd_types.yaml # all of TOSCA NSD types as defined in ETSI GS NFVSOL 001 + - MyExampleNs_Type.yaml # contains the NS node type definition + - example_VNF1.yaml # uri of the yaml file which contains the tosca.nodes.nfv.example_VNF1 node type definition, this file might be included in the NSD file structure + - example_VNF2.yaml # uri of the yaml file which contains the tosca.nodes.nfv.example_VNF2 node type definition, this file might be included in the NSD file structure + +topology_template: + substitution_mappings: + node_type: tosca.MyExampleNS + substitution_filter: + properties: + - flavour_id: { equal: small } + requirements: + virtual_link: [ VNF_1, virtual_link_2 ] + + node_templates: + MyExampleNS: + type: tosca.MyExampleNS + # properties: + # + interfaces: + Nslcm: + operations: + instantiate: + implementation: instantiate.workflow.yaml + terminate: + implementation: terminate.workflow.yaml + + VNF_1: + type: tosca.nodes.nfv.example_VNF1 + properties: + # no property assignments needed for required properties that have a default value assigned in the node type definition, e.g. descriptor_id + flavour_id: simple + vnf_profile: + instantiation_level: level_1 + min_number_of_instances: 2 + max_number_of_instances: 6 + requirements: + - virtual_link: Ns_VL + # - virtual_link_2: # map to virtual_link requirement of the NS node + + VNF_2: + type: tosca.nodes.nfv.example_VNF2 + properties: + flavour_id: simple + vnf_profile: + instantiation_level: level_1 + min_number_of_instances: 1 + max_number_of_instances: 3 + requirements: + - virtual_link_1: Ns_VL + + Ns_VL: + type: tosca.nodes.nfv.NsVirtualLink + properties: + connectivity_type: + layer_protocols: [ipv4] + flow_pattern: mesh + vl_profile: + max_bitrate_requirements: + root: 1000 + min_bitrate_requirements: + root: 1000 + + diff --git a/Example-data/example_A.12-01.yaml b/Example-data/example_A.12-01.yaml new file mode 100644 index 0000000000000000000000000000000000000000..9ffee89ac8fc884b003f2b52f1ddd7b5d8d33929 --- /dev/null +++ b/Example-data/example_A.12-01.yaml @@ -0,0 +1,69 @@ +# A.12-01.yaml +tosca_definitions_version: tosca_simple_yaml_1_3 +description: myExampleNs with small flavour + +imports: + - etsi_nfv_sol001_nsd_types.yaml # all of TOSCA NSD types as defined in ETSI GS NFVSOL 001 + - MyExampleNs_TypeBis.yaml # contains the NS node type definition + - MyExampleNS_2.yaml # uri of the yaml file which contains the tosca.myExample.NS_2 node type definition, this file might be included in the NSD file structure of NS_1 + - example_VNF1.yaml # uri of the yaml file which contains the tosca.nodes.nfv.example_VNF1 node type definition, this file might be included in the NSD file structure of NS_1 + +topology_template: + substitution_mappings: + node_type: tosca.MyExampleNS + substitution_filter: + properties: + - flavour_id: { equal: small } + requirements: + virtual_link: [ VNF_1, virtual_link_2 ] + + node_templates: + NS_1: + type: tosca.MyExampleNS + interfaces: + Nslcm: + operations: + instantiate: + implementation: instantiate.workflow.yaml + terminate: + implementation: terminate.workflow.yaml + + VNF_1: + type: tosca.nodes.nfv.example_VNF1 + properties: + # no property assignments needed for required properties that have a default value assigned in the node type definition, e.g. descriptor_id + flavour_id: simple + vnf_profile: + instantiation_level: level_1 + min_number_of_instances: 2 + max_number_of_instances: 6 + requirements: + - virtual_link_1: NS_VL_1 + # - virtual_link_2: # map to virtual_link requirement of the NS node + + NS_2: + type: tosca.myExample.NS_2 + properties: + descriptor_id: c1bb0ab8-deab-4fa7-95ed-4840d70a3574 + designer: MyCompany + version: 1.0.0.0 + name: myExample2Service + invariant_id: aaaa-bbbb-cccc-dddd + ns_profile: + ns_instantiation_level: level_1 + min_number_of_instances: 1 + max_number_of_instances: 3 + flavour_id: simple + + NS_VL_1: + type: tosca.nodes.nfv.NsVirtualLink + properties: + connectivity_type: + layer_protocols: [ipv4] + flow_pattern: mesh + vl_profile: + max_bitrate_requirements: + root: 1000 + min_bitrate_requirements: + root: 1000 + diff --git a/Example-data/example_A.12-MyExampleNS_2.yaml b/Example-data/example_A.12-MyExampleNS_2.yaml new file mode 100644 index 0000000000000000000000000000000000000000..28c10dfaf77f00e710e6123f3c4747295574e39b --- /dev/null +++ b/Example-data/example_A.12-MyExampleNS_2.yaml @@ -0,0 +1,94 @@ +# A.12-MyExampleNS_2.yaml +tosca_definitions_version: tosca_simple_yaml_1_3 + +description: Relational database, simple + +imports: + - etsi_nfv_sol001_nsd_types.yaml # all of NSD related TOSCA types as defined in ETSI GS NFVSOL 001 + - example_VNF3.yaml # uri of the yaml file which contains the definition of tosca.nodes.nfv.example_VNF3, this file might be included in the NSD file structure + - example_VNF4.yaml # uri of the yaml file which contains the definition of tosca.nodes.nfv.example_VNF4, this file might be included in the NSD file structure + +node_types: + tosca.myExample.NS_2: + derived_from: tosca.nodes.nfv.NS + properties: + descriptor_id: + type: string + constraints: [ valid_values: [ c1bb0ab8-deab-4fa7-95ed-4840d70a3574 ] ] + default: c1bb0ab8-deab-4fa7-95ed-4840d70a3574 + designer: + type: string + constraints: [ valid_values: [ MyCompany] ] + default: MyCompany + name: + type: string + constraints: [ valid_values: [ myExample2Service ] ] + default: myExample2Service + version: + type: string + constraints: [ valid_values: [ '1.0.0.0' ] ] + default: '1.0.0.0' + invariant_id: + type: string + constraints: [ valid_values: [ aaaa-bbbb-cccc-dddd ] ] + default: aaaa-bbbb-cccc-dddd + flavour_id: + type: string + constraints: [ valid_values: [ simple ] ] + default: simple + +topology_template: + substitution_mappings: + node_type: tosca.myExample.NS_2 + requirements: + virtual_link: [ VNF_4, virtual_link_2 ] # the External connection point of + # VNF_2 is exposed as the Sap + + node_templates: + NS_2: + type: tosca.myExample.NS_2 + interfaces: + Nslcm: + operations: + instantiate: + implementation: instantiate.workflow.yaml + terminate: + implementation: terminate.workflow.yaml + + VNF_3: + type: tosca.nodes.nfv.example_VNF3 + properties: + # no property assignments needed for required properties that have a default value assigned in the node type definition, e.g. descriptor_id + flavour_id: simple + vnf_profile: + instantiation_level: level_1 + min_number_of_instances: 2 + max_number_of_instances: 6 + requirements: + - virtual_link: NS_VL_2 + + VNF_4: + type: tosca.nodes.nfv.example_VNF4 + properties: + flavour_id: simple + vnf_profile: + instantiation_level: level_1 + min_number_of_instances: 1 + max_number_of_instances: 3 + requirements: + - virtual_link_1: NS_VL_2 + # - virtual_link_2: # map to virtual_link requirement of the NS node + + NS_VL_2: + type: tosca.nodes.nfv.NsVirtualLink + properties: + connectivity_type: + layer_protocols: [ipv4] + flow_pattern: mesh + vl_profile: + max_bitrate_requirements: + root: 1000 + min_bitrate_requirements: + root: 1000 + + diff --git a/Example-data/example_A.12-MyExampleNs_TypeBis.yaml b/Example-data/example_A.12-MyExampleNs_TypeBis.yaml new file mode 100644 index 0000000000000000000000000000000000000000..027af066477b5cd76093596c9cdd05e73446bd0e --- /dev/null +++ b/Example-data/example_A.12-MyExampleNs_TypeBis.yaml @@ -0,0 +1,44 @@ +# A.12-MyExampleNs_TypeBis.yaml +tosca_definitions_version: tosca_simple_yaml_1_3 + +description: type definition of tosca.MyExampleNS + +imports: + - etsi_nfv_sol001_nsd_types.yaml # all of TOSCA types as defined in ETSI GS NFVSOL 001 + +node_types: + tosca.MyExampleNS: + derived_from: tosca.nodes.nfv.NS + properties: + descriptor_id: + type: string + constraints: [ valid_values: [ b1bb0ce7-ebca-4fa7-95ed-4840d70a1177 ] ] + default: b1bb0ce7-ebca-4fa7-95ed-4840d70a1177 + designer: + type: string + constraints: [ valid_values: [ MyCompany] ] + default: MyCompany + name: + type: string + constraints: [ valid_values: [ ExampleService ] ] + default: ExampleService + version: + type: string + constraints: [ valid_values: [ '1.0' ] ] + default: '1.0' + invariant_id: + type: string + constraints: [ valid_values: [ 1111-2222-aaaa-bbbb ] ] + default: 1111-2222-aaaa-bbbb + flavour_id: + type: string + constraints: [ valid_values: [ small, big ] ] + default: small + requirements: + - virtual_link: + capability: tosca.capabilities.nfv.VirtualLinkable + relationship: tosca.relationships.nfv.VirtualLinksTo + interfaces: + Nslcm: + type: tosca.interfaces.nfv.Nslcm + diff --git a/Example-data/example_A.12-etsi_nfv_example_vnf4.yaml b/Example-data/example_A.12-etsi_nfv_example_vnf4.yaml new file mode 100644 index 0000000000000000000000000000000000000000..93fabb19c265c7e1ca3d705a88854d69e649e9ff --- /dev/null +++ b/Example-data/example_A.12-etsi_nfv_example_vnf4.yaml @@ -0,0 +1,55 @@ +# A.12-etsi_nfv_example_vnf4.yaml +tosca_definitions_version: tosca_simple_yaml_1_3 + +description: Example VNF4 type + +imports: + - etsi_nfv_sol001_vnfd_types.yaml # all of VNFD types as defined in NFV SOL 001 GS + +node_types: + tosca.nodes.nfv.example_VNF4: + derived_from: tosca.nodes.nfv.VNF + properties: + descriptor_id: + type: string + constraints: [ equal: b1bb0ce7-ebca-4fa7-95ed-4840d70a1184 ] + default: b1bb0ce7-ebca-4fa7-95ed-4840d70a1184 + provider: + type: string + constraints: [ equal: MyCompany ] + default: MyCompany + product_name: + type: string + constraints: [ equal: Example_VNF4 ] + default: Example_VNF4 + software_version: + type: string + constraints: [ equal: '1.0' ] + default: '1.0' + descriptor_version: + type: string + constraints: [ equal: '1.0' ] + default: '1.0' + flavour_id: + type: string + constraints: [ equal: simple ] + default: simple + flavour_description: + type: string + default: "" + vnfm_info: + type: list + entry_schema: + type: string + constraints: [ equal: [ '0:MyCompany-1.0.0' ] ] + default: [ '0:MyCompany-1.0.0' ] + requirements: + - virtual_link_1: + capability: tosca.capabilities.nfv.VirtualLinkable + relationship: tosca.relationships.nfv.VirtualLinksTo + occurrences: [ 1, 1 ] + - virtual_link_2: + capability: tosca.capabilities.nfv.VirtualLinkable + relationship: tosca.relationships.nfv.VirtualLinksTo + occurrences: [ 1, 1 ] + diff --git a/Example-data/example_A.13-01.yaml b/Example-data/example_A.13-01.yaml new file mode 100644 index 0000000000000000000000000000000000000000..a93cad7a73c1b72829536a58239ef0f1242f2a2e --- /dev/null +++ b/Example-data/example_A.13-01.yaml @@ -0,0 +1,126 @@ +# A.13-01.yaml +tosca_definitions_version: tosca_simple_yaml_1_3 +description: Relational database, simple +imports: + - etsi_nfv_sol001_vnfd_types.yaml # all of TOSCA VNFD types as defined in ETSI GS NFVSOL 001 for a VNFD + +node_types: + MyCompany.SunshineDB.1_0.1_0: + derived_from: tosca.nodes.nfv.VNF + properties: + descriptor_id: + type: string + constraints: [ equal: b1bb0ce7-ebca-4fa7-95ed-4840d70a1177 ] + default: b1bb0ce7-ebca-4fa7-95ed-4840d70a1177 + provider: + type: string + constraints: [ equal: MyCompany ] + default: MyCompany + product_name: + type: string + constraints: [ equal: SunshineDB ] + default: SunshineDB + software_version: + type: string + constraints: [ equal: '1.0' ] + default: '1.0' + descriptor_version: + type: string + constraints: [ equal: '1.0' ] + default: '1.0' + flavour_id: + type: string + constraints: [ valid_values: [ simple ] ] + default: simple + flavour_description: + type: string + default: "" + vnfm_info: + type: list + entry_schema: + type: string + constraints: [ equal: [ '0:MyCompany-1.0.0' ] ] + default: [ '0:MyCompany-1.0.0' ] + interfaces: + Vnflcm: + operations: + instantiate: {} + terminate: {} + requirements: + - virtual_link: + capability: tosca.capabilities.nfv.VirtualLinkable + relationship: tosca.relationships.nfv.VirtualLinksTo + occurrences: [ 0, 1 ] + - virtual_link_vip: + capability: tosca.capabilities.nfv.VirtualLinkable + relationship: tosca.relationships.nfv.VipVirtualLinksTo + occurrences: [ 0, 1 ] + +topology_template: + substitution_mappings: + node_type: MyCompany.SunshineDB.1_0.1_0 + requirements: + virtual_link: [ Vdu-A-Cp, virtual_link ] + virtual_link_vip: [ VipCp, virtual_link ] + + node_templates: + SunshineDB: + type: MyCompany.SunshineDB.1_0.1_0 + # properties: + # omitted for brevity + # interfaces: + # omitted for brevity + + VDU-A: + type: tosca.nodes.nfv.Vdu.Compute + properties: + name: VDU-A + description: VDU-A description + vdu_profile: + min_number_of_instances: 2 + max_number_of_instances: 5 + # other properties omitted for brevity + capabilities: + virtual_compute: + properties: # following properties are required. + virtual_memory: + virtual_mem_size: 1 GB + virtual_cpu: + num_virtual_cpu: 1 + # requirements: + # omitted for brevity + + + Vdu-A-Cp: + type: tosca.nodes.nfv.VduCp + properties: + protocol: [associated_layer_protocol: ipv4 ] + trunk_mode: false + layer_protocols: [ ipv4 ] + role: leaf + description: Internal connection point on an VL + requirements: + - virtual_binding: VDU-A + #- virtual_link: # the target node is determined in the NSD + + + VipCp: + type: tosca.nodes.nfv.VipCp + properties: + vip_function: load_balance + protocol: + - associated_layer_protocol: ipv4 + address_data: + - address_type: ip_address + l3_address_data: + ip_address_assignment: true + floating_ip_activated: false + number_of_ip_address: 1 + trunk_mode: false + layer_protocols: [ ipv4 ] + description: > + Virtual IP connection point. It holds one IP address shared by all instances (between 2 and 5 according to the vdu_profile) of the Vdu-A-Cp node. Floating IP address is not used in the VipCp. Thus, incoming packets are forwarded with unmodified destination address to one of the instances of Vdu-A-Cp. A router external to the VNF with Equal-Cost Multi-Path (ECMP) load balancing functionality is assumed to be properly configured to route the packets accordingly to the available instances applying load balancing, i.e. one packet is only forwarded to one instance. + requirements: + - target: Vdu-A-Cp + # - virtual_link: # the target node is determined in the NSD + diff --git a/Example-data/example_A.13-02.yaml b/Example-data/example_A.13-02.yaml new file mode 100644 index 0000000000000000000000000000000000000000..a9c81efd195e7512502ecead109fbf5e434c2129 --- /dev/null +++ b/Example-data/example_A.13-02.yaml @@ -0,0 +1,163 @@ +# A.13-02.yaml +tosca_definitions_version: tosca_simple_yaml_1_3 +description: Relational database, simple +imports: + - etsi_nfv_sol001_vnfd_types.yaml # all of TOSCA VNFD types as defined in ETSI GS NFVSOL 001 for a VNFD + +node_types: + MyCompany.SunshineDB.1_0.1_0: + derived_from: tosca.nodes.nfv.VNF + properties: + descriptor_id: + type: string + constraints: [ equal: b1bb0ce7-ebca-4fa7-95ed-4840d70a1177 ] + default: b1bb0ce7-ebca-4fa7-95ed-4840d70a1177 + provider: + type: string + constraints: [ equal: MyCompany ] + default: MyCompany + product_name: + type: string + constraints: [ equal: SunshineDB ] + default: SunshineDB + software_version: + type: string + constraints: [ equal: '1.0' ] + default: '1.0' + descriptor_version: + type: string + constraints: [ equal: '1.0' ] + default: '1.0' + flavour_id: + type: string + constraints: [ valid_values: [ simple ] ] + default: simple + flavour_description: + type: string + default: "" + vnfm_info: + type: list + entry_schema: + type: string + constraints: [ equal: [ '0:MyCompany-1.0.0' ] ] + default: [ '0:MyCompany-1.0.0' ] + # interfaces: + # omitted for brevity + requirements: + - virtual_link: + capability: tosca.capabilities.nfv.VirtualLinkable + relationship: tosca.relationships.nfv.VirtualLinksTo + occurrences: [ 0, 1 ] + - virtual_link_sby: + capability: tosca.capabilities.nfv.VirtualLinkable + relationship: tosca.relationships.nfv.VirtualLinksTo + occurrences: [ 0, 1 ] + - virtual_link_vip: + capability: tosca.capabilities.nfv.VirtualLinkable + relationship: tosca.relationships.nfv.VipVirtualLinksTo + occurrences: [ 0, 1 ] + +topology_template: + substitution_mappings: + node_type: MyCompany.SunshineDB.1_0.1_0 + requirements: + virtual_link: [ Vdu-A-Cp, virtual_link ] + virtual_link_sby: [ Vdu-B-Cp, virtual_link ] + virtual_link_vip: [ VipCp, virtual_link ] + + + node_templates: + SunshineDB: + type: MyCompany.SunshineDB.1_0.1_0 + # properties: + # omitted for brevity + # interfaces: + # omitted for brevity + + VDU-A: + type: tosca.nodes.nfv.Vdu.Compute + properties: + name: VDU-A + description: VDU-A description + + vdu_profile: + min_number_of_instances: 1 + max_number_of_instances: 1 + # other properties omitted for brevity + capabilities: + virtual_compute: + properties: # following properties are required. + virtual_memory: + virtual_mem_size: 1 GB + virtual_cpu: + num_virtual_cpu: 1 + + # requirements: + # omitted for brevity + + VDU-B: + type: tosca.nodes.nfv.Vdu.Compute + properties: + name: VDU-B + description: VDU-B description + vdu_profile: + min_number_of_instances: 1 + max_number_of_instances: 1 + # other properties omitted for brevity + capabilities: + virtual_compute: + properties: # following properties are required. + virtual_memory: + virtual_mem_size: 1 GB + virtual_cpu: + num_virtual_cpu: 1 + + # requirements: + # omitted for brevity + + + Vdu-A-Cp: + type: tosca.nodes.nfv.VduCp + properties: + protocol: [associated_layer_protocol: ipv4 ] + trunk_mode: false + layer_protocols: [ ipv4 ] + role: leaf + description: Internal connection point on an VL + requirements: + - virtual_binding: VDU-A + #- virtual_link: # the target node is determined in the NSD + + Vdu-B-Cp: + type: tosca.nodes.nfv.VduCp + properties: + protocol: [associated_layer_protocol: ipv4 ] + trunk_mode: false + layer_protocols: [ ipv4 ] + role: leaf + description: Internal connection point on an VL + requirements: + - virtual_binding: VDU-B + #- virtual_link: # the target node is determined in the NSD + + VipCp: + type: tosca.nodes.nfv.VipCp + properties: + vip_function: high_availability + protocol: + - associated_layer_protocol: ipv4 + address_data: + - address_type: ip_address + l3_address_data: + ip_address_assignment: true + floating_ip_activated: true + number_of_ip_address: 1 + trunk_mode: false + layer_protocols: [ ipv4 ] + description: > + Virtual IP connection point. It holds one IP address shared by the instances of the Vdu-A-Cp and the Vdu-B-Cp nodes (one instance of each). Floating IP address is used. Thus, incoming packets are first NATed to the virtual IP address and then forwarded with the virtual IP address as destination address to the instance of Vdu-A-Cp or Vdu-B-Cp that currently has the address binding. + requirements: + - target: Vdu-A-Cp + - target: Vdu-B-Cp + # - virtual_link: # the target node is determined in the NSD + diff --git a/Example-data/example_A.14-01.yaml b/Example-data/example_A.14-01.yaml new file mode 100644 index 0000000000000000000000000000000000000000..4c827d78fbe7927455f3d4114c424c6b7d2c7826 --- /dev/null +++ b/Example-data/example_A.14-01.yaml @@ -0,0 +1,244 @@ +# A.14-01.yaml +tosca_definitions_version: tosca_simple_yaml_1_3 +description: VNF FG Model for example_NS +imports: + - etsi_nfv_sol001_nsd_types.yaml # all of NSD related TOSCA types as defined in ETSI GS NFVSOL 001 + - example_vnf1.yaml # uri of the yaml file which contains the tosca.nodes.nfv.example_VNF1 node type definition, this file might be included in the NSD file structure + - example_vnf2.yaml # uri of the yaml file which contains the tosca.nodes.nfv.example_VNF2 node type definition, this file might be included in the NSD file structure + - example_vnf3.yaml # uri of the yaml file which contains the tosca.nodes.nfv.example_VNF3 node type definition, this file might be included in the NSD file structure + + +data_types: + MyCompany.datatypes.nfv.NsInstantiateAdditionalParameters: + derived_from: tosca.datatypes.nfv.NsOperationAdditionalParameters + +node_types: + tosca.example_NS: + derived_from: tosca.nodes.nfv.NS + properties: + descriptor_id: + type: string + constraints: [ equal: b1bb0ce7-ebca-4fa7-95ed-4840d70a1177 ] + default: b1bb0ce7-ebca-4fa7-95ed-4840d70a1177 + designer: + type: string + constraints: [ equal: MyCompany ] + default: MyCompany + name: + type: string + constraints: [ equal: ExampleService ] + default: ExampleService + version: + type: string + constraints: [ equal: '1.0' ] + default: '1.0' + invariant_id: + type: string + constraints: [ equal: 1111-2222-aaaa-bbbb ] + default: 1111-2222-aaaa-bbbb + flavour_id: + type: string + constraints: [ equal: simple ] + default: simple + interfaces: + Nslcm: + type: tosca.interfaces.nfv.Nslcm + operations: + instantiate: + inputs: + additional_parameters: + type: MyCompany.datatypes.nfv.NsInstantiateAdditionalParameters + requirements: + - virtual_link: + capability: tosca.capabilities.nfv.VirtualLinkable + occurrences: [ 0, 0 ] + - virtual_link_2: + capability: tosca.capabilities.nfv.VirtualLinkable + relationship: tosca.relationships.nfv.VirtualLinksTo + occurrences: [ 0, 1 ] + - virtual_link_3: + capability: tosca.capabilities.nfv.VirtualLinkable + relationship: tosca.relationships.nfv.VirtualLinksTo + occurrences: [ 0, 1 ] + - virtual_link_4: + capability: tosca.capabilities.nfv.VirtualLinkable + relationship: tosca.relationships.nfv.VirtualLinksTo + occurrences: [ 0, 1 ] + +topology_template: + substitution_mappings: + node_type: tosca.example_NS + requirements: + virtual_link_2: [ VNF_1, virtual_link ] # the requirement of SAP_1 + virtual_link_3: [ VNF_3, virtual_link_3 ] # the requirement of SAP_2 + virtual_link_4: [ VNF_2, virtual_link_4 ] # the requirement of SAP_3 + + node_templates: + my_service: + type: tosca.example_NS + properties: + descriptor_id: b1bb0ce7-ebca-4fa7-95ed-4840d70a1177 + designer: MyCompany + name: ExampleService + # . . . + interfaces: + Nslcm: + operations: + instantiate: + implementation: instantiate.workflow.yaml + terminate: + implementation: terminate.workflow.yaml + + NsVirtualLink_1: + type: tosca.nodes.nfv.NsVirtualLink + properties: + vl_profile: + min_bitrate_requirements: + root: 100000 + max_bitrate_requirements: + root: 200000 + connectivity_type: + layer_protocols: [ ipv4 ] + # . . . + + VNF_1: + type: tosca.nodes.nfv.example_VNF1 + properties: + descriptor_id: b1bb0ce7-2222-4fa7-95ed-4840d70a1179 + descriptor_version: "1.0.0" + # . . . + requirements: + - virtual_link: VNF_1_forward_1 # related to cp_01 in VNF_1 + - virtual_link_2: VNF_1_forward_2 # related to cp_02 in VNF_1 + + VNF_1_forward_1: + type: tosca.nodes.nfv.Forwarding + + + VNF_1_forward_2: + type: tosca.nodes.nfv.Forwarding + requirements: + - virtual_link: NsVirtualLink_1 + + VNF_2: + type: tosca.nodes.nfv.example_VNF2 + properties: + descriptor_id: b1bb0ce7-2222-4fa7-95ed-4840d70a1182 + descriptor_version: "1.0.0" + # . . . + requirements: + - virtual_link: VNF_2_forward_3 # related to cp_03 in VNF_2 + - virtual_link_4: VNF_2_forward_4 # related to cp_04 in VNF_2 + VNF_2_forward_3: + type: tosca.nodes.nfv.Forwarding + + + VNF_2_forward_4: + type: tosca.nodes.nfv.Forwarding + requirements: + - virtual_link: NsVirtualLink_1 + + VNF_3: + type: tosca.nodes.nfv.example_VNF3 + properties: + descriptor_id: b1bb0ce7-2222-4fa7-95ed-4840d70a1177 + descriptor_version: "1.0.0" + # . . . + requirements: + - virtual_link: VNF_3_forward_5 # related to cp_05 in VNF_3 + - virtual_link_3: VNF_3_forward_6 # related to cp_06 in VNF_3 + + VNF_3_forward_5: + type: tosca.nodes.nfv.Forwarding + requirements: + - virtual_link: NsVirtualLink_1 + + VNF_3_forward_6: + type: tosca.nodes.nfv.Forwarding + +# NfpPositionElement (Service Function) for VNF_1 + Element_1: + type: tosca.nodes.nfv.NfpPositionElement + requirements: + - profile_element: + node: VNF_1_forward_1 + capability: forwarding + - profile_element: + node: VNF_1_forward_2 + capability: forwarding + +# NfpPositionElement (Service Function) for VNF_2 + Element_2: + type: tosca.nodes.nfv.NfpPositionElement + requirements: + - profile_element: + node: VNF_2_forward_3 + capability: forwarding + - profile_element: + node: VNF_2_forward_4 + capability: forwarding + +# NfpPositionElement (Service Function) for VNF_3 + Element_3: + type: tosca.nodes.nfv.NfpPositionElement + requirements: + - profile_element: + node: VNF_3_forward_5 + capability: forwarding + - profile_element: + node: VNF_3_forward_6 + capability: forwarding + +# NfpPosition_1 with Element_1 and Element_2 as constituents + NfpPosition_1: + type: tosca.nodes.nfv.NfpPosition + properties: + forwarding_behaviour: lb + requirements: + - element: Element_1 + - element: Element_2 + +# NfpPosition_2 with Element_3 as constituents + NfpPosition_2: + type: tosca.nodes.nfv.NfpPosition + properties: + forwarding_behaviour: all + requirements: + - element: Element_3 + + Nfp_1: + type: tosca.nodes.nfv.NFP + requirements: + - nfp_position: NfpPosition_1 + - nfp_position: NfpPosition_2 + + policies: + - NfpRule_1: + type: tosca.policies.nfv.NfpRule + properties: + ether_destination_address: 00:0a:95:9d:68:16 + ether_source_address: 00:A0:C9:14:C8:29 + ether_type: ipv4 + vlan_tag: + - "10" + - "20" + - "30" + protocol: tcp + dscp: "101111" + source_port_range: [ 5000, 15000 ] + destination_port_range: [ 800, 8080 ] + source_ip_address_prefix: 10.10.10.0 + destination_ip_address_prefix: 125.1.12.111 + extended_criteria: + - starting_point: 3 + length: 4 + value: "1000" + targets: [ Nfp_1 ] + + groups: + VNFFG_1: + type: tosca.groups.nfv.VNFFG + properties: + description: VNF Forwarding Graph for example_NS + members: [ Nfp_1, VNF_1, VNF_2, VNF_3, NsVirtualLink_1, Element_1, Element_2, Element_3 ] + diff --git a/Example-data/example_A.14-example_vnf1.yaml b/Example-data/example_A.14-example_vnf1.yaml new file mode 100644 index 0000000000000000000000000000000000000000..bbfeb553ef1b6827e82b09141ef384cedbb39166 --- /dev/null +++ b/Example-data/example_A.14-example_vnf1.yaml @@ -0,0 +1,89 @@ +# A.14-example_vnf1.yaml +tosca_definitions_version: tosca_simple_yaml_1_3 +description: VNF Descriptor for VNF1 +imports: + - etsi_nfv_sol001_vnfd_types.yaml # all of VNFD related TOSCA types as defined in ETSI GS NFVSOL 001 +node_types: + tosca.nodes.nfv.example_VNF1: + derived_from: tosca.nodes.nfv.VNF + properties: + descriptor_id: + type: string + constraints: [ equal: b1bb0ce7-2222-4fa7-95ed-4840d70a1179 ] + default: b1bb0ce7-2222-4fa7-95ed-4840d70a1179 + provider: + type: string + constraints: [ equal: MyCompany ] + default: MyCompany + product_name: + type: string + constraints: [ equal: Example_VNF1 ] + default: Example_VNF1 + software_version: + type: string + constraints: [ equal: '1.0' ] + default: '1.0' + descriptor_version: + type: string + constraints: [ equal: '1.0' ] + default: '1.0' + flavour_id: + type: string + constraints: [ equal: simple ] + default: simple + flavour_description: + type: string + default: "" + vnfm_info: + type: list + entry_schema: + type: string + constraints: [ equal: [ '0:MyCompany-1.0.0' ] ] + default: [ '0:MyCompany-1.0.0' ] + requirements: + - virtual_link_1: + capability: tosca.capabilities.nfv.VirtualLinkable + relationship: tosca.relationships.nfv.VirtualLinksTo + occurrences: [ 0, 1 ] + - virtual_link_2: + capability: tosca.capabilities.nfv.VirtualLinkable + relationship: tosca.relationships.nfv.VirtualLinksTo + occurrences: [ 0, 1 ] + +topology_template: + substitution_mappings: + node_type: tosca.nodes.nfv.example_VNF1 + requirements: + virtual_link: [ cp_01, external_virtual_link ] + virtual_link_2: [ cp_02, external_virtual_link ] + + node_templates: + cp_01: + type: tosca.nodes.nfv.VnfExtCp + properties: + layer_protocols: [ ipv4 ] + # . . . ...... + requirements: + - internal_virtual_link: intVL-A + cp_02: + type: tosca.nodes.nfv.VnfExtCp + properties: + layer_protocols: [ ipv4 ] + # . . . ...... + requirements: + - internal_virtual_link: intVL-A + + intVL-A: + type: tosca.nodes.nfv.VnfVirtualLink + properties: + connectivity_type: + layer_protocols: [ ipv4 ] + vl_profile: + max_bitrate_requirements: + root: 1000000 + leaf: 100000 + min_bitrate_requirements: + root: 100000 + leaf: 10000 + + diff --git a/Example-data/example_A.14-example_vnf2.yaml b/Example-data/example_A.14-example_vnf2.yaml new file mode 100644 index 0000000000000000000000000000000000000000..22cc39092924006d37239600c153fb3dcc381117 --- /dev/null +++ b/Example-data/example_A.14-example_vnf2.yaml @@ -0,0 +1,93 @@ +# A.14-example_vnf2.yaml +tosca_definitions_version: tosca_simple_yaml_1_3 +description: VNF Descriptor for VNF2 +imports: + - etsi_nfv_sol001_vnfd_types.yaml # all of VNFD related TOSCA types as defined in ETSI GS NFVSOL 001 +node_types: + tosca.nodes.nfv.example_VNF2: + derived_from: tosca.nodes.nfv.VNF + properties: + descriptor_id: + type: string + constraints: [ equal: b1bb0ce7-2222-4fa7-95ed-4840d70a1182 ] + default: b1bb0ce7-2222-4fa7-95ed-4840d70a1182 + provider: + type: string + constraints: [ equal: MyCompany ] + default: MyCompany + product_name: + type: string + constraints: [ equal: Example_VNF2 ] + default: Example_VNF2 + software_version: + type: string + constraints: [ equal: '1.0.0' ] + default: '1.0.0' + descriptor_version: + type: string + constraints: [ equal: '1.0.0' ] + default: '1.0.0' + flavour_id: + type: string + constraints: [ equal: simple ] + default: simple + flavour_description: + type: string + default: "" + vnfm_info: + type: list + entry_schema: + type: string + constraints: [ equal: [ '0:MyCompany-1.0.0' ] ] + default: [ '0:MyCompany-1.0.0' ] + requirements: + - virtual_link_1: + capability: tosca.capabilities.nfv.VirtualLinkable + relationship: tosca.relationships.nfv.VirtualLinksTo + occurrences: [ 0, 1 ] + - virtual_link_2: + capability: tosca.capabilities.nfv.VirtualLinkable + relationship: tosca.relationships.nfv.VirtualLinksTo + occurrences: [ 0, 1 ] + - virtual_link_4: + capability: tosca.capabilities.nfv.VirtualLinkable + relationship: tosca.relationships.nfv.VirtualLinksTo + occurrences: [ 0, 1 ] + + +topology_template: + substitution_mappings: + node_type: tosca.nodes.nfv.example_VNF2 + requirements: + virtual_link: [ cp_03, external_virtual_link ] + virtual_link_4: [ cp_04, external_virtual_link ] + + node_templates: + cp_03: + type: tosca.nodes.nfv.VnfExtCp + properties: + layer_protocols: [ ipv4 ] + # . . . ...... + requirements: + - internal_virtual_link: intVL-A + cp_04: + type: tosca.nodes.nfv.VnfExtCp + properties: + layer_protocols: [ ipv4 ] + # . . . ...... + requirements: + - internal_virtual_link: intVL-A + + intVL-A: + type: tosca.nodes.nfv.VnfVirtualLink + properties: + connectivity_type: + layer_protocols: [ ipv4 ] + vl_profile: + max_bitrate_requirements: + root: 1000000 + leaf: 100000 + min_bitrate_requirements: + root: 100000 + leaf: 10000 + diff --git a/Example-data/example_A.14-example_vnf3.yaml b/Example-data/example_A.14-example_vnf3.yaml new file mode 100644 index 0000000000000000000000000000000000000000..623a650b5d451fa0e3375f82f9ef22777073ac2e --- /dev/null +++ b/Example-data/example_A.14-example_vnf3.yaml @@ -0,0 +1,92 @@ +# A.14-example_vnf3.yaml +tosca_definitions_version: tosca_simple_yaml_1_3 +description: VNF Descriptor for VNF3 +imports: + - etsi_nfv_sol001_vnfd_types.yaml # all of VNFD related TOSCA types as defined in ETSI GS NFVSOL 001 +node_types: + tosca.nodes.nfv.example_VNF3: + derived_from: tosca.nodes.nfv.VNF + properties: + descriptor_id: + type: string + constraints: [ equal: b1bb0ce7-2222-4fa7-95ed-4840d70a1177 ] + default: b1bb0ce7-2222-4fa7-95ed-4840d70a1177 + provider: + type: string + constraints: [ equal: MyCompany ] + default: MyCompany + product_name: + type: string + constraints: [ equal: Example_VNF3 ] + default: Example_VNF3 + software_version: + type: string + constraints: [ equal: '1.0.0' ] + default: '1.0.0' + descriptor_version: + type: string + constraints: [ equal: '1.0.0' ] + default: '1.0.0' + flavour_id: + type: string + constraints: [ equal: simple ] + default: simple + flavour_description: + type: string + default: "" + vnfm_info: + type: list + entry_schema: + type: string + constraints: [ equal: [ '0:MyCompany-1.0.0' ] ] + default: [ '0:MyCompany-1.0.0' ] + requirements: + - virtual_link_1: + capability: tosca.capabilities.nfv.VirtualLinkable + relationship: tosca.relationships.nfv.VirtualLinksTo + occurrences: [ 1, 1 ] + - virtual_link_2: + capability: tosca.capabilities.nfv.VirtualLinkable + relationship: tosca.relationships.nfv.VirtualLinksTo + occurrences: [ 0, 1 ] + - virtual_link_3: + capability: tosca.capabilities.nfv.VirtualLinkable + relationship: tosca.relationships.nfv.VirtualLinksTo + occurrences: [ 0, 1 ] + +topology_template: + substitution_mappings: + node_type: tosca.nodes.nfv.example_VNF3 + requirements: + virtual_link: [ cp_05, external_virtual_link ] + virtual_link_3: [ cp_06, external_virtual_link ] + + node_templates: + cp_05: + type: tosca.nodes.nfv.VnfExtCp + properties: + layer_protocols: [ ipv4 ] + # . . . + requirements: + - internal_virtual_link: intVL-A + cp_06: + type: tosca.nodes.nfv.VnfExtCp + properties: + layer_protocols: [ ipv4 ] + # . . . + requirements: + - internal_virtual_link: intVL-A + + intVL-A: + type: tosca.nodes.nfv.VnfVirtualLink + properties: + connectivity_type: + layer_protocols: [ ipv4 ] + vl_profile: + max_bitrate_requirements: + root: 1000000 + leaf: 100000 + min_bitrate_requirements: + root: 100000 + leaf: 10000 + diff --git a/Example-data/example_A.15.2-01.yaml b/Example-data/example_A.15.2-01.yaml new file mode 100644 index 0000000000000000000000000000000000000000..1e7ee13aa79896c1cacabd09d9486bed0ea95a86 --- /dev/null +++ b/Example-data/example_A.15.2-01.yaml @@ -0,0 +1,207 @@ +# A.15.2-01.yaml +tosca_definitions_version: tosca_simple_yaml_1_3 +imports: + - etsi_nfv_sol001_vnfd_types.yaml # all of TOSCA VNFD types as defined in ETSI GS NFVSOL 001 + +interface_types: + MyCompany.nfv.interfaces.VnfIndicator: + derived_from: tosca.interfaces.nfv.VnfIndicator + notifications: + utilization: + description: this notification is used to received asynchronous information of value change of the utilization_vnf_indicator + health: + description: this notification is used to received asynchronous information of value change of the health_vnf_indicator + +node_types: + MyCompany.SunshineDB.1_0.1_0: + derived_from: tosca.nodes.nfv.VNF + properties: + descriptor_id: + type: string + constraints: [ equal: b1bb0ce7-ebca-4fa7-95ed-4840d70a1177 ] + default: b1bb0ce7-ebca-4fa7-95ed-4840d70a1177 + provider: + type: string + constraints: [ equal: MyCompany ] + default: MyCompany + product_name: + type: string + constraints: [ equal: SunshineDB ] + default: SunshineDB + software_version: + type: string + constraints: [ equal: '1.0' ] + default: '1.0' + descriptor_version: + type: string + constraints: [ equal: '1.0' ] + default: '1.0' + flavour_id: + type: string + constraints: [ valid_values: [ simple ] ] + default: simple + flavour_description: + type: string + default: "" + vnfm_info: + type: list + entry_schema: + type: string + constraints: [ equal: [ '0:MyCompany-1.0.0' ] ] + default: [ '0:MyCompany-1.0.0' ] + attributes: + utilization_vnf_indicator: + type: float + description: holds the value of the utilization VNF indicator. It is assigned the output value of the utilization notification. + health_vnf_indicator: + type: string + description: holds the value of the health VNF indicator. It is assigned the output value of the health notification. + call_proc_scale_level: + type: integer + database_scale_level: + type: integer + interfaces: + Vnflcm: + operations: + # scale: {} + heal: + inputs: + additional_parameters: + type: MyCompany.datatypes.nfv.HealAdditionalParameters + required: false + VnfIndicator: + type: MyCompany.nfv.interfaces.VnfIndicator + notifications: + utilization: + outputs: + utilization_vnf_indicator: [ SELF, utilization_vnf_indicator ] + health: + outputs: + health_vnf_indicator: [ SELF, health_vnf_indicator ] + +data_types: + MyCompany.datatypes.nfv.HealAdditionalParameters: + derived_from: tosca.datatypes.nfv.VnfOperationAdditionalParameters + properties: + parameter_1: + type: string + required: false + +policy_types: + MyCompany.policies.nfv.VnfIndicator: + derived_from: tosca.policies.nfv.VnfIndicator + +topology_template: + substitution_mappings: + node_type: MyCompany.SunshineDB.1_0.1_0 + # .. + + node_templates: + SunshineDB: + type: MyCompany.SunshineDB.1_0.1_0 + attributes: + call_proc_scale_level: { get_attribute: [ SELF, scale_status, call_proc, scale_level ] } + database_scale_level: { get_attribute: [ SELF, scale_status, database, scale_level ] } + + policies: + - scaling_aspects: + type: tosca.policies.nfv.ScalingAspects + properties: + aspects: + database: + name: .. + description: .. + max_scale_level: 2 + step_deltas: + - delta_1 + call_proc: + name: .. + description: .. + max_scale_level: 4 + step_deltas: + - delta_1 + - auto_scale: + type: tosca.policies.nfv.VnfIndicator + properties: + source: vnf + triggers: + scale_out: + event: tosca.interfaces.nfv.VnfIndicator.utilization # full name of a notification in the VnfIndicator interface + condition: + - utilization_vnf_indicator: [ { greater_or_equal: 60.0 } ] + - call_proc_scale_level: [ { less_than: 3 } ] + action: + - call_operation: + operation: Vnflcm.scale + inputs: + type: + value: scale_out + aspect: + value: call_proc + number_of_steps: + value: 1 # optional + scale_in: + event: tosca.interfaces.nfv.VnfIndicator.utilization # full name of a notification in the VnfIndicator interface + condition: + - utilization_vnf_indicator: [ { less_or_equal: 20.0 } ] + - call_proc_scale_level: [ { greater_than: 0 } ] + action: + - call_operation: + operation: Vnflcm.scale + inputs: + type: + value: scale_in + aspect: + value: call_proc + targets: [SunshineDB ] + + - auto_heal: + type: tosca.policies.nfv.VnfIndicator + properties: + source: vnf + triggers: + red: + event: tosca.interfaces.nfv.VnfIndicator.health # full name of a notification in the VnfIndicator interface + condition: + - health_vnf_indicator: [ { equal: red } ] + action: + - call_operation: + operation: Vnflcm.heal + inputs: + cause: + value: no_service + yellow: + event: tosca.interfaces.nfv.VnfIndicator.health + condition: + - health_vnf_indicator: [ { equal: yellow } ] + action: + - call_operation: + operation: Vnflcm.heal + inputs: + cause: + value: degraded_service + targets: [SunshineDB ] + + - auto_heal_with_additional_parameters: + type: MyCompany.policies.nfv.VnfIndicator + properties: + source: vnf + triggers: + red_or_yellow: + event: tosca.interfaces.nfv.VnfIndicator.health # full name of a notification in the VnfIndicator interface + condition: + or: + - health_vnf_indicator: [ { equal: red } ] + - health_vnf_indicator: [ { equal: yellow } ] + action: + - call_operation: + operation: Vnflcm.heal + inputs: + cause: + value: problem + additional_parameters: + value: + parameter_1: value_1 + targets: [SunshineDB ] + #.. + diff --git a/Example-data/example_A.15.3-example_NS.yaml b/Example-data/example_A.15.3-example_NS.yaml new file mode 100644 index 0000000000000000000000000000000000000000..c131e41f9bbff128e3a1dbad42ee7b9835e91438 --- /dev/null +++ b/Example-data/example_A.15.3-example_NS.yaml @@ -0,0 +1,213 @@ +# A.15.3-example_NS.yaml +tosca_definitions_version: tosca_simple_yaml_1_3 + +description: Relational database, simple + +imports: + - etsi_nfv_sol001_nsd_types.yaml # all of NSD related TOSCA types as defined in ETSI GS NFV-SOL 001 + - example_VNF1.yaml # uri of the yaml file which contains the definition of tosca.nodes.nfv.example_VNF1, this file might be included in the NSD file structure + - example_VNF2.yaml # uri of the yaml file which contains the definition of tosca.nodes.nfv.example_VNF2, this file might be included in the NSD file structure + + +data_types: + MyCompany.datatypes.nfv.NsInstantiateAdditionalParameters: + derived_from: tosca.datatypes.nfv.NsOperationAdditionalParameters + properties: + parameter_1: + type: string + required: true + default: value_1 + parameter_2: + type: string + required: true + default: value_2 + +interface_types: + MyCompany.nfv.interfaces.NsVnfIndicator: + derived_from: tosca.interfaces.nfv.NsVnfIndicator + notifications: + utilization: + description: this notification is used to received asynchronous information of value change of the utilization_vnf_indicator + +node_types: + tosca.example_NS: + derived_from: tosca.nodes.nfv.NS + properties: + descriptor_id: + type: string + constraints: [ equal: b1bb0ce7-ebca-4fa7-95ed-4840d70a1177 ] + default: b1bb0ce7-ebca-4fa7-95ed-4840d70a1177 + designer: + type: string + constraints: [ equal: MyCompany ] + default: MyCompany + name: + type: string + constraints: [ equal: ExampleService ] + default: ExampleService + version: + type: string + constraints: [ equal: '1.0' ] + default: '1.0' + invariant_id: + type: string + constraints: [ equal: 1111-2222-aaaa-bbbb ] + default: 1111-2222-aaaa-bbbb + flavour_id: + type: string + constraints: [ equal: simple ] + default: simple + attributes: + vnf_1_utilization_vnf_indicator: + type: float + description: holds the value of the vnf_1_utilization VNF indicator. It is assigned the output value of the utilization notification. + vnf_2_utilization_vnf_indicator: + type: float + description: holds the value of the vnf_1_utilization VNF indicator. It is assigned the output value of the utilization notification. + call_proc_scale_level: + type: integer + database_scale_level: + type: integer + + interfaces: + Nslcm: + type: tosca.interfaces.nfv.Nslcm + operations: + instantiate: + inputs: + additional_parameters: + type: MyCompany.datatypes.nfv.NsInstantiateAdditionalParameters + NsVnfIndicator: + type: MyCompany.nfv.interfaces.NsVnfIndicator + notifications: + utilization: {} + + +topology_template: + substitution_mappings: + node_type: tosca.example_NS + requirements: + virtual_link: [ VNF_2, virtual_link_2 ] # the External connection point of + # VNF_2 is exposed as the Sap + + node_templates: + my_service: + type: tosca.example_NS + properties: + descriptor_id: b1bb0ce7-ebca-4fa7-95ed-4840d70a1177 + designer: MyCompany + name: ExampleService + version: '1.0' + invariant_id: 1111-2222-aaaa-bbbb + flavour_id: simple + attributes: + call_proc_scale_level: { get_attribute: [ SELF, scale_status, call_proc ] } + vnf_1_utilization_vnf_indicator: { get_attribute: [ VNF_1, utilization_vnf_indicator ] } # required Vnf indicator for VNF_1 of this NS + vnf_2_utilization_vnf_indicator: { get_attribute: [ VNF_2, utilization_vnf_indicator ] } # required Vnf indicator for VNF_1 of this NS + + interfaces: + Nslcm: + operations: + instantiate: + implementation: instantiate.workflow.yaml + terminate: + implementation: terminate.workflow.yaml + + + VNF_1: + type: tosca.nodes.nfv.example_VNF1 + properties: + # no property assignments needed for required properties that have a default value assigned in the node type definition, e.g. descriptor_id + flavour_id: simple + vnf_profile: + instantiation_level: level_1 + min_number_of_instances: 2 + max_number_of_instances: 6 + requirements: + - virtual_link: NsVirtualLink_1 + + VNF_2: + type: tosca.nodes.nfv.example_VNF2 + properties: + flavour_id: simple + vnf_profile: + instantiation_level: level_1 + min_number_of_instances: 1 + max_number_of_instances: 3 + + requirements: + - virtual_link_1: NsVirtualLink_1 + # - virtual_link_2: # map to virtual_link requirement of the NS node + - dependency: VNF_1 + + NsVirtualLink_1: + type: tosca.nodes.nfv.NsVirtualLink + properties: + connectivity_type: + layer_protocols: [ipv4] + flow_pattern: mesh + vl_profile: + max_bitrate_requirements: + root: 1000 + min_bitrate_requirements: + root: 1000 + + policies: + - scaling_aspects: + type: tosca.policies.nfv.NsScalingAspects + properties: + aspects: + database: + name: DatabaseScalingAspect + description: This scaling aspect is for database + ns_scale_levels: + 0: + description: first NS level for the database scaling aspect + 1: + description: second NS level for the database scaling aspect + call_proc: + name: ProcessorScalingAspect + description: This scaling aspect is for Processor + ns_scale_levels: + 0: + description: first NS level for the processor scaling aspect + 1: + description: second NS level for the processor scaling aspect + 2: + description: third NS level for the processor scaling aspect + + - auto_scale: + type: tosca.policies.nfv.NsAutoScale + # properties: + # none + triggers: + scale_out: + event: tosca.interfaces.nfv.NsVnfIndicator.utilization # full name of a notification in the VnfIndicator interface + condition: + - vnf_1_utilization_vnf_indicator: [ { greater_or_equal: 80.0 } ] + - vnf_2_utilization_vnf_indicator: [ { greater_or_equal: 80.0 } ] + - call_proc_scale_level: [ { less_than: 2 } ] + action: + - call_operation: + operation: Nslcm.scale + inputs: + scale_ns_by_steps_data: + scaling_direction: scale_out + aspect: call_proc + number_of_steps: 1 + scale_in: + event: tosca.interfaces.nfv.NsVnfIndicator.utilization # full name of a notification in the VnfIndicator interface + condition: + - vnf_1_utilization_vnf_indicator: [ { less_or_equal: 10.0 } ] + - vnf_2_utilization_vnf_indicator: [ { less_or_equal: 10.0 } ] + - call_proc_scale_level: [ { greater_than: 2 } ] + action: + - call_operation: + operation: Nslcm.scale + inputs: + scale_ns_by_steps_data: + scaling_direction: scale_in + aspect: call_proc + number_of_steps: 1 + targets: [ my_service ] + diff --git a/Example-data/example_A.15.3-example_VNF1.yaml b/Example-data/example_A.15.3-example_VNF1.yaml new file mode 100644 index 0000000000000000000000000000000000000000..a245158be9c14bf18488281c60f54e3685d67b05 --- /dev/null +++ b/Example-data/example_A.15.3-example_VNF1.yaml @@ -0,0 +1,78 @@ +# A.15.3-example_VNF1.yaml +tosca_definitions_version: tosca_simple_yaml_1_3 +description: VNFD for VNF_1 + +imports: + - etsi_nfv_sol001_vnfd_types.yaml # all of TOSCA VNFD types as defined in ETSI GS NFV-SOL 001 + +interface_types: + MyCompany.nfv.interfaces.VnfIndicator: + derived_from: tosca.interfaces.nfv.VnfIndicator + notifications: + utilization: + description: this notification is used to received asynchronous information of value change of the utilization_vnf_indicator + health: + description: this notification is used to received asynchronous information of value change of the health_vnf_indicator + +node_types: + tosca.nodes.nfv.example_VNF1: + derived_from: tosca.nodes.nfv.VNF + properties: + descriptor_id: + type: string + constraints: [ equal: b1bb0ce7-ebca-4fa7-95ed-4840d70a1177 ] + default: b1bb0ce7-ebca-4fa7-95ed-4840d70a1177 + provider: + type: string + constraints: [ equal: MyCompany ] + default: MyCompany + product_name: + type: string + constraints: [ equal: SunshineDB ] + default: SunshineDB + software_version: + type: string + constraints: [ equal: '1.0' ] + default: '1.0' + descriptor_version: + type: string + constraints: [ equal: '1.0' ] + default: '1.0' + flavour_id: + type: string + constraints: [ valid_values: [ simple ] ] + default: simple + flavour_description: + type: string + default: "" + vnfm_info: + type: list + entry_schema: + type: string + constraints: [ equal: [ '0:MyCompany-1.0.0' ] ] + default: [ '0:MyCompany-1.0.0' ] + attributes: + utilization_vnf_indicator: + type: float + description: holds the value of the utilization VNF indicator. It is assigned the output value of the utilization notification. + health_vnf_indicator: + type: string + description: holds the value of the health VNF indicator. It is assigned the output value of the health notification. + call_proc_scale_level: + type: integer + database_scale_level: + type: integer + interfaces: + Vnflcm: + operations: + scale: {} + VnfIndicator: + type: MyCompany.nfv.interfaces.VnfIndicator + notifications: + utilization: + outputs: + utilization_vnf_indicator: [ SELF, utilization_vnf_indicator ] + health: + outputs: + health_vnf_indicator: [ SELF, health_vnf_indicator ] + diff --git a/Example-data/example_A.15.3-example_VNF2.yaml b/Example-data/example_A.15.3-example_VNF2.yaml new file mode 100644 index 0000000000000000000000000000000000000000..ccebf3a4a5e7045dbe4edf1d07c0457a426aba95 --- /dev/null +++ b/Example-data/example_A.15.3-example_VNF2.yaml @@ -0,0 +1,89 @@ +# A.15.3-example_VNF2.yaml +tosca_definitions_version: tosca_simple_yaml_1_3 +description: VNFD for VNF_2 + +imports: + - etsi_nfv_sol001_vnfd_types.yaml # all of TOSCA VNFD types as defined in ETSI GS NFV-SOL 001 + +interface_types: + MyCompany.nfv.interfaces.VnfIndicator: + derived_from: tosca.interfaces.nfv.VnfIndicator + notifications: + utilization: + description: this notification is used to received asynchronous information of value change of the utilization_vnf_indicator + health: + description: this notification is used to received asynchronous information of value change of the health_vnf_indicator + +node_types: + tosca.nodes.nfv.example_VNF2: + derived_from: tosca.nodes.nfv.VNF + properties: + descriptor_id: + type: string + constraints: [ equal: b1bb0ce7-ebca-4fa7-95ed-4840d70a2233 ] + default: b1bb0ce7-ebca-4fa7-95ed-4840d70a2233 + provider: + type: string + constraints: [ equal: MyCompany ] + default: MyCompany + product_name: + type: string + constraints: [ equal: MyProduct ] + default: MyProduct + software_version: + type: string + constraints: [ equal: '1.0' ] + default: '1.0' + descriptor_version: + type: string + constraints: [ equal: '1.0' ] + default: '1.0' + flavour_id: + type: string + constraints: [ valid_values: [ simple ] ] + default: simple + flavour_description: + type: string + default: "" + vnfm_info: + type: list + entry_schema: + type: string + constraints: [ equal: [ '0:MyCompany-1.0.0' ] ] + default: [ '0:MyCompany-1.0.0' ] + attributes: + utilization_vnf_indicator: + type: float + description: holds the value of the utilization VNF indicator. It is assigned the output value of the utilization notification. + health_vnf_indicator: + type: string + description: holds the value of the health VNF indicator. It is assigned the output value of the health notification. + call_proc_scale_level: + type: integer + database_scale_level: + type: integer + interfaces: + Vnflcm: + operations: + scale: {} + VnfIndicator: + type: MyCompany.nfv.interfaces.VnfIndicator + notifications: + utilization: + outputs: + utilization_vnf_indicator: [ SELF, utilization_vnf_indicator ] + health: + outputs: + health_vnf_indicator: [ SELF, health_vnf_indicator ] + requirements: + - virtual_link: + occurrences: [ 0, 0 ] + - virtual_link_1: + capability: tosca.capabilities.nfv.VirtualLinkable + relationship: tosca.relationships.nfv.VirtualLinksTo + occurrences: [ 1, 1 ] + - virtual_link_2: + capability: tosca.capabilities.nfv.VirtualLinkable + relationship: tosca.relationships.nfv.VirtualLinksTo + occurrences: [ 0, 1 ] + diff --git a/Example-data/example_A.16-01.yaml b/Example-data/example_A.16-01.yaml new file mode 100644 index 0000000000000000000000000000000000000000..99769c9e3221ae1b7f2693f523d7b530f3f0d39a --- /dev/null +++ b/Example-data/example_A.16-01.yaml @@ -0,0 +1,99 @@ +# A.16-01.yaml +tosca_definitions_version: tosca_simple_yaml_1_3 + # ... +imports: + - etsi_nfv_sol001_vnfd_types.yaml # all of TOSCA VNFD types as defined in ETSI GS NFV-SOL 001 + +topology_template: + node_templates: +#... + VduwithTrunk: + type: tosca.nodes.nfv.Vdu.Compute + properties: + name: VduwithTrunk + description: compute node with trunk port + vdu_profile: + min_number_of_instances: 3 + max_number_of_instances: 4 + capabilities: + virtual_compute: + properties: + virtual_memory: + virtual_mem_size: 8192 MiB + virtual_cpu: + num_virtual_cpu: 2 +# omitted for brevity + + TrunkParentPort: + type: tosca.nodes.nfv.VduCp + properties: + layer_protocols: [ ipv4 ] + trunk_mode: true + # omitted for brevity + requirements: + - virtual_binding: VduwithTrunk + - virtual_link: intVL1 + + TrunkSubPort1: + type: tosca.nodes.nfv.VduSubCp + properties: + # omitted for brevity + layer_protocols: [ ipv4 ] + segmentation_type: vlan + segmentation_id: 10 + requirements: + - trunk_binding: TrunkParentPort + - virtual_link: intVL2 + + TrunkSubPort2: + type: tosca.nodes.nfv.VduSubCp + properties: + # omitted for brevity + layer_protocols: [ ipv4 ] + segmentation_type: vlan + segmentation_id: 100 + requirements: + - trunk_binding: TrunkParentPort + - virtual_link: intVL3 + + intVL1: + type: tosca.nodes.nfv.VnfVirtualLink + properties: + connectivity_type: + layer_protocols: [ ipv4 ] + vl_profile: + max_bitrate_requirements: + root: 100000 + leaf: 20000 + min_bitrate_requirements: + root: 10000 + leaf: 10000 # omitted for brevity + + intVL2: + type: tosca.nodes.nfv.VnfVirtualLink + properties: + connectivity_type: + layer_protocols: [ ipv4 ] + vl_profile: + max_bitrate_requirements: + root: 100000 + leaf: 20000 + min_bitrate_requirements: + root: 10000 + leaf: 10000 +# omitted for brevity + + intVL3: + type: tosca.nodes.nfv.VnfVirtualLink + properties: + connectivity_type: + layer_protocols: [ ipv4 ] + vl_profile: + max_bitrate_requirements: + root: 100000 + leaf: 20000 + min_bitrate_requirements: + root: 10000 + leaf: 10000 + # omitted for brevity + diff --git a/Example-data/example_A.17-01.yaml b/Example-data/example_A.17-01.yaml new file mode 100644 index 0000000000000000000000000000000000000000..228b04c0b1d95a078a9229578999551efd87d645 --- /dev/null +++ b/Example-data/example_A.17-01.yaml @@ -0,0 +1,202 @@ +# A.17-01.yaml +tosca_definitions_version: tosca_simple_yaml_1_3 +description: myExampleNs with scaling aspects +imports: + - etsi_nfv_sol001_nsd_types.yaml # all of TOSCA NSD types as defined in ETSI GS NFVSOL 001 + - MyScalableNs_Type.yaml # contains the NS node type definition. + - SupportFrontEndNs.yaml # uri of the yaml file which contains the MyProviderCompany.NS.SupportFrontEndNs node type definition, this file might be included in the NSD file structure of NS_1. + - FrontEnd_1_0.yaml # uri of the yaml file which contains the MyCompany.VNF.FrontEnd_1_0 node type definition, this file might be included in the NSD file structure of NS_1. + - Database_1_0.yaml # uri of the yaml file which contains the MyCompany.VNF.Database_1_0 node type definition, this file might be included in the NSD file structure of NS_1. + - CentralProcess_1_0.yaml # uri of the yaml file which contains the MyCompany.VNF.CentralProcess_1_0 node type definition, this file might be included in the NSD file structure of NS_1. + +topology_template: + substitution_mappings: + node_type: MyProviderCompany.NS.MyScalableNS + substitution_filter: + properties: + - flavour_id: { equal: small } + requirements: + virtual_link: [ FrontEnd, virtual_link_2 ] + + node_templates: + NS_1: + type: MyProviderCompany.NS.MyScalableNS + interfaces: + Nslcm: + operations: + instantiate: + implementation: instantiate.workflow.yaml + terminate: + implementation: terminate.workflow.yaml + + FrontEnd: + type: MyCompany.VNF.FrontEnd_1_0 + properties: + # no property assignments needed for required properties that have a default value assigned in the node type definition, e.g. descriptor_id + flavour_id: simple + vnf_profile: + instantiation_level: level_1 + min_number_of_instances: 1 + max_number_of_instances: 4 + requirements: + - virtual_link_1: NS_VL_1 + # - virtual_link_2: # map to virtual_link requirement of the NS node + + Database: + type: MyCompany.VNF.Database_1_0 + properties: + # no property assignments needed for required properties that have a default value assigned in the node type definition, e.g. descriptor_id + flavour_id: simple + vnf_profile: + instantiation_level: level_1 + min_number_of_instances: 1 + max_number_of_instances: 2 + requirements: + - virtual_link_1: NS_VL_1 + + CentralProcess: + type: MyCompany.VNF.CentralProcess_1_0 + properties: + # no property assignments needed for required properties that have a default value assigned in the node type definition, e.g. descriptor_id + flavour_id: simple + vnf_profile: + instantiation_level: level_1 + min_number_of_instances: 1 + max_number_of_instances: 2 + requirements: + - virtual_link_1: NS_VL_1 + + SupportFrontEnd: + type: MyProviderCompany.NS.SupportFrontEndNs + properties: + descriptor_id: c1bb0ab8-deab-4fa7-95ed-4840d70a3574 + designer: MyCompany + version: 1.0.0.0 + name: myExample2Service + invariant_id: aaaa-bbbb-cccc-dddd + ns_profile: + ns_instantiation_level: level_1 + min_number_of_instances: 0 + max_number_of_instances: 1 + flavour_id: simple + flavour_id: simple + requirements: + - virtual_link_1: NS_VL_1 + + NS_VL_1: + type: tosca.nodes.nfv.NsVirtualLink + properties: + connectivity_type: + layer_protocols: [ipv4] + flow_pattern: mesh + vl_profile: + max_bitrate_requirements: + root: 1000 + min_bitrate_requirements: + root: 1000 + + policies: + - scaling_aspects: + type: tosca.policies.nfv.NsScalingAspects + properties: + aspects: + database: + name: DatabaseScalingAspect + description: This scaling aspect is used to scale the Database VNF + ns_scale_levels: + 0: + description: first NS level for the database scaling aspect + 1: + description: second NS level for the database scaling aspect + processor: + name: ProcessorScalingAspect + description: This scaling aspect is used to scale the FrontEnd and CentralProcess VNFs and the SupportFrontEnd nested NS + ns_scale_levels: + 0: + description: first NS level for the processor scaling aspect + 1: + description: second NS level for the processor scaling aspect + 2: + description: second NS level for the processor scaling aspect + + - FrontEndVnfToLevelMapping: + type: tosca.policies.nfv.VnfToLevelMapping + properties: + aspect: processor + number_of_instances: + 0: 1 + 1: 3 + 2: 4 + targets: [ FrontEnd ] + + - CentralProcessVnfToLevelMapping: + type: tosca.policies.nfv.VnfToLevelMapping + properties: + aspect: processor + number_of_instances: + 0: 1 + 1: 1 + 2: 2 + targets: [ CentralProcess ] + + - DatabaseVnfToLevelMapping: + type: tosca.policies.nfv.VnfToLevelMapping + properties: + aspect: database + number_of_instances: + 0: 1 + 1: 2 + targets: [ Database ] + + - SupportFrontEndNsToLevelMapping: + type: tosca.policies.nfv.NsToLevelMapping + properties: + aspect: processor + number_of_instances: + 0: 0 + 1: 0 + 2: 1 + targets: [ SupportFrontEnd ] + + - ns_instantiation_levels: + type: tosca.policies.nfv.NsInstantiationLevels + properties: + ns_levels: + instantiation_level_1: + description: low capacity instantiation level + instantiation_level_2: + description: high capacity instantiation level + default_level: instantiation_level_1 + + - FrontEnd_instantiation_levels: + type: tosca.policies.nfv.VnfToInstantiationLevelMapping + properties: + number_of_instances: + instantiation_level_1: 1 + instantiation_level_2: 3 + targets: [ FrontEnd ] + + - CentralProcess_instantiation_levels: + type: tosca.policies.nfv.VnfToInstantiationLevelMapping + properties: + number_of_instances: + instantiation_level_1: 1 + instantiation_level_2: 1 + targets: [ CentralProcess ] + + - Database_instantiation_levels: + type: tosca.policies.nfv.VnfToInstantiationLevelMapping + properties: + number_of_instances: + instantiation_level_1: 1 + instantiation_level_2: 1 + targets: [ Database ] + + - SupportFrontEnd_instantiation_levels: + type: tosca.policies.nfv.NsToInstantiationLevelMapping + properties: + number_of_instances: + instantiation_level_1: 0 + instantiation_level_2: 0 + targets: [ SupportFrontEnd ] + diff --git a/Example-data/example_A.17-MyScalableNs_Type.yaml b/Example-data/example_A.17-MyScalableNs_Type.yaml new file mode 100644 index 0000000000000000000000000000000000000000..5f256195bfea36100ba8d239dea2aa6bd6250601 --- /dev/null +++ b/Example-data/example_A.17-MyScalableNs_Type.yaml @@ -0,0 +1,42 @@ +# A.17-MyScalableNs_Type.yaml +tosca_definitions_version: tosca_simple_yaml_1_3 + +description: type definition of tosca.MyScalableNS + +imports: + - etsi_nfv_sol001_nsd_types.yaml # all of TOSCA types as defined in ETSI GS NFVSOL 001 + +node_types: + MyProviderCompany.NS.MyScalableNS: + derived_from: tosca.nodes.nfv.NS + properties: + descriptor_id: + type: string + constraints: [ valid_values: [ b1bb0ce7-ebca-4fa7-95ed-4840d70a1177 ] ] + default: b1bb0ce7-ebca-4fa7-95ed-4840d70a1177 + designer: + type: string + constraints: [ valid_values: [ MyCompany] ] + default: MyCompany + name: + type: string + constraints: [ valid_values: [ ExampleService ] ] + default: ExampleService + version: + type: string + constraints: [ valid_values: [ '1.0' ] ] + default: '1.0' + invariant_id: + type: string + constraints: [ valid_values: [ 1111-2222-aaaa-bbbb ] ] + default: 1111-2222-aaaa-bbbb + flavour_id: + type: string + constraints: [ valid_values: [ small, big ] ] + default: small + requirements: + - virtual_link: + capability: tosca.capabilities.nfv.VirtualLinkable + interfaces: + Nslcm: + type: tosca.interfaces.nfv.Nslcm diff --git a/Example-data/example_A.2-01.yaml b/Example-data/example_A.2-01.yaml new file mode 100644 index 0000000000000000000000000000000000000000..41736498b68f89ff0f894356ff84ebc0be4b2b63 --- /dev/null +++ b/Example-data/example_A.2-01.yaml @@ -0,0 +1,147 @@ +# A.2-01.yaml +tosca_definitions_version: tosca_simple_yaml_1_3 + +description: Relational database, simple +imports: + - etsi_nfv_sol001_vnfd_types.yaml # all of TOSCA VNFD types as defined in ETSI GS NFV-SOL 001 + - sunshineVNF.yaml # contains the VNF node type definition + +node_types: + MyCompany.nodes.nfv.Vdu.Aux: + derived_from: tosca.nodes.nfv.Vdu.Compute + properties: + configurable_properties: + type: MyCompany.datatypes.nfv.AuxVnfcConfigurableProperties + required: false + +data_types: + MyCompany.datatypes.nfv.AuxVnfcConfigurableProperties: + derived_from: tosca.datatypes.nfv.VnfcConfigurableProperties + properties: + additional_vnfc_configurable_properties: + type: MyCompany.datatypes.nfv.AuxVnfcAdditionalConfigurableProperties + required: true + + MyCompany.datatypes.nfv.AuxVnfcAdditionalConfigurableProperties: + derived_from: tosca.datatypes.nfv.VnfcAdditionalConfigurableProperties + properties: + name_prefix_in_vim: + type: string + required: true + default: "MyCustomer" + dns_server: + type: string + required: true + default: "90.200.250.57" + +topology_template: + substitution_mappings: + node_type: MyCompany.SunshineDB.1_0.1_0 + substitution_filter: + properties: + - flavour_id: { equal: simple } + requirements: + virtual_link_backend: [ dbBackendCp, virtual_link ] # IPv4 for SQL + + node_templates: + SunshineDB: + type: MyCompany.SunshineDB.1_0.1_0 + properties: + flavour_description: A simple flavour + interfaces: + Vnflcm: + operations: + instantiate: + implementation: instantiate.workbook.mistral.yaml + terminate: + implementation: terminate.workbook.mistral.yaml + + dbBackend: + type: MyCompany.nodes.nfv.Vdu.Aux + properties: + name: dbBackend + description: dbBackend compute node + nfvi_constraints: + key_1: value_1 + key_2: value_2 + vdu_profile: + min_number_of_instances: 1 + max_number_of_instances: 1 + capabilities: + virtual_compute: + properties: + virtual_memory: + virtual_mem_size: 8192 MiB + virtual_cpu: + cpu_architecture: x86 + num_virtual_cpu: 2 + virtual_cpu_clock: 1800 MHz + requirements: + - virtual_storage: mariaDbStorage + + mariaDbStorage: + type: tosca.nodes.nfv.Vdu.VirtualBlockStorage + properties: + virtual_block_storage_data: + size_of_storage: 100 GB + rdma_enabled: true + # .. + artifacts: + sw_image: + type: tosca.artifacts.nfv.SwImage + file: maria.db.image.v1.0.qcow2 + properties: + name: Software of Maria Db + version: '1.0' + checksum: + algorithm: sha-256 + hash: b9c3036539fd7a5f87a1bf38eb05fdde8b556a1a7e664dbeda90ed3cd74b4f9d + container_format: bare + disk_format: qcow2 + min_disk: 2 GB + min_ram: 8192 MiB + size: 2 GB + operating_system: Linux + supported_virtualisation_environments: + - KVM + + dbBackendCp: + type: tosca.nodes.nfv.VduCp + properties: + layer_protocols: [ ipv4 ] + role: leaf + description: External connection point to access the DB on IPv4 + protocol: [ associated_layer_protocol: ipv4 ] + trunk_mode: false + requirements: + - virtual_binding: dbBackend + # - virtual_link: # the target node is determined in the NSD + + dbBackendInternalCp: + type: tosca.nodes.nfv.VduCp + properties: + layer_protocols: [ ipv4 ] + role: leaf + description: Internal connection point on an VL + protocol: [ associated_layer_protocol: ipv4 ] + trunk_mode: false + requirements: + - virtual_binding: dbBackend + - virtual_link: internalVl + + internalVl: + type: tosca.nodes.nfv.VnfVirtualLink + properties: + connectivity_type: + layer_protocols: [ ipv4 ] + flow_pattern: mesh + description: Internal Virtual link in the VNF + vl_profile: + max_bitrate_requirements: + root: 100000 + leaf: 20000 + min_bitrate_requirements: + root: 10000 + leaf: 10000 + + diff --git a/Example-data/example_A.2-sunshine.vnfd.tosca.yaml b/Example-data/example_A.2-sunshine.vnfd.tosca.yaml new file mode 100644 index 0000000000000000000000000000000000000000..29e0909ce858d6ccf4b5fbb33c54b50defc3f898 --- /dev/null +++ b/Example-data/example_A.2-sunshine.vnfd.tosca.yaml @@ -0,0 +1,32 @@ +# A.2-sunshine.vnfd.tosca.yaml +tosca_definitions_version: tosca_simple_yaml_1_3 + +description: Relational database, non-scalable +imports: + - etsi_nfv_sol001_vnfd_types.yaml # all of TOSCA VNFD types as defined in ETSI GS NFVSOL 001 + - sunshineVNF.yaml # contains the VNF node type definition + + +topology_template: + inputs: + flavour_id: + type: string + description: VNF deployment flavour selected by the consumer. It is provided in the API + + node_templates: + SunshineDB: + type: MyCompany.SunshineDB.1_0.1_0 + properties: + flavour_id: { get_input: flavour_id } + descriptor_id: b1bb0ce7-ebca-4fa7-95ed-4840d70a1177 + provider: MyCompany + product_name: SunshineDB + software_version: '1.0' + descriptor_version: '1.0' + vnfm_info: + - '0:MyCompany-1.0.0' + # requirements: + #- virtual_link_backend # mapped in lower-level templates + #- virtual_link_service # mapped in lower-level templates + + diff --git a/Example-data/example_A.2-sunshineVNF.yaml b/Example-data/example_A.2-sunshineVNF.yaml new file mode 100644 index 0000000000000000000000000000000000000000..86da768f41e6ccfcdcbd02a1b936fbdccb7b37c6 --- /dev/null +++ b/Example-data/example_A.2-sunshineVNF.yaml @@ -0,0 +1,81 @@ +# A.2-sunshineVNF.yaml +tosca_definitions_version: tosca_simple_yaml_1_3 + +description: Relational database, non-scalable + +imports: + - etsi_nfv_sol001_vnfd_types.yaml # all of TOSCA VNFD types as defined in ETSI GS NFV-SOL 001 + +data_types: + MyCompany.datatypes.nfv.VnfInstantiateAdditionalParameters: + derived_from: tosca.datatypes.nfv.VnfOperationAdditionalParameters + properties: + parameter_1: + type: string + required: true + default: value_1 + parameter_2: + type: string + required: true + default: value_2 + +node_types: + MyCompany.SunshineDB.1_0.1_0: + derived_from: tosca.nodes.nfv.VNF + properties: + descriptor_id: + type: string + constraints: [ equal: b1bb0ce7-ebca-4fa7-95ed-4840d70a1177 ] + default: b1bb0ce7-ebca-4fa7-95ed-4840d70a1177 + provider: + type: string + constraints: [ equal: MyCompany ] + default: MyCompany + product_name: + type: string + constraints: [ equal: SunshineDB ] + default: SunshineDB + software_version: + type: string + constraints: [ equal: '1.0' ] + default: '1.0' + descriptor_version: + type: string + constraints: [ equal: '1.0' ] + default: '1.0' + flavour_id: + type: string + constraints: [ valid_values: [ simple, complex ] ] + default: simple + flavour_description: + type: string + default: "" #empty string + vnfm_info: + type: list + entry_schema: + type: string + constraints: [ equal: [ '0:MyCompany-1.0.0' ] ] + default: [ '0:MyCompany-1.0.0' ] + requirements: + - virtual_link: + capability: tosca.capabilities.nfv.VirtualLinkable + relationship: tosca.relationships.nfv.VirtualLinksTo + occurrences: [ 0, 0 ] + - virtual_link_backend: + capability: tosca.capabilities.nfv.VirtualLinkable + relationship: tosca.relationships.nfv.VirtualLinksTo + occurrences: [ 0, 1 ] + - virtual_link_service: + capability: tosca.capabilities.nfv.VirtualLinkable + relationship: tosca.relationships.nfv.VirtualLinksTo + occurrences: [ 0, 1 ] + interfaces: + Vnflcm: + type: tosca.interfaces.nfv.Vnflcm + operations: + instantiate: + inputs: + additional_parameters: + type: MyCompany.datatypes.nfv.VnfInstantiateAdditionalParameters + + diff --git a/Example-data/example_A.2-sunshinedbcomplex.vnfd.tosca.yaml b/Example-data/example_A.2-sunshinedbcomplex.vnfd.tosca.yaml new file mode 100644 index 0000000000000000000000000000000000000000..60314b38f9f98e30b191696a975b782e012e0b62 --- /dev/null +++ b/Example-data/example_A.2-sunshinedbcomplex.vnfd.tosca.yaml @@ -0,0 +1,214 @@ +# A.2-sunshinedbcomplex.vnfd.tosca.yaml +tosca_definitions_version: tosca_simple_yaml_1_3 + +description: Relational database, complex +imports: + - etsi_nfv_sol001_vnfd_types.yaml # all of TOSCA VNFD types as defined in ETSI GS NFV-SOL 001 + - sunshineVNF.yaml # contains the VNF node type definition + +node_types: + MyCompany.nodes.nfv.Vdu.Aux: + derived_from: tosca.nodes.nfv.Vdu.Compute + properties: + configurable_properties: + type: MyCompany.datatypes.nfv.AuxVnfcConfigurableProperties + required: false + +data_types: + MyCompany.datatypes.nfv.AuxVnfcConfigurableProperties: + derived_from: tosca.datatypes.nfv.VnfcConfigurableProperties + properties: + additional_vnfc_configurable_properties: + type: MyCompany.datatypes.nfv.AuxVnfcAdditionalConfigurableProperties + required: true + + MyCompany.datatypes.nfv.AuxVnfcAdditionalConfigurableProperties: + derived_from: tosca.datatypes.nfv.VnfcAdditionalConfigurableProperties + properties: + name_prefix_in_vim: + type: string + required: true + default: "MyCustomer" + dns_server: + type: string + required: true + default: "90.200.250.57" + +topology_template: + substitution_mappings: + node_type: MyCompany.SunshineDB.1_0.1_0 + substitution_filter: + properties: + - flavour_id: { equal: complex } + requirements: + virtual_link_backend: [ dbBackendCp, virtual_link ] # IPv4 for SQL + virtual_link_service: [ serviceNodeCp, virtual_link ] # IPv4 for SSH + + node_templates: + SunshineDB: + type: MyCompany.SunshineDB.1_0.1_0 + properties: + flavour_description: A complex flavour + interfaces: + Vnflcm: + operations: + instantiate: + implementation: instantiate.workbook.mistral.yaml + terminate: + implementation: terminate.workbook.mistral.yaml + heal: + implementation: heal.workbook.mistral.yaml + + dbBackend: + type: MyCompany.nodes.nfv.Vdu.Aux + properties: + name: dbBackend + description: dbBackend compute node + nfvi_constraints: + key_1: value_1 + key_2: value_2 + vdu_profile: + min_number_of_instances: 3 + max_number_of_instances: 4 + capabilities: + virtual_compute: + properties: + virtual_memory: + virtual_mem_size: 8192 MiB + virtual_cpu: + cpu_architecture: x86 + num_virtual_cpu: 2 + virtual_cpu_clock: 1800 MHz + requirements: + - virtual_storage: mariaDbStorage + + serviceNode: + type: tosca.nodes.nfv.Vdu.Compute + properties: + name: serviceNode + description: brief description about serviceNode + nfvi_constraints: + key_3: value_3 + key_4: value_4 + vdu_profile: + min_number_of_instances: 1 + max_number_of_instances: 1 + capabilities: + virtual_compute: + properties: + virtual_memory: + virtual_mem_size: 8192 MiB + virtual_cpu: + cpu_architecture: x86 + num_virtual_cpu: 2 + virtual_cpu_clock: 1800 MHz + requirements: + - virtual_storage: mariaDbStorage + artifacts: + sw_image: + type: tosca.artifacts.nfv.SwImage + file: maria.db.image.v1.0.qcow2 + properties: + name: Software of Maria Db + version: '1.0' + checksum: + algorithm: sha-256 + hash: b9c3036539fd7a5f87a1bf38eb05fdde8b556a1a7e664dbeda90ed3cd74b4f9d + container_format: bare + disk_format: qcow2 + min_disk: 2 GB + min_ram: 8192 MiB + size: 2 GB + operating_system: Linux + supported_virtualisation_environments: + - KVM + + mariaDbStorage: + type: tosca.nodes.nfv.Vdu.VirtualBlockStorage + properties: + virtual_block_storage_data: + size_of_storage: 100 GB + rdma_enabled: true + artifacts: + sw_image: + type: tosca.artifacts.nfv.SwImage + file: maria.db.image.v1.0.qcow2 + properties: + name: Software of Maria Db + version: '1.0' + checksum: + algorithm: sha-256 + hash: b9c3036539fd7a5f87a1bf38eb05fdde8b556a1a7e664dbeda90ed3cd74b4f9d + container_format: bare + disk_format: qcow2 + min_disk: 2 GB + min_ram: 8192 MiB + size: 2 GB + operating_system: Linux + supported_virtualisation_environments: + - KVM + + dbBackendCp: + type: tosca.nodes.nfv.VduCp + properties: + layer_protocols: [ ipv4 ] + role: leaf + description: External connection point to access the DB on IPv4 + protocol: [ associated_layer_protocol: ipv4 ] + trunk_mode: false + requirements: + - virtual_binding: dbBackend + #- virtual_link: # the target node is determined in the NSD + + dbBackendInternalCp: + type: tosca.nodes.nfv.VduCp + properties: + layer_protocols: [ ipv4 ] + role: leaf + description: Internal connection point on an VL + protocol: [ associated_layer_protocol: ipv4 ] + trunk_mode: false + requirements: + - virtual_binding: dbBackend + - virtual_link: internalVl + + serviceNodeCp: + type: tosca.nodes.nfv.VduCp + properties: + layer_protocols: [ ipv4 ] + role: leaf + description: External connection point to access the DB on IPv4 + protocol: [ associated_layer_protocol: ipv4 ] + trunk_mode: false + requirements: + - virtual_binding: serviceNode + #- virtual_link: # the target node is determined in the NSD + + serviceNodeInternalCp: + type: tosca.nodes.nfv.VduCp + properties: + layer_protocols: [ ipv4 ] + role: leaf + description: Internal connection point on VL + protocol: [ associated_layer_protocol: ipv4 ] + trunk_mode: false + requirements: + - virtual_binding: serviceNode + - virtual_link: internalVl + + internalVl: + type: tosca.nodes.nfv.VnfVirtualLink + properties: + connectivity_type: + layer_protocols: [ ipv4 ] + flow_pattern: mesh + description: Internal VL + vl_profile: + max_bitrate_requirements: + root: 100000 + leaf: 20000 + min_bitrate_requirements: + root: 10000 + leaf: 10000 + + diff --git a/Example-data/example_A.3.2-01.yaml b/Example-data/example_A.3.2-01.yaml new file mode 100644 index 0000000000000000000000000000000000000000..cb7ce7878d6e3cce4993358297135c7b670f2123 --- /dev/null +++ b/Example-data/example_A.3.2-01.yaml @@ -0,0 +1,111 @@ +# A.3.2-01.yaml +tosca_definitions_version: tosca_simple_yaml_1_3 +imports: + - etsi_nfv_sol001_vnfd_types.yaml # all of TOSCA VNFD types as defined in ETSI GS NFV-SOL 001 + - exampleVNF.yaml # contains the VNF node type definition + + + +topology_template: + +#... + + substitution_mappings: + node_type: tosca.nodes.nfv.exampleVNF + substitution_filter: + properties: + - flavour_id: { equal: simple } + requirements: + virtual_link: [vduCp_B2, virtual_link] + + node_templates: +#.. + ExampleVNF: + type: tosca.nodes.nfv.exampleVNF + properties: + flavour_description: A simple flavour + interfaces: + Vnflcm: + operations: + instantiate: + implementation: instantiate.workbook.mistral.yaml + terminate: + implementation: terminate.workbook.mistral.yaml + + vduCp_B2: + type: tosca.nodes.nfv.VduCp + properties: + layer_protocols: [ ipv4 ] + # other properties omitted for brevity + requirements: + - virtual_binding: VDU-B + # - virtual_link: # mapped to virtual_link requirement of VNF node + + + # other node template definitions (VDU-A, VDU-B, intVL, etc.): + VDU-A: + type: tosca.nodes.nfv.Vdu.Compute + properties: + name: VDU-A + description: VDU-A description + vdu_profile: + min_number_of_instances: 1 + max_number_of_instances: 1 + capabilities: + virtual_compute: + properties: + virtual_memory: + virtual_mem_size: 1 GB + virtual_cpu: + num_virtual_cpu: 1 + + vduCp_A: + type: tosca.nodes.nfv.VduCp + properties: + layer_protocols: [ ipv4 ] + protocol: [ associated_layer_protocol: ipv4 ] + trunk_mode: true + requirements: + - virtual_binding: VDU-A + - virtual_link: intVL + + intVL: + type: tosca.nodes.nfv.VnfVirtualLink + properties: + connectivity_type: + layer_protocols: [ ipv4 ] + vl_profile: + max_bitrate_requirements: + root: 1000000 + leaf: 100000 + min_bitrate_requirements: + root: 100000 + leaf: 10000 + + vduCp_B: + type: tosca.nodes.nfv.VduCp + properties: + layer_protocols: [ ipv4 ] + protocol: [ associated_layer_protocol: ipv4 ] + trunk_mode: true + requirements: + - virtual_binding: VDU-B + - virtual_link: intVL + + VDU-B: + type: tosca.nodes.nfv.Vdu.Compute + properties: + name: VDU-B + description: VDU-B description + vdu_profile: + min_number_of_instances: 1 + max_number_of_instances: 1 + capabilities: + virtual_compute: + properties: + virtual_memory: + virtual_mem_size: 1 GB + virtual_cpu: + num_virtual_cpu: 1 + + diff --git a/Example-data/example_A.3.2-02.yaml b/Example-data/example_A.3.2-02.yaml new file mode 100644 index 0000000000000000000000000000000000000000..ec66506bcd4c8c9bb334b54f7f6ff5a24882e101 --- /dev/null +++ b/Example-data/example_A.3.2-02.yaml @@ -0,0 +1,48 @@ +# A.3.2-02.yaml +tosca_definitions_version: tosca_simple_yaml_1_3 +imports: + - etsi_nfv_sol001_vnfd_types.yaml # all of TOSCA VNFD types as defined in ETSI GS NFV-SOL 001 + +node_types: + tosca.nodes.nfv.exampleVNF: + derived_from: tosca.nodes.nfv.VNF + properties: + descriptor_id: + type: string + constraints: [ equal: b1bb0ce7-ebca-4fa7-95ed-4840d70a1177 ] + default: b1bb0ce7-ebca-4fa7-95ed-4840d70a1177 + provider: + type: string + constraints: [ equal: MyCompany ] + default: MyCompany + product_name: + type: string + constraints: [ equal: ExampleVNF ] + default: ExampleVNF + software_version: + type: string + constraints: [ equal: '1.0' ] + default: '1.0' + descriptor_version: + type: string + constraints: [ equal: '1.0' ] + default: '1.0' + flavour_id: + type: string + constraints: [ valid_values: [ simple, complex ] ] + default: simple + flavour_description: + type: string + default: "" #empty string + vnfm_info: + type: list + entry_schema: + type: string + constraints: [ equal: [ '0:MyCompany-1.0.0' ] ] + default: [ '0:MyCompany-1.0.0' ] + # other properties omitted for brevity + requirements: + - virtual_link: + capability: tosca.capabilities.nfv.VirtualLinkable + relationship: tosca.relationships.nfv.VirtualLinksTo + diff --git a/Example-data/example_A.3.3-01.yaml b/Example-data/example_A.3.3-01.yaml new file mode 100644 index 0000000000000000000000000000000000000000..084526488b8fea18d276190e8fff4198259c683c --- /dev/null +++ b/Example-data/example_A.3.3-01.yaml @@ -0,0 +1,65 @@ +# A.3.3-01.yaml +tosca_definitions_version: tosca_simple_yaml_1_3 +imports: + - etsi_nfv_sol001_vnfd_types.yaml # all of TOSCA VNFD types as defined in ETSI GS NFV-SOL 001 + - exampleVNF.yaml # contains the VNF node type definition + + +topology_template: +#... + + substitution_mappings: + node_type: tosca.nodes.nfv.exampleVNF + substitution_filter: + properties: + - flavour_id: { equal: simple } + requirements: + virtual_link: [myMRFExtCp, external_virtual_link] + + node_templates: + ExampleVNF: + type: tosca.nodes.nfv.exampleVNF + properties: + flavour_description: A simple flavour + interfaces: + Vnflcm: + operations: + instantiate: + implementation: instantiate.workbook.mistral.yaml + terminate: + implementation: terminate.workbook.mistral.yaml + + myMRFExtCp: + type: tosca.nodes.nfv.VnfExtCp + properties: + layer_protocols: [ ipv4 ] + # other properties omitted for brevity + # ... + requirements: + # - external_virtual_link: # mapped to virtual_link requirement of VNF node + - internal_virtual_link: intVL-A + + + intVL-A: + type: tosca.nodes.nfv.VnfVirtualLink + properties: + connectivity_type: + layer_protocols: [ ipv4 ] + flow_pattern: mesh + description: Internal VL + vl_profile: + max_bitrate_requirements: + root: 1000000 + leaf: 100000 + min_bitrate_requirements: + root: 100000 + leaf: 10000 + qos: + latency: 100 ms + packet_delay_variation: 80 ms + packet_loss_ratio: 0.00001 + + + # Other node templates e.g. VDU-A, VDU-B, VduCP_A, etc.: +# ... + diff --git a/Example-data/example_A.4-01.yaml b/Example-data/example_A.4-01.yaml new file mode 100644 index 0000000000000000000000000000000000000000..2de68d5af9ef71e94fb08d1bfb813dd299f179e2 --- /dev/null +++ b/Example-data/example_A.4-01.yaml @@ -0,0 +1,77 @@ +# A.4-01.yaml +tosca_definitions_version: tosca_simple_yaml_1_3 +description: Template of a VNFD example +imports: + - etsi_nfv_sol001_vnfd_types.yaml # all of TOSCA VNFD types as defined in ETSI GS NFV-SOL 001 + - MyGroups.yaml #contains the node type definitions + +topology_template: + + node_templates: + Group_VDU_A: + type: tosca.nodes.nfv.groupVDU_A + capabilities: + virtual_compute: + properties: + virtual_memory: + virtual_mem_size: 1 GB + virtual_cpu: + num_virtual_cpu: 1 + requirements: + - virtual_link: VL_2 + + Group_VDU_B: + type: tosca.nodes.nfv.groupVDU_B + capabilities: + virtual_compute: + properties: + virtual_memory: + virtual_mem_size: 1 GB + virtual_cpu: + num_virtual_cpu: 1 + requirements: + - virtual_link: VL_2 + - virtual_link1: VL_1 + + Group_VDU_C: + type: tosca.nodes.nfv.groupVDU_C # the description of this type is described + # in another service template. + capabilities: + virtual_compute: + properties: + virtual_memory: + virtual_mem_size: 1 GB + virtual_cpu: + num_virtual_cpu: 1 + requirements: + - virtual_link: VL_1 + + VL_1: + type: tosca.nodes.nfv.VnfVirtualLink + properties: + connectivity_type: + layer_protocols: [ ipv4 ] + vl_profile: + max_bitrate_requirements: + root: 1000000 + leaf: 100000 + min_bitrate_requirements: + root: 100000 + leaf: 10000 + # other properties omitted here for brevity + + VL_2: + type: tosca.nodes.nfv.VnfVirtualLink + properties: + connectivity_type: + layer_protocols: [ ipv4 ] + vl_profile: + max_bitrate_requirements: + root: 1000000 + leaf: 100000 + min_bitrate_requirements: + root: 100000 + leaf: 10000 + # other properties omitted here for brevity + + diff --git a/Example-data/example_A.4-02.yaml b/Example-data/example_A.4-02.yaml new file mode 100644 index 0000000000000000000000000000000000000000..23f6b2b5f5a8ce38ab6003e62454db90bf856f24 --- /dev/null +++ b/Example-data/example_A.4-02.yaml @@ -0,0 +1,57 @@ +# A.4-02.yaml +tosca_definitions_version: tosca_simple_yaml_1_3 + +imports: + - etsi_nfv_sol001_vnfd_types.yaml # all of TOSCA VNFD types as defined in ETSI GS NFV-SOL 001 + - MyGroups.yaml #contains the node type definitions +description: composition of Vdu.Compute, Vdu.VirtualBlockStorage and VduCp. + +topology_template: + substitution_mappings: + node_type: tosca.nodes.nfv.groupVDU_C # substituted as a node type + requirements: + virtual_link: [ internalCpd, virtual_link ] + capabilities: + virtual_compute: [vduC_compute, virtual_compute] + virtual_storage: [vduC_storage, virtual_storage] + + node_templates: + vduC_compute: + type: tosca.nodes.nfv.Vdu.Compute + properties: + name: vduC_compute + description: vduC_compute .. + vdu_profile: + min_number_of_instances: 1 + max_number_of_instances: 1 + # other properties omitted here for brevity + capabilities: + virtual_compute: + properties: + virtual_memory: + virtual_mem_size: 1 GB + virtual_cpu: + num_virtual_cpu: 1 + # artifacts: + # sw_image: # omitted here for brevity + requirements: + - virtual_storage: vduC_storage + + vduC_storage: + type: tosca.nodes.nfv.Vdu.VirtualBlockStorage + properties: + virtual_block_storage_data: + size_of_storage: 2 GB + # other properties omitted here for brevity + + internalCpd: + type: tosca.nodes.nfv.VduCp + properties: + layer_protocols: [ ipv4 ] + # protocol: [ associated_layer_protocol: ipv4 ] + # trunk_mode: false + # properties omitted here for brevity + requirements: + # - virtual_link: + - virtual_binding: vduC_compute + diff --git a/Example-data/example_A.4-03.yaml b/Example-data/example_A.4-03.yaml new file mode 100644 index 0000000000000000000000000000000000000000..ea690cc052d26089e852d2ed5f9ad7908963742c --- /dev/null +++ b/Example-data/example_A.4-03.yaml @@ -0,0 +1,44 @@ +# A.4-03.yaml +tosca_definitions_version: tosca_simple_yaml_1_3 +imports: + - etsi_nfv_sol001_vnfd_types.yaml # all of VNFD types as defined in NFV SOL 001 GS + +node_types: + + tosca.nodes.nfv.groupVDU: + description: Abstract group VDU. + derived_from: tosca.nodes.Root + capabilities: + virtual_compute: + description: Describes virtual compute resources capabilities. + type: tosca.capabilities.nfv.VirtualCompute + virtual_storage: + description: Defines the capabilities of virtual_storage. + type: tosca.capabilities.nfv.VirtualStorage + requirements: + - virtual_link: + description: Describes the requirements for linking to virtual link. + capability: tosca.capabilities.nfv.VirtualLinkable + relationship: tosca.relationships.nfv.VirtualLinksTo + node: tosca.nodes.nfv.VnfVirtualLink + occurrences: [ 1, 1 ] + + tosca.nodes.nfv.groupVDU_A: + description: Abstract group VDU A. + derived_from: tosca.nodes.nfv.groupVDU + + tosca.nodes.nfv.groupVDU_B: + description: Abstract group VDU B. + derived_from: tosca.nodes.nfv.groupVDU + requirements: + - virtual_link1: + description: Describes the requirements for linking to virtual link. + capability: tosca.capabilities.nfv.VirtualLinkable + relationship: tosca.relationships.nfv.VirtualLinksTo + node: tosca.nodes.nfv.VnfVirtualLink + occurrences: [ 1, 1 ] + + tosca.nodes.nfv.groupVDU_C: + description: Abstract group VDU C. + derived_from: tosca.nodes.nfv.groupVDU + diff --git a/Example-data/example_A.5-01.yaml b/Example-data/example_A.5-01.yaml new file mode 100644 index 0000000000000000000000000000000000000000..ec9864b880d61681e3ae21cb1c6dc4f2376bdb5d --- /dev/null +++ b/Example-data/example_A.5-01.yaml @@ -0,0 +1,222 @@ +# A.5-01.yaml +tosca_definitions_version: tosca_simple_yaml_1_3 + +description: Relational database, simple + +imports: + - etsi_nfv_sol001_vnfd_types.yaml # all of TOSCA VNFD types as defined in ETSI GS NFV-SOL 001 for a VNFD + +data_types: + MyCompany.datatypes.nfv.VnfInstantiateAdditionalParameters: + derived_from: tosca.datatypes.nfv.VnfOperationAdditionalParameters + properties: + segmentation_id_of_internalVl: + type: string + required: true + default: 1-4095 + parameter_2: + type: string + required: true + default: value_2 + + MyCompany.datatypes.nfv.AuxVnfcConfigurableProperties: + derived_from: tosca.datatypes.nfv.VnfcConfigurableProperties + properties: + additional_vnfc_configurable_properties: + type: MyCompany.datatypes.nfv.AuxVnfcAdditionalConfigurableProperties + required: true + + MyCompany.datatypes.nfv.AuxVnfcAdditionalConfigurableProperties: + derived_from: tosca.datatypes.nfv.VnfcAdditionalConfigurableProperties + properties: + name_prefix_in_vim: + type: string + required: true + default: "MyCustomer" + dns_server: + type: string + required: true + default: "90.200.250.57" + +node_types: + MyCompany.SunshineDB.1_0.1_0: + derived_from: tosca.nodes.nfv.VNF + properties: + descriptor_id: + type: string + constraints: [ equal: b1bb0ce7-ebca-4fa7-95ed-4840d70a1177 ] + default: b1bb0ce7-ebca-4fa7-95ed-4840d70a1177 + provider: + type: string + constraints: [ equal: MyCompany ] + default: MyCompany + product_name: + type: string + constraints: [ equal: SunshineDB ] + default: SunshineDB + software_version: + type: string + constraints: [ equal: '1.0' ] + default: '1.0' + descriptor_version: + type: string + constraints: [ equal: '1.0' ] + default: '1.0' + flavour_id: + type: string + constraints: [ equal: simple ] + default: simple + flavour_description: + type: string + default: "" + vnfm_info: + type: list + entry_schema: + type: string + constraints: [ equal: [ '0:MyCompany-1.0.0' ] ] + default: [ '0:MyCompany-1.0.0' ] + interfaces: + Vnflcm: + type: tosca.interfaces.nfv.Vnflcm + operations: + instantiate: + inputs: + additional_parameters: + type: MyCompany.datatypes.nfv.VnfInstantiateAdditionalParameters + #terminate: + + MyCompany.nodes.nfv.Vdu.Aux: + derived_from: tosca.nodes.nfv.Vdu.Compute + properties: + configurable_properties: + type: MyCompany.datatypes.nfv.AuxVnfcConfigurableProperties + required: false + +topology_template: + substitution_mappings: + node_type: MyCompany.SunshineDB.1_0.1_0 + requirements: + virtual_link: [ dbBackendIpv4, virtual_link ] # IPv4 for SQL + + inputs: + segmentation_id_of_internalVl: + type: string + required: true + + node_templates: + SunshineDB: + type: MyCompany.SunshineDB.1_0.1_0 + properties: + descriptor_id: b1bb0ce7-ebca-4fa7-95ed-4840d70a1177 + provider: MyCompany + product_name: SunshineDB + software_version: '1.0' + descriptor_version: '1.0' + vnfm_info: + - '0:MyCompany-1.0.0' + flavour_id: simple + flavour_description: 'vnf simple flavour description' + interfaces: + Vnflcm: + operations: + instantiate: + implementation: instantiate.workbook.mistral.yaml + terminate: + implementation: terminate.workbook.mistral.yaml + heal: + implementation: heal.workbook.mistral.yaml + + dbBackend: + type: MyCompany.nodes.nfv.Vdu.Aux + properties: + name: dbbackend + description: dbBackend + nfvi_constraints: + key_1: value_1 + key_2: value_2 + vdu_profile: + min_number_of_instances: 1 + max_number_of_instances: 4 + capabilities: + virtual_compute: + properties: + virtual_memory: + virtual_mem_size: 8192 MiB + virtual_cpu: + cpu_architecture: x86 + num_virtual_cpu: 2 + virtual_cpu_clock: 1800 MHz + requirements: + - virtual_storage: mariaDbStorage + + mariaDbStorage: + type: tosca.nodes.nfv.Vdu.VirtualBlockStorage + properties: + virtual_block_storage_data: + size_of_storage: '200 GB' + rdma_enabled: true + artifacts: + sw_image: + type: tosca.artifacts.nfv.SwImage + file: maria.db.image.v1.0.qcow2 + properties: + name: Software of Maria Db + version: '1.0' + checksum: + algorithm: sha-256 + hash: b9c3036539fd7a5f87a1bf38eb05fdde8b556a1a7e664dbeda90ed3cd74b4f9d + container_format: bare + disk_format: qcow2 + min_disk: 2 GB + min_ram: 8192 MiB + size: 2 GB + operating_system: Linux + supported_virtualisation_environments: + - KVM + + dbBackendInternalCp: + type: tosca.nodes.nfv.VduCp + properties: + protocol: [associated_layer_protocol: ipv4 ] + trunk_mode: false + layer_protocols: [ ipv4 ] + role: leaf + description: Internal connection point on an VL + requirements: + - virtual_binding: dbBackend + - virtual_link: internalVl + + internalVl: + type: tosca.nodes.nfv.VnfVirtualLink + properties: + connectivity_type: + layer_protocols: [ ipv4, ethernet ] + flow_pattern: mesh + test_access: [] + description: Internal Virtual link in the VNF + vl_profile: + max_bitrate_requirements: + root: 100000 + leaf: 20000 + min_bitrate_requirements: + root: 10000 + leaf: 10000 + virtual_link_protocol_data: + - associated_layer_protocol: ethernet + l2_protocol_data: + network_type: vlan + segmentation_id: { get_input: segmentation_id_of_internalVl } + + dbBackendIpv4: + type: tosca.nodes.nfv.VduCp + properties: + protocol: [ associated_layer_protocol: ipv4 ] + trunk_mode: false + layer_protocols: [ ipv4 ] + role: leaf + description: External connection point to access the DB on IPv4 + requirements: + #- virtual_link: # the target node is determined in the NSD + - virtual_binding: dbBackend + + diff --git a/Example-data/example_A.6.1-01.yaml b/Example-data/example_A.6.1-01.yaml new file mode 100644 index 0000000000000000000000000000000000000000..31e071d9ab5798b5d78da110a954bd3804aff362 --- /dev/null +++ b/Example-data/example_A.6.1-01.yaml @@ -0,0 +1,309 @@ +# A.6.1-01.yaml +tosca_definitions_version: tosca_simple_yaml_1_3 +description: Complex scaling example (uniform delta value) described with policies +imports: + - etsi_nfv_sol001_vnfd_types.yaml # all of TOSCA VNFD types as defined in ETSI GS NFV-SOL 001 + +topology_template: + node_templates: + vdu_1: + type: tosca.nodes.nfv.Vdu.Compute + properties: + name: .. + description: .. + vdu_profile: + min_number_of_instances: 1 + max_number_of_instances: 5 + nfvi_constraints: + key_1: value_1 + key_2: value_2 + capabilities: + virtual_compute: + properties: + virtual_memory: + virtual_mem_size: 1 GB + virtual_cpu: + num_virtual_cpu: 1 + + vdu_2: + type: tosca.nodes.nfv.Vdu.Compute + properties: + name: .. + description: .. + vdu_profile: + min_number_of_instances: 1 + max_number_of_instances: 7 + nfvi_constraints: + key_1: value_1 + key_2: value_2 + capabilities: + virtual_compute: + properties: + virtual_memory: + virtual_mem_size: 1 GB + virtual_cpu: + num_virtual_cpu: 1 + + vdu_3: + type: tosca.nodes.nfv.Vdu.Compute + properties: + name: .. + description: .. + vdu_profile: + min_number_of_instances: 1 + max_number_of_instances: 5 + nfvi_constraints: + key_1: value_1 + key_2: value_2 + capabilities: + virtual_compute: + properties: + virtual_memory: + virtual_mem_size: 1 GB + virtual_cpu: + num_virtual_cpu: 1 + + vdu_4: + type: tosca.nodes.nfv.Vdu.Compute + properties: + name: .. + description: .. + vdu_profile: + min_number_of_instances: 1 + max_number_of_instances: 9 + nfvi_constraints: + key_1: value_1 + key_2: value_2 + capabilities: + virtual_compute: + properties: + virtual_memory: + virtual_mem_size: 1 GB + virtual_cpu: + num_virtual_cpu: 1 + + vl_1: + type: tosca.nodes.nfv.VnfVirtualLink + properties: + connectivity_type: + layer_protocols: [ ipv4 ] + vl_profile: + min_bitrate_requirements: + root: 1000000 + max_bitrate_requirements: + root: 2000000 + + vl_2: + type: tosca.nodes.nfv.VnfVirtualLink + properties: + connectivity_type: + layer_protocols: [ ipv4 ] + vl_profile: + min_bitrate_requirements: + root: 1000000 + max_bitrate_requirements: + root: 4000000 + + policies: + - scaling_aspects: + type: tosca.policies.nfv.ScalingAspects + properties: + aspects: + database: + name: .. + description: .. + max_scale_level: 2 + call_proc: + name: .. + description: .. + max_scale_level: 4 + + + - vdu_1_initial_delta: + type: tosca.policies.nfv.VduInitialDelta + properties: + initial_delta: + number_of_instances: 1 + targets: [ vdu_1 ] + + - vdu_1_scaling_aspect_deltas: + type: tosca.policies.nfv.VduScalingAspectDeltas + properties: + aspect: database + deltas: + delta_1: + number_of_instances: 2 + targets: [ vdu_1 ] + + + - vdu_2_initial_delta: + type: tosca.policies.nfv.VduInitialDelta + properties: + initial_delta: + number_of_instances: 1 + targets: [ vdu_2 ] + + - vdu_2_scaling_aspect_deltas: + type: tosca.policies.nfv.VduScalingAspectDeltas + properties: + aspect: database + deltas: + delta_1: + number_of_instances: 3 + targets: [ vdu_2 ] + + + - vl_1_bitrate_initial_delta: + type: tosca.policies.nfv.VirtualLinkBitrateInitialDelta + properties: + initial_delta: + bitrate_requirements: + root: 1000000 + targets: [ vl_1 ] + + - vl_1_bitrate_scaling_aspect_deltas: + type: tosca.policies.nfv.VirtualLinkBitrateScalingAspectDeltas + properties: + aspect: database + deltas: + delta_1: + bitrate_requirements: + root: 1000000 + targets: [ vl_1 ] + + + - vdu_3_initial_delta: + type: tosca.policies.nfv.VduInitialDelta + properties: + initial_delta: + number_of_instances: 1 + targets: [ vdu_3 ] + + - vdu_3_scaling_aspect_deltas: + type: tosca.policies.nfv.VduScalingAspectDeltas + properties: + aspect: call_proc + deltas: + delta_1: + number_of_instances: 1 + targets: [ vdu_3 ] + + - vdu_4_initial_delta: + type: tosca.policies.nfv.VduInitialDelta + properties: + initial_delta: + number_of_instances: 1 + targets: [ vdu_4 ] + + - vdu_4_scaling_aspect_deltas: + type: tosca.policies.nfv.VduScalingAspectDeltas + properties: + aspect: call_proc + deltas: + delta_1: + number_of_instances: 2 + targets: [ vdu_4 ] + + - vl_2_bitrate_initial_delta: + type: tosca.policies.nfv.VirtualLinkBitrateInitialDelta + properties: + initial_delta: + bitrate_requirements: + root: 1000000 + targets: [ vl_2 ] + + - vl_2_bitrate_scaling_aspect_deltas: + type: tosca.policies.nfv.VirtualLinkBitrateScalingAspectDeltas + properties: + aspect: call_proc + deltas: + delta_1: + bitrate_requirements: + root: 1000000 + targets: [ vl_2 ] + + - instantiation_levels: + type: tosca.policies.nfv.InstantiationLevels + properties: + levels: + instantiation_level_1: + description: .. + scale_info: + database: + scale_level: 0 + call_proc: + scale_level: 0 + instantiation_level_2: + description: .. + scale_info: + database: + scale_level: 2 + call_proc: + scale_level: 3 + default_level: instantiation_level_1 + + - vdu_1_instantiation_levels: + type: tosca.policies.nfv.VduInstantiationLevels + properties: + levels: + instantiation_level_1: + number_of_instances: 1 + instantiation_level_2: + number_of_instances: 5 + targets: [ vdu_1 ] + + - vdu_2_instantiation_levels: + type: tosca.policies.nfv.VduInstantiationLevels + properties: + levels: + instantiation_level_1: + number_of_instances: 1 + instantiation_level_2: + number_of_instances: 7 + targets: [ vdu_2 ] + + - vl_1_instantiation_levels: + type: tosca.policies.nfv.VirtualLinkInstantiationLevels + properties: + levels: + instantiation_level_1: + bitrate_requirements: + root: 30000 + instantiation_level_2: + bitrate_requirements: + root: 30000 + targets: [ vl_1 ] + + - vdu_3_instantiation_levels: + type: tosca.policies.nfv.VduInstantiationLevels + properties: + levels: + instantiation_level_1: + number_of_instances: 1 + instantiation_level_2: + number_of_instances: 4 + targets: [ vdu_3 ] + + - vdu_4_instantiation_levels: + type: tosca.policies.nfv.VduInstantiationLevels + properties: + levels: + instantiation_level_1: + number_of_instances: 1 + instantiation_level_2: + number_of_instances: 7 + targets: [ vdu_4 ] + + - vl_2_instantiation_levels: + type: tosca.policies.nfv.VirtualLinkInstantiationLevels + properties: + levels: + instantiation_level_1: + bitrate_requirements: + root: 30000 + instantiation_level_2: + bitrate_requirements: + root: 60000 + + targets: [ vl_2 ] + diff --git a/Example-data/example_A.6.2-01.yaml b/Example-data/example_A.6.2-01.yaml new file mode 100644 index 0000000000000000000000000000000000000000..789790c0dd30f660e53b180bed28697f176547d0 --- /dev/null +++ b/Example-data/example_A.6.2-01.yaml @@ -0,0 +1,211 @@ +# A.6.2-01.yaml +tosca_definitions_version: tosca_simple_yaml_1_3 +description: Complex example (uniform and non-uniform delta value) described with policies +imports: + - etsi_nfv_sol001_vnfd_types.yaml # all of TOSCA VNFD types as defined in ETSI GS NFV-SOL 001 + +topology_template: + node_templates: + db: + type: tosca.nodes.nfv.Vdu.Compute + properties: + name: .. + description: .. + vdu_profile: + min_number_of_instances: 2 + max_number_of_instances: 6 + nfvi_constraints: + key_1: value_1 + key_2: value_2 + capabilities: + virtual_compute: + properties: + virtual_memory: + virtual_mem_size: 1 GB + virtual_cpu: + num_virtual_cpu: 1 + + oam: + type: tosca.nodes.nfv.Vdu.Compute + properties: + name: .. + description: .. + vdu_profile: + min_number_of_instances: 1 + max_number_of_instances: 1 + nfvi_constraints: + key_1: value_1 + key_2: value_2 + capabilities: + virtual_compute: + properties: + virtual_memory: + virtual_mem_size: 1 GB + virtual_cpu: + num_virtual_cpu: 1 + + + processing: + type: tosca.nodes.nfv.Vdu.Compute + properties: + name: .. + description: .. + vdu_profile: + min_number_of_instances: 4 + max_number_of_instances: 12 + nfvi_constraints: + key_1: value_1 + key_2: value_2 + capabilities: + virtual_compute: + properties: + virtual_memory: + virtual_mem_size: 1 GB + virtual_cpu: + num_virtual_cpu: 1 + + processing_auxiliary: + type: tosca.nodes.nfv.Vdu.Compute + properties: + name: .. + description: .. + vdu_profile: + min_number_of_instances: 1 + max_number_of_instances: 3 + nfvi_constraints: + key_1: value_1 + key_2: value_2 + capabilities: + virtual_compute: + properties: + virtual_memory: + virtual_mem_size: 1 GB + virtual_cpu: + num_virtual_cpu: 1 + + + policies: + - scaling_aspects: + type: tosca.policies.nfv.ScalingAspects + properties: + aspects: + database: + name: .. + description: .. + max_scale_level: 2 + step_deltas: + - delta_1 + - delta_1 + proc: + name: .. + description: .. + max_scale_level: 4 + step_deltas: + - delta_1 + - delta_2 + - delta_1 + - delta_2 + + - db_initial_delta: + type: tosca.policies.nfv.VduInitialDelta + properties: + initial_delta: + number_of_instances: 2 + targets: [ db ] + + - db_scaling_aspect_deltas: + type: tosca.policies.nfv.VduScalingAspectDeltas + properties: + aspect: database + deltas: + delta_1: + number_of_instances: 2 + targets: [ db ] + + - oam_initial_delta: + type: tosca.policies.nfv.VduInitialDelta + properties: + initial_delta: + number_of_instances: 1 + targets: [ oam ] + + - processing_initial_delta: + type: tosca.policies.nfv.VduInitialDelta + properties: + initial_delta: + number_of_instances: 4 + targets: [ processing ] + + - processing_scaling_aspect_deltas: + type: tosca.policies.nfv.VduScalingAspectDeltas + properties: + aspect: proc + deltas: + delta_1: + number_of_instances: 2 + delta_2: + number_of_instances: 2 + targets: [ processing ] + + - processing_auxiliary_initial_delta: + type: tosca.policies.nfv.VduInitialDelta + properties: + initial_delta: + number_of_instances: 1 + targets: [ processing_auxiliary ] + + - processing_auxiliary_scaling_aspect_deltas: + type: tosca.policies.nfv.VduScalingAspectDeltas + properties: + aspect: proc + deltas: + delta_1: + number_of_instances: 1 + delta_2: + number_of_instances: 0 + targets: [ processing_auxiliary ] + + - instantiation_levels: + type: tosca.policies.nfv.InstantiationLevels + properties: + levels: + instantiation_level_1: + description: .. + scale_info: + database: + scale_level: 0 + proc: + scale_level: 0 + + - db_instantiation_levels: + type: tosca.policies.nfv.VduInstantiationLevels + properties: + levels: + instantiation_level_1: + number_of_instances: 2 + targets: [ db ] + + - oam_instantiation_levels: + type: tosca.policies.nfv.VduInstantiationLevels + properties: + levels: + instantiation_level_1: + number_of_instances: 1 + targets: [ oam ] + + - processing_instantiation_levels: + type: tosca.policies.nfv.VduInstantiationLevels + properties: + levels: + instantiation_level_1: + number_of_instances: 4 + targets: [ processing ] + + - processing_auxiliary_instantiation_levels: + type: tosca.policies.nfv.VduInstantiationLevels + properties: + levels: + instantiation_level_1: + number_of_instances: 1 + targets: [ processing_auxiliary ] + diff --git a/Example-data/example_A.7.2-01.yaml b/Example-data/example_A.7.2-01.yaml new file mode 100644 index 0000000000000000000000000000000000000000..637f99aff896afb92e47dff94a81370d3dd0256c --- /dev/null +++ b/Example-data/example_A.7.2-01.yaml @@ -0,0 +1,76 @@ +# A.7.2-01.yaml +tosca_definitions_version: tosca_simple_yaml_1_3 +imports: + - etsi_nfv_sol001_nsd_types.yaml # all of TOSCA NSD types as defined in ETSI GS NFVSOL 001 + - example_VNF2.yaml + + +node_types: + tosca.nodes.nfv.exampleNS: + derived_from: tosca.nodes.nfv.NS + properties: + descriptor_id: + type: string + constraints: [ valid_values: [ b1bb0ce7-ebca-4fa7-95ed-4840d70a1177 ] ] + default: b1bb0ce7-ebca-4fa7-95ed-4840d70a1177 + designer: + type: string + constraints: [ valid_values: [ MyCompany] ] + default: MyCompany + name: + type: string + constraints: [ valid_values: [ ExampleService ] ] + default: ExampleService + version: + type: string + constraints: [ valid_values: [ '1.0' ] ] + default: '1.0' + invariant_id: + type: string + constraints: [ valid_values: [ 1111-2222-aaaa-bbbb ] ] + default: 1111-2222-aaaa-bbbb + flavour_id: + type: string + constraints: [ valid_values: [ small, big ] ] + default: small + requirements: + - virtual_link: + capability: tosca.capabilities.nfv.VirtualLinkable + relationship: tosca.relationships.nfv.VirtualLinksTo + +#... + +topology_template: + +#... + + substitution_mappings: + node_type: tosca.nodes.nfv.exampleNS + requirements: + virtual_link: [VNF_2, virtual_link_2] # the External connection point of VNF_2 + # will be used as the Sap of this NS + + node_templates: + VNF_2: + type: tosca.nodes.nfv.example_VNF2 + # properties omitted for brevity + requirements: + - virtual_link_1: NsVirtualLink_1 # connects to the External connection + # point which maps to the + # virtual_link_1 requirement of VNF_2 + # - virtual_link_2: # mapped to virtual_link requirement of NS node + + NsVirtualLink_1: + type: tosca.nodes.nfv.NsVirtualLink + properties: + vl_profile: + min_bitrate_requirements: + root: 100000 + max_bitrate_requirements: + root: 200000 + connectivity_type: + layer_protocols: [ ipv4 ] + + # other node template definitions + #... + diff --git a/Example-data/example_A.7.3-01.yaml b/Example-data/example_A.7.3-01.yaml new file mode 100644 index 0000000000000000000000000000000000000000..99001fb2bfe33108bc0677c54f620c3a78ba8eab --- /dev/null +++ b/Example-data/example_A.7.3-01.yaml @@ -0,0 +1,73 @@ +# A.7.3-01.yaml +tosca_definitions_version: tosca_simple_yaml_1_3 +imports: + - etsi_nfv_sol001_nsd_types.yaml # all of TOSCA NSD types as defined in ETSI GS NFVSOL 001 + +node_types: + tosca.nodes.nfv.exampleNS: + derived_from: tosca.nodes.nfv.NS + properties: + descriptor_id: + type: string + constraints: [ valid_values: [ b1bb0ce7-ebca-4fa7-95ed-4840d70a1177 ] ] + default: b1bb0ce7-ebca-4fa7-95ed-4840d70a1177 + designer: + type: string + constraints: [ valid_values: [ MyCompany] ] + default: MyCompany + name: + type: string + constraints: [ valid_values: [ ExampleService ] ] + default: ExampleService + version: + type: string + constraints: [ valid_values: [ '1.0' ] ] + default: '1.0' + invariant_id: + type: string + constraints: [ valid_values: [ 1111-2222-aaaa-bbbb ] ] + default: 1111-2222-aaaa-bbbb + flavour_id: + type: string + constraints: [ valid_values: [ small, big ] ] + default: small + requirements: + - virtual_link: + capability: tosca.capabilities.nfv.VirtualLinkable + relationship: tosca.relationships.nfv.VirtualLinksTo + +topology_template: +#... + + substitution_mappings: + node_type: tosca.nodes.nfv.exampleNS + requirements: + virtual_link: [SAP_1, external_virtual_link] #SAP_1 is the Sap of the NS + + node_templates: + SAP_1: + type: tosca.nodes.nfv.Sap + properties: + protocol: [ associated_layer_protocol: ipv4 ] + trunk_mode: false + layer_protocols: [ ipv4 ] + # other properties omitted for brevity + requirements: + - internal_virtual_link: NsVirtualLink_1 + # - external_virtual_link: # map to virtual_link requirement of the NS node + + NsVirtualLink_1: + type: tosca.nodes.nfv.NsVirtualLink + properties: + vl_profile: + min_bitrate_requirements: + root: 100000 + max_bitrate_requirements: + root: 200000 + connectivity_type: + layer_protocols: [ ipv4 ] + + + # Other node templates + #... + diff --git a/Example-data/example_A.8-01.yaml b/Example-data/example_A.8-01.yaml new file mode 100644 index 0000000000000000000000000000000000000000..d96e426ce4a39d90779ee5fda3cc3cfc50950abc --- /dev/null +++ b/Example-data/example_A.8-01.yaml @@ -0,0 +1,183 @@ +# A.8-01.yaml +tosca_definitions_version: tosca_simple_yaml_1_3 + +description: Relational database, simple + +imports: + - etsi_nfv_sol001_nsd_types.yaml # all of NSD related TOSCA types as defined in ETSI GS NFV-SOL 001 + - example_VNF1.yaml # uri of the yaml file which contains the definition of tosca.nodes.nfv.example_VNF1, this file might be included in the NSD file structure + - example_VNF2.yaml # uri of the yaml file which contains the definition of tosca.nodes.nfv.example_VNF2, this file might be included in the NSD file structure + + +data_types: + MyCompany.datatypes.nfv.NsInstantiateAdditionalParameters: + derived_from: tosca.datatypes.nfv.NsOperationAdditionalParameters + properties: + parameter_1: + type: string + required: true + default: value_1 + parameter_2: + type: string + required: true + default: value_2 + +node_types: + tosca.example_NS: + derived_from: tosca.nodes.nfv.NS + properties: + descriptor_id: + type: string + constraints: [ equal: b1bb0ce7-ebca-4fa7-95ed-4840d70a1177 ] + default: b1bb0ce7-ebca-4fa7-95ed-4840d70a1177 + designer: + type: string + constraints: [ equal: MyCompany ] + default: MyCompany + name: + type: string + constraints: [ equal: ExampleService ] + default: ExampleService + version: + type: string + constraints: [ equal: '1.0' ] + default: '1.0' + invariant_id: + type: string + constraints: [ equal: 1111-2222-aaaa-bbbb ] + default: 1111-2222-aaaa-bbbb + flavour_id: + type: string + constraints: [ equal: simple ] + default: simple + interfaces: + Nslcm: + type: tosca.interfaces.nfv.Nslcm + operations: + instantiate: + inputs: + additional_parameters: + type: MyCompany.datatypes.nfv.NsInstantiateAdditionalParameters + + +topology_template: + substitution_mappings: + node_type: tosca.example_NS + requirements: + virtual_link: [ VNF_2, virtual_link_2 ] # the External connection point of + # VNF_2 is exposed as the Sap + + node_templates: + my_service: + type: tosca.example_NS + properties: + descriptor_id: b1bb0ce7-ebca-4fa7-95ed-4840d70a1177 + designer: MyCompany + name: ExampleService + version: '1.0' + invariant_id: 1111-2222-aaaa-bbbb + flavour_id: simple + interfaces: + Nslcm: + operations: + instantiate: + implementation: instantiate.workflow.yaml + terminate: + implementation: terminate.workflow.yaml + + VNF_1: + type: tosca.nodes.nfv.example_VNF1 + properties: + # no property assignments needed for required properties that have a default value assigned in the node type definition, e.g. descriptor_id + flavour_id: simple + vnf_profile: + instantiation_level: level_1 + min_number_of_instances: 2 + max_number_of_instances: 6 + requirements: + - virtual_link: NsVirtualLink_1 + + VNF_2: + type: tosca.nodes.nfv.example_VNF2 + properties: + flavour_id: simple + vnf_profile: + instantiation_level: level_1 + min_number_of_instances: 1 + max_number_of_instances: 3 + requirements: + - virtual_link_1: NsVirtualLink_1 + # - virtual_link_2: # map to virtual_link requirement of the NS node + - dependency: VNF_1 + + NsVirtualLink_1: + type: tosca.nodes.nfv.NsVirtualLink + properties: + connectivity_type: + layer_protocols: [ipv4, ethernet] + flow_pattern: mesh + vl_profile: + max_bitrate_requirements: + root: 1000 + min_bitrate_requirements: + root: 1000 + virtual_link_protocol_data: + - associated_layer_protocol: ethernet + l2_protocol_data: + name: nsBaseNetwork + network_type: vlan + segmentation_id: VLAN100 + - associated_layer_protocol: ipv4 + l3_protocol_data: + name: mybaseSubnet + ip_version: ipv4 + cidr: 192.168.0.0/24 + + policies: + - my_service_NsMonitoring: + type: tosca.policies.nfv.NsMonitoring + properties: + ns_monitoring_parameters: + ns_monitoring_1111: #key map to the id of this monitoring parameter + name: MyService_byte_incoming_sap + performance_metric: byte_incoming_sap + collection_period: 1 s + ns_monitoring_2222: #key map to the id of this monitoring parameter + name: MyService_byte_outgoing_sap + performance_metric: byte_outgoing_sap + collection_period: 1 s + targets: [ my_service ] + + - VNF_1_VnfMonitoring: + type: tosca.policies.nfv.VnfMonitoring + properties: + vnf_monitoring_parameters: + vnf_1_monitoring_1111: #key map to the id of this monitoring parameter + name: VNF_1_v_cpu_usage_mean_vnf + performance_metric: v_cpu_usage_mean_vnf + collection_period: 1 s + vnf_1_monitoring_2222: #key map to the id of this monitoring parameter + name: VNF_1_v_disk_usage_mean_vnf + performance_metric: v_disk_usage_mean_vnf + collection_period: 1 s + targets: [ VNF_1 ] + + - VNF_2_VnfMonitoring: + type: tosca.policies.nfv.VnfMonitoring + properties: + vnf_monitoring_parameters: + vnf_2_monitoring_1111: #key map to the id of this monitoring parameter + name: VNF_2_v_cpu_usage_mean_vnf + performance_metric: v_cpu_usage_mean_vnf + collection_period: 1 s + vnf_2_monitoring_2222: #key map to the id of this monitoring parameter + name: VNF_2_v_disk_usage_mean_vnf + performance_metric: v_disk_usage_mean_vnf + collection_period: 1 s + vnf_2_monitoring_3333: #key map to the id of this monitoring parameter + name: VNF_2_v_memory_usage_mean_vnf + performance_metric: v_memory_usage_mean_vnf + collection_period: 1 s + targets: [ VNF_2 ] + + diff --git a/Example-data/example_E.2.3-01.yaml b/Example-data/example_E.2.3-01.yaml new file mode 100644 index 0000000000000000000000000000000000000000..a2a925ede4e736444eb9e50ba644d84cea1375f1 --- /dev/null +++ b/Example-data/example_E.2.3-01.yaml @@ -0,0 +1,205 @@ +# E.2.3-01.yaml +tosca_definitions_version: tosca_simple_yaml_1_3 + +description: NS TOSCA Imperative Workflows + +imports: + - etsi_nfv_sol001_nsd_types.yaml # all of NSD related TOSCA types as defined in ETSI GS NFVSOL 001 + - example_vnf1.yaml # uri of the yaml file which contains the tosca.nodes.nfv.example_VNF1 node type definition, this file might be included in the NSD file structure + - example_vnf2.yaml # uri of the yaml file which contains the tosca.nodes.nfv.example_VNF2 node type definition, this file might be included in the NSD file structure + +data_types: + MyCompany.datatypes.nfv.NsInstantiateAdditionalParameters: + derived_from: tosca.datatypes.nfv.NsOperationAdditionalParameters + properties: + parameter_1: + type: string + required: true + default: value_1 + parameter_2: + type: string + required: true + default: value_2 + +node_types: + tosca.example_NS: + derived_from: tosca.nodes.nfv.NS + properties: + descriptor_id: + type: string + constraints: [ equal: b1bb0ce7-ebca-4fa7-95ed-4840d70a1177 ] + default: b1bb0ce7-ebca-4fa7-95ed-4840d70a1177 + designer: + type: string + constraints: [ equal: MyCompany ] + default: MyCompany + name: + type: string + constraints: [ equal: ExampleService ] + default: ExampleService + version: + type: string + constraints: [ equal: '1.0' ] + default: '1.0' + invariant_id: + type: string + constraints: [ equal: 1111-2222-aaaa-bbbb ] + default: 1111-2222-aaaa-bbbb + flavour_id: + type: string + constraints: [ equal: simple ] + default: simple + +topology_template: + substitution_mappings: + node_type: tosca.example_NS + requirements: + virtual_link: [ VNF_2, virtual_link_2 ] # the External connection point of + # VNF_2 is exposed as the Sap + + node_templates: +# This abstract node template enables the NSD author to use Nslcm scripts if he does #not use workflows. + my_service: + type: tosca.example_NS + properties: + descriptor_id: b1bb0ce7-ebca-4fa7-95ed-4840d70a1177 + designer: MyCompany + name: ExampleService + version: '1.0' + invariant_id: 1111-2222-aaaa-bbbb + flavour_id: simple + interfaces: + Nslcm: + operations: + instantiate: + implementation: instantiate.workflow.yaml + terminate: + implementation: terminate.workflow.yaml + + VNF_1: + type: tosca.nodes.nfv.example_VNF1 + properties: + # no property assignments needed for required properties that have a default #value assigned in the node type definition, e.g. descriptor_id + flavour_id: simple + vnf_profile: + instantiation_level: level_1 + min_number_of_instances: 2 + max_number_of_instances: 6 + requirements: + - virtual_link: NsVirtualLink_1 +# Additional parameters input to be defined in the VNFD of VNF_1. + # interfaces: + # Vnflcm: + # operations: + # instantiate: . . . + # terminate: . . . + + VNF_2: + type: tosca.nodes.nfv.example_VNF2 + properties: + flavour_id: simple + vnf_profile: + instantiation_level: level_1 + min_number_of_instances: 1 + max_number_of_instances: 3 + requirements: + - virtual_link_1: NsVirtualLink_1 + # - virtual_link_2: # map to virtual_link requirement of the NS node + - dependency: VNF_1 + +# Additional parameters input to be defined in the VNFD of VNF_2. + # interfaces: + # Vnflcm: + # operations: + # instantiate: . . . + # terminate: . . . + + NsVirtualLink_1: + type: tosca.nodes.nfv.NsVirtualLink + properties: + connectivity_type: + layer_protocols: [ipv4] + flow_pattern: mesh + vl_profile: + max_bitrate_requirements: + root: 1000 + min_bitrate_requirements: + root: 1000 + + workflows: + instantiate: #instantiate workflow + inputs: + additional_parameters: + type: MyCompany.datatypes.nfv.NsInstantiateAdditionalParameters + required: false + steps: + # preamble steps for instantiate operation. These correspond to preparatory #steps internal to the NFVO before instantiate operation + + instantiate_start_step_1: + #. . . + target: my_service + activities: [] + on_success: + - create_VNF_1 + + + # steps for instantiate workflow + create_VNF_1: # Step: Instantiate VNF_1 + target: VNF_1 + activities: + - call_operation: Vnflcm.instantiate +# invoking Vnflcm.instantiate operation enables NFVO to use internal implementation of #Vnflcm.instantiate operation which results in an ETSI GS NFV-SOL 003 API call towards #the VNFM to call VnfInstantiate operation. This enables VNFM to execute LCM operations #to deploy VNF_1 + on_success: + - create_VNF_2 + # . . . + + create_VNF_2: # Step: Instantiate VNF_2 + target: VNF_2 + activities: + - call_operation: Vnflcm.instantiate + # invoking Vnflcm.instantiate operation enables NFVO to use internal implementation of #Vnflcm.instantiate operation which results in an ETSI GS NFV-SOL 003 API call towards #the VNFM to call VnfInstantiate operation. This enables VNFM to execute LCM operations #to deploy VNF_2 + on_success: + - instantiate_end_step_1 +#. . . + # postamble steps for instantiate operation. These correspond to closing steps #internal to the NFVO after instantiate operation. + + instantiate_end_step_1: + #. . . + target: my_service + activities: [] + + terminate: #terminate workflow + steps: + # preamble steps for terminate operation. These correspond to preparatory #steps internal to the NFVO before terminate operation. + terminate_start_step_1: + # . . . + target: my_service + activities: [] + on_success: + - terminate_VNF_2 + + # steps for terminate workflow + terminate_VNF_1: # Step: Terminate VNF_1 + target: VNF_1 + activities: + - call_operation: Vnflcm.terminate +# invoking Vnflcm.terminate operation enables NFVO to use internal implementation of #Vnflcm.terminate operation which results in an ETSI GS NFV-SOL 003 API call towards #the VNFM to call VnfTerminate operation. This enables VNFM to execute LCM operations #to terminate VNF_1 + on_success: + - terminate_end_step_1 + # . . . + + terminate_VNF_2: # Step: Terminate VNF_2 + target: VNF_2 + activities: + - call_operation: Vnflcm.terminate + # invoking Vnflcm.terminate operation enables NFVO to use internal implementation of #Vnflcm.terminate operation which results in an ETSI GS NFV-SOL 003 API call towards #the VNFM to call VnfTerminate operation. This enables VNFM to execute LCM operations #to terminate VNF_2 + on_success: + - terminate_VNF_1 + #. . . + # post amble steps for terminate operation. These correspond to closing steps #internal to the NFVO after terminate operation. + + terminate_end_step_1: + target: my_service + activities: [] + # . . . + diff --git a/etsi_nfv_sol001_common_types.yaml b/etsi_nfv_sol001_common_types.yaml index 3f5dfc3f2930b0283d42e12bd60139cc834b0a7e..763916df1f548bbd22ac8d1e155dad9f5c0607f0 100644 --- a/etsi_nfv_sol001_common_types.yaml +++ b/etsi_nfv_sol001_common_types.yaml @@ -1,31 +1,31 @@ tosca_definitions_version: tosca_simple_yaml_1_3 -description: ETSI NFV SOL 001 common types definitions version 3.6.1 +description: ETSI NFV SOL 001 common types definitions version 3.7.1 metadata: template_name: etsi_nfv_sol001_common_types template_author: ETSI_NFV - template_version: 3.6.1 - + template_version: 3.7.1 data_types: + tosca.datatypes.nfv.L2AddressData: derived_from: tosca.datatypes.Root description: Describes the information on the MAC addresses to be assigned to a connection point. properties: mac_address_assignment: type: boolean - description: Specifies if the address assignment is the responsibility of management and orchestration function or not. If it is set to True, it is the management and orchestration function responsibility - required: true - + description: Specifies which mode is used for the MAC address assignment. If it is set to True, a MAC address is expected to be provided by a management entity via the NFV MANO interfaces towards the VNFM using attributes standardized for this purpose in the NFV-MANO information model and is further transferred from the VNFM to the VIM. A MAC address will be automatically assigned by the VIM/NFVI as fallback if not provided. If it is set to False, a MAC address is expected to it will be assigned by means specific to the VNF itself (e.g., by an LCM script, by the EM) and is further transferred from the VNFM to the VIM. A MAC address will be automatically assigned by the VIM/NFVI as fallback if not provided to the VIM. + required: true + tosca.datatypes.nfv.L3AddressData: derived_from: tosca.datatypes.Root description: Provides information about Layer 3 level addressing scheme and parameters applicable to a CP properties: ip_address_assignment: type: boolean - description: Specify which mode is used for the IP address assignment. If it is set to True, IP configuration information shall be provided for the VNF by a management entity using the NFV MANO interfaces towards the VNFM. If it is set to False, the value of the ip_address_assignment_subtype property defines the method of IP address assignment. Shall be present if the fixed_ip_address property is not present and should be absent otherwise. See note - required: true + description: Specify which mode is used for the IP address assignment. If it is set to True, IP configuration information shall be provided for the VNF by a management entity using the NFV MANO interfaces towards the VNFM. If it is set to False, the value of the ip_address_assignment_subtype property defines the method of IP address assignment. Shall be present if the fixed_ip_address property is not present and should be absent otherwise. See note. + required: false ip_address_assignment_subtype: - type: boolean - description: Method of IP address assignment in case the IP configuration is not provided using the NFV MANO interfaces towards the VNFM. Description of the valid values: (1) dynamic: the VNF gets an IP address dynamically from the NFVI (i.e., using DHCP), (2) vnf_pkg: an IP address defined by the VNF provider is assigned by means included as part of the VNF package (e.g., LCM script); (3) external: an IP address is provided by an external management entity (such as EM) directly towards the VNF.Shall be present in case the ip_address_assignment property is set to False and shall be absent otherwise. + type: string + description: "Method of IP address assignment in case the IP configuration is not provided using the NFV MANO interfaces towards the VNFM. Description of the valid values: (1) dynamic: the VNF gets an IP address dynamically from the NFVI (i.e., using DHCP), (2) vnf_pkg: an IP address defined by the VNF provider is assigned by means included as part of the VNF package (e.g., LCM script); (3) external: an IP address is provided by an external management entity (such as EM) directly towards the VNF.Shall be present in case the ip_address_assignment property is set to False and shall be absent otherwise." required: false constraints: - valid_values: [ dynamic, vnf_pkg, external ] @@ -35,7 +35,7 @@ data_types: required: true ip_address_type: type: string - description: Defines address type. The address type should be aligned with the address type supported by the layer_protocols properties of the connetion point + description: Defines address type. The address type should be aligned with the address type supported by the layer_protocols properties of the connection point required: false constraints: - valid_values: [ ipv4, ipv6 ] @@ -77,7 +77,7 @@ data_types: properties: layer_protocols: type: list - description: Identifies the protocol a virtualLink gives access to (ethernet, mpls, odu2, ipv4, ipv6, pseudo-wire).The top layer protocol of the virtualLink protocol stack shall always be provided. The lower layer protocols may be included when there are specific requirements on these layers. + description: Identifies the protocol a virtualLink gives access to (ethernet, mpls, odu2, ipv4, ipv6, pseudo-wire). The top layer protocol of the virtualLink protocol stack shall always be provided. The lower layer protocols may be included when there are specific requirements on these layers. required: true entry_schema: type: string @@ -113,8 +113,8 @@ data_types: properties: associated_layer_protocol: type: string + description: One of the values of the property layer_protocols of the CP required: true - description: One of the values of the property layer_protocols of the CP constraints: - valid_values: [ ethernet, mpls, odu2, ipv4, ipv6, pseudo-wire ] address_data: @@ -124,10 +124,33 @@ data_types: type: tosca.datatypes.nfv.AddressData required: false + tosca.datatypes.nfv.Qos: + derived_from: tosca.datatypes.Root + description: describes QoS data for a given VL used in a VNF deployment flavour + properties: + latency: + type: scalar-unit.time #Number + description: Specifies the maximum latency + required: true + constraints: + - greater_than: 0 s + packet_delay_variation: + type: scalar-unit.time #Number + description: Specifies the maximum jitter + required: true + constraints: + - greater_or_equal: 0 s + packet_loss_ratio: + type: float + description: Specifies the maximum packet loss ratio + required: false + constraints: + - in_range: [ 0.0, 1.0 ] + tosca.datatypes.nfv.VnfProfile: derived_from: tosca.datatypes.Root description: describes a profile for instantiating VNFs of a particular NS DF according to a specific VNFD and VNF DF. - properties: + properties: instantiation_level: type: string description: Identifier of the instantiation level of the VNF DF to be used for instantiation. If not present, the default instantiation level as declared in the VNFD shall be used. @@ -151,70 +174,51 @@ data_types: constraints: - greater_or_equal: 1 - tosca.datatypes.nfv.Qos: - derived_from: tosca.datatypes.Root - description: describes QoS data for a given VL used in a VNF deployment flavour - properties: - latency: - type: scalar-unit.time #Number - description: Specifies the maximum latency - required: true - constraints: - - greater_than: 0 s - packet_delay_variation: - type: scalar-unit.time #Number - description: Specifies the maximum jitter - required: true - constraints: - - greater_or_equal: 0 s - packet_loss_ratio: - type: float - description: Specifies the maximum packet loss ratio - required: false - constraints: - - in_range: [ 0.0, 1.0 ] - tosca.datatypes.nfv.VnfMonitoringParameter: derived_from: tosca.datatypes.Root description: Represents information on virtualised resource related performance metrics applicable to the VNF. properties: name: - type: string - description: Human readable name of the monitoring parameter - required: true + type: string + description: Human readable name of the monitoring parameter + required: true performance_metric: - type: string - description: Identifies a performance metric to be monitored, according to ETSI GS NFV-IFA 027. - required: true - constraints: - - valid_values: [ v_cpu_usage_mean_vnf, v_cpu_usage_peak_vnf, v_memory_usage_mean_vnf, v_memory_usage_peak_vnf, v_disk_usage_mean_vnf, v_disk_usage_peak_vnf, byte_incoming_vnf_ext_cp, byte_outgoing_vnf_ext_cp, packet_incoming_vnf_ext_cp, packet_outgoing_vnf_ext_cp ] + type: string + description: Identifies a performance metric to be monitored, according to ETSI GS NFV-IFA 027 + required: true + constraints: + - valid_values: [ v_cpu_usage_mean_vnf, v_cpu_usage_peak_vnf, v_memory_usage_mean_vnf, v_memory_usage_peak_vnf, v_disk_usage_mean_vnf, v_disk_usage_peak_vnf, byte_incoming_vnf_ext_cp, byte_outgoing_vnf_ext_cp, +packet_incoming_vnf_ext_cp, packet_outgoing_vnf_ext_cp ] collection_period: - type: scalar-unit.time - description: Describes the periodicity at which to collect the performance information. - required: false - constraints: - - greater_than: 0 s - + type: scalar-unit.time + description: Describes the periodicity at which to collect the performance information. + required: false + constraints: + - greater_than: 0 s + capability_types: + tosca.capabilities.nfv.VirtualLinkable: derived_from: tosca.capabilities.Node description: A node type that includes the VirtualLinkable capability indicates that it can be pointed by tosca.relationships.nfv.VirtualLinksTo relationship type - + relationship_types: + tosca.relationships.nfv.VirtualLinksTo: derived_from: tosca.relationships.DependsOn - description: Represents an association relationship between the VduCp and VnfVirtualLink node types or the association between either a VnfExtCp, a PnfExtCp or a Sap and an NsVirtualLink node types. + description: Represents an association relationship between the VduCp and VnfVirtualLink node types or the association between either a VnfExtCp, a PnfExtCp or a Sap and an NsVirtualLink node types. valid_target_types: [ tosca.capabilities.nfv.VirtualLinkable ] tosca.relationships.nfv.VipVirtualLinksTo: derived_from: tosca.relationships.DependsOn description: Represents an association relationship between the VipCp and a VnfVirtualLink node types or between the former and a NsVirtualLink node types. valid_target_types: [ tosca.capabilities.nfv.VirtualLinkable ] - + node_types: + tosca.nodes.nfv.Cp: derived_from: tosca.nodes.Root - description: Provides information regarding the purpose of the connection point + description: Provides information regarding the purpose of the connection point properties: layer_protocols: type: list @@ -224,7 +228,7 @@ node_types: type: string constraints: - valid_values: [ ethernet, mpls, odu2, ipv4, ipv6, pseudo-wire ] - role: #Name in ETSI NFV IFA011: cpRole + role: #Name in ETSI GS NFV-IFA 011: cpRole type: string description: Identifies the role of the port in the context of the traffic flow patterns in the VNF or parent NS required: false @@ -242,10 +246,11 @@ node_types: type: tosca.datatypes.nfv.CpProtocolData trunk_mode: type: boolean - description: Provides information about whether the CP instantiated from this Cp is in Trunk mode (802.1Q or other), When operating in "trunk mode", the Cp is capable of carrying traffic for several VLANs. Absence of this property implies that trunkMode is not configured for the Cp i.e. It is equivalent to boolean value "false". + description: Provides information about whether the CP instantiated from this Cp is in Trunk mode (802.1Q or other). When operating in "trunk mode", the Cp is capable of carrying traffic for several VLANs. Absence of this property implies that trunkMode is not configured for the Cp i.e. It is equivalent to boolean value "false". required: false policy_types: + tosca.policies.nfv.Abstract.SecurityGroupRule: derived_from: tosca.policies.Root description: The Abstract.SecurityGroupRule type represents an abstract policy type without any target requirements @@ -256,7 +261,7 @@ policy_types: required: false direction: type: string - description: The direction in which the security group rule is applied. The direction of 'ingress' or 'egress' is specified against the associated CP. I.e., 'ingress' means the packets entering a CP, while 'egress' means the packets sent out of a CP. + description: The direction in which the security group rule is applied. The direction of 'ingress' or 'egress' is specified against the associated CP. I.e. 'ingress' means the packets entering a CP, while 'egress' means the packets sent out of a CP. required: true constraints: - valid_values: [ ingress, egress ] @@ -291,5 +296,3 @@ policy_types: - greater_or_equal: 0 - less_or_equal: 65535 default: 65535 - - diff --git a/etsi_nfv_sol001_nsd_types.yaml b/etsi_nfv_sol001_nsd_types.yaml index efbdeec750250aebbdebef4a42c42d17a9be6873..c2721323f5a566570aaed7472c403e4e837cddfe 100644 --- a/etsi_nfv_sol001_nsd_types.yaml +++ b/etsi_nfv_sol001_nsd_types.yaml @@ -1,17 +1,17 @@ tosca_definitions_version: tosca_simple_yaml_1_3 -description: ETSI NFV SOL 001 nsd types definitions version 3.6.1 +description: ETSI NFV SOL 001 nsd types definitions version 3.7.1 metadata: template_name: etsi_nfv_sol001_nsd_types template_author: ETSI_NFV - template_version: 3.6.1 + template_version: 3.7.1 imports: - - https://forge.etsi.org/rep/nfv/SOL001/raw/v3.6.1/etsi_nfv_sol001_common_types.yaml - - https://forge.etsi.org/rep/nfv/SOL001/raw/v3.6.1/etsi_nfv_sol001_vnfd_types.yaml - - https://forge.etsi.org/rep/nfv/SOL001/raw/v3.6.1/etsi_nfv_sol001_pnfd_types.yaml -# editor's note: During the development of the SOL001ed361 GS, to enable this file to be verified by a TOSCA parser, the imports statement has to be replaced with a reference to a local copy of the common definitions YAML file + - etsi_nfv_sol001_common_types.yaml + - etsi_nfv_sol001_vnfd_types.yaml + - etsi_nfv_sol001_pnfd_types.yaml data_types: + tosca.datatypes.nfv.NsVlProfile: derived_from: tosca.datatypes.Root description: Describes additional instantiation data for a given NsVirtualLink used in a specific NS deployment flavour. @@ -50,7 +50,7 @@ data_types: constraints: - greater_or_equal: 0 description: Specifies the priority level in case of congestion on the underlying physical links - required: false + required: false tosca.datatypes.nfv.NsProfile: derived_from: tosca.datatypes.Root @@ -72,10 +72,6 @@ data_types: required: true constraints: - greater_or_equal: 0 - flavour_id: - type: string - description: Identifies the applicable network service DF within the scope of the NSD. - required: true tosca.datatypes.nfv.Mask: derived_from: tosca.datatypes.Root @@ -83,21 +79,25 @@ data_types: starting_point: description: Indicates the offset between the last bit of the source mac address and the first bit of the sequence of bits to be matched. type: integer + constraints: + - greater_or_equal: 1 required: true length: description: Indicates the number of bits to be matched. type: integer + constraints: + - greater_or_equal: 1 required: true value: description: Provide the sequence of bit values to be matched. type: string - required: true + required: true tosca.datatypes.nfv.NsOperationAdditionalParameters: derived_from: tosca.datatypes.Root description: Is an empty base type for deriving data types for describing NS-specific additional parameters to be passed when invoking NS lifecycle management operations #properties: - + tosca.datatypes.nfv.NsMonitoringParameter: derived_from: tosca.datatypes.Root description: Represents information on virtualised resource related performance metrics applicable to the NS. @@ -163,7 +163,7 @@ data_types: - greater_than: 0 segmentation_id: type: string - description: Specifies a specific virtualised network segment, which depends on the network type. For e.g., VLAN ID for VLAN network type and tunnel ID for GRE/VXLAN network types + description: Specifies a specific virtualised network segment, which depends on the network type. For e.g. VLAN ID for VLAN network type and tunnel ID for GRE/VXLAN network types required: false tosca.datatypes.nfv.NsL3ProtocolData: @@ -222,6 +222,8 @@ data_types: required: true key_schema: type: integer # Integer type in order to number the levels. First level is level 0. + constraints: + - greater_or_equal: 0 entry_schema: type: tosca.datatypes.nfv.NsLevels @@ -234,7 +236,7 @@ data_types: description: Human readable description of the Ns level required: true - tosca.datatypes.nfv.scaleNsByStepsData: + tosca.datatypes.nfv.ScaleNsByStepsData: derived_from: tosca.datatypes.Root description: describes the information needed to scale an NS instance by one or more scaling steps, with respect to a particular NS scaling aspect properties: @@ -256,7 +258,7 @@ data_types: - greater_than: 0 default: 1 - tosca.datatypes.nfv.scaleNsToLevelData: + tosca.datatypes.nfv.ScaleNsToLevelData: derived_from: tosca.datatypes.Root description: describes the information needed to scale an NS instance to a target size. properties: @@ -270,29 +272,35 @@ data_types: required: false entry_schema: type: integer + constraints: + - greater_or_equal: 0 + capability_types: + tosca.capabilities.nfv.Forwarding: derived_from: tosca.capabilities.Root relationship_types: + tosca.relationships.nfv.ForwardTo: derived_from: tosca.relationships.Root valid_target_types: [ tosca.capabilities.nfv.Forwarding ] interface_types: + tosca.interfaces.nfv.Nslcm: derived_from: tosca.interfaces.Root - description: This interface encompasses a set of TOSCA operations corresponding to NS LCM operations defined in ETSI GS NFV-IFA 013. as well as to preamble and postamble procedures to the execution of the NS LCM operations. + description: This interface encompasses a set of TOSCA operations corresponding to NS LCM operations defined in ETSI GS NFV-IFA 013 as well as to preamble and postamble procedures to the execution of the NS LCM operations. operations: instantiate_start: description: Preamble to execution of the instantiate operation instantiate: - description: Base procedure for instantiating an NS, corresponding to the Instantiate NS operation defined in ETSI GS NFV-IFA 013. - # inputs: - # additional_parameters: - # type: tosca.datatypes.nfv.NsOperationAdditionalParameters - # required: false + description: Base procedure for instantiating an NS, corresponding to the Instantiate NS operation defined in ETSI GS NFV-IFA 013. + inputs: + additional_parameters: + type: tosca.datatypes.nfv.NsOperationAdditionalParameters + required: false instantiate_end: description: Postamble to the execution of the instantiate operation terminate_start: @@ -310,38 +318,38 @@ interface_types: scale_start: description: Preamble to execution of the scale operation scale: - description: Base procedure for scaling an NS, corresponding to the Scale NS operation defined in ETSI GS NFV-IFA 013. - # inputs: - # additional_parameters: - # type: tosca.datatypes.nfv.NsOperationAdditionalParameters - # required: false + description: Base procedure for scaling an NS, corresponding to the Scale NS operation defined in ETSI GS NFV-IFA 013. inputs: + additional_parameters: + type: tosca.datatypes.nfv.NsOperationAdditionalParameters + required: false scale_ns_by_steps_data: - type: tosca.datatypes.nfv.scaleNsByStepsData + type: tosca.datatypes.nfv.ScaleNsByStepsData description: Describes the information needed to scale an NS instance by one or more scaling steps, with respect to a particular NS scaling aspect as defined in ETSI GS NFV-IFA 013. Either scale_ns_by_steps_data or scale_ns_to_level_data shall be provided. required: false scale_ns_to_level_data: - type: tosca.datatypes.nfv.scaleNsToLevelData + type: tosca.datatypes.nfv.ScaleNsToLevelData description: Describes the information needed to scale an NS instance to a target size as defined in ETSI GS NFV-IFA 013. Either scale_ns_by_steps_data or scale_ns_to_level_data shall be provided. - required: false + required: false scale_end: description: Postamble to the execution of the scale operation heal_start: description: Preamble to execution of the heal operation heal: - description: Base procedure for healing an NS, corresponding to the Heal NS operation defined in ETSI GS NFV-IFA 013. - # inputs: - # additional_parameters: - # type: tosca.datatypes.nfv.NsOperationAdditionalParameters - # required: false + description: Base procedure for healing an NS, corresponding to the Heal NS operation defined in ETSI GS NFV-IFA 013. + inputs: + additional_parameters: + type: tosca.datatypes.nfv.NsOperationAdditionalParameters + required: false heal_end: description: Postamble to the execution of the heal operation - + tosca.interfaces.nfv.NsVnfIndicator: derived_from: tosca.interfaces.Root description: This interface is an empty base interface type for deriving NS specific interface types that include VNF indicator specific notifications which will be used in a NS. node_types: + tosca.nodes.nfv.NS: derived_from: tosca.nodes.Root properties: @@ -391,6 +399,8 @@ node_types: description: Scale status of the NS, one entry per aspect. Represents for every scaling aspect how "big" the NS has been scaled w.r.t. that aspect. entry_schema: type: integer + constraints: + - greater_or_equal: 0 requirements: - virtual_link: capability: tosca.capabilities.nfv.VirtualLinkable @@ -404,6 +414,9 @@ node_types: tosca.nodes.nfv.Sap: derived_from: tosca.nodes.nfv.Cp description: node definition of SAP. + capabilities: + forwarding: + type: tosca.capabilities.nfv.Forwarding requirements: - external_virtual_link: capability: tosca.capabilities.nfv.VirtualLinkable @@ -449,9 +462,19 @@ node_types: type: tosca.capabilities.nfv.Forwarding requirements: - profile_element: + capability: tosca.capabilities.nfv.Forwarding + relationship: tosca.relationships.nfv.ForwardTo + occurrences: [ 1, 2 ] #When the number of occurrences is 1, the ingress and egress traffic is associated to a single VnfExtCp or Sap; When the number of occurrences is 2, the ingress VnfExtCp or Sap is associated to the first value and the egress VnfExtCp or Sap is associated to the second value. + + tosca.nodes.nfv.NFP: + derived_from: tosca.nodes.Root + description: node definition of NFP + requirements: + - nfp_position: capability: tosca.capabilities.nfv.Forwarding + node: tosca.nodes.nfv.NfpPosition relationship: tosca.relationships.nfv.ForwardTo - occurrences: [ 1, 2 ] # When the number of occurrences is 1, the ingress and egress traffic is associated to a single VnfExtCp or Sap; When the number of occurrences is 2, the ingress VnfExtCp or Sap is associated to the first value and the egress VnfExtCp or Sap is associated to the second value. + occurrences: [ 1, UNBOUNDED ] tosca.nodes.nfv.NfpPosition: derived_from: tosca.nodes.Root @@ -463,12 +486,12 @@ node_types: constraints: - valid_values: [ all, lb, ff ] required: false -# forwarding_behaviour_input_parameters: -# description: Provides input parameters to configure the forwarding behaviour. -# type: map -# required: false -# entry_schema: -# type: strin + forwarding_behaviour_input_parameters: + description: Provides input parameters to configure the forwarding behaviour. + type: map + required: false + entry_schema: + type: string capabilities: forwarding: type: tosca.capabilities.nfv.Forwarding @@ -479,16 +502,6 @@ node_types: relationship: tosca.relationships.nfv.ForwardTo occurrences: [ 1, UNBOUNDED ] - tosca.nodes.nfv.NFP: - derived_from: tosca.nodes.Root - description: node definition of NFP - requirements: - - nfp_position: - capability: tosca.capabilities.nfv.Forwarding - node: tosca.nodes.nfv.NfpPosition - relationship: tosca.relationships.nfv.ForwardTo - occurrences: [ 1, UNBOUNDED ] - tosca.nodes.nfv.Forwarding: derived_from: tosca.nodes.Root capabilities: @@ -503,6 +516,7 @@ node_types: relationship: tosca.relationships.nfv.VirtualLinksTo group_types: + tosca.groups.nfv.NsPlacementGroup: derived_from: tosca.groups.Root description: NsPlacementGroup is used for describing the affinity or anti-affinity relationship applicable between VNF instances created using different VNFDs, the Virtual Link instances created using different VLDs or the nested NS instances created using different NSDs when used in a NSD. @@ -515,7 +529,7 @@ group_types: tosca.groups.nfv.VNFFG: derived_from: tosca.groups.Root - description: the VNFFG group type describes a topology of the NS or a portion of the NS, and optionally forwarding rules, applicable to the traffic conveyed over this topology + description: the VNFFG group type describes a topology of the NS or a portion of the NS, and optionally forwarding rules, applicable to the traffic conveyed over this topology properties: description: type: string @@ -523,8 +537,8 @@ group_types: required: true members: [ tosca.nodes.nfv.NFP, tosca.nodes.nfv.VNF, tosca.nodes.nfv.PNF, tosca.nodes.nfv.NS, tosca.nodes.nfv.NsVirtualLink, tosca.nodes.nfv.NfpPositionElement ] - policy_types: + tosca.policies.nfv.NsAffinityRule: derived_from: tosca.policies.Placement description: The NsAffinityRule describes the affinity rules applicable for the defined targets @@ -573,17 +587,17 @@ policy_types: - valid_values: [ ipv4, ipv6 ] required: false vlan_tag: - description: Indicates a VLAN identifier in an IEEE 802.1Q-2014 tag [14]. Multiple tags can be included for QinQ stacking. + description: Indicates a VLAN identifier in an IEEE 802.1Q-2014 tag. Multiple tags can be included for QinQ stacking. type: list entry_schema: type: string required: false protocol: - description: 'Indicates the L4 protocol, For IPv4 [15] this corresponds to the field called "Protocol" to identify the next level protocol. For IPv6 [16] this corresponds to the field is called the "Next Header" field. Permitted values: Any keyword defined in the IANA [17] protocol registry.' + description: 'Indicates the L4 protocol, For IPv4 this corresponds to the field called "Protocol" to identify the next level protocol. For IPv6 this corresponds to the field is called the "Next Header" field. Permitted values: Any keyword defined in the IAN protocol registry.' type: string required: false dscp: - description: For IPv4 [15] a string of "0" and "1" digits that corresponds to the 6-bit Differentiated Services Code Point (DSCP) field of the IP header. For IPv6 [16] a string of "0" and "1" digits that corresponds to the 6 differentiated services bits of the traffic class header field. + description: For IPv4 a string of "0" and "1" digits that corresponds to the 6-bit Differentiated Services Code Point (DSCP) field of the IP header. For IPv6 a string of "0" and "1" digits that corresponds to the 6 differentiated services bits of the traffic class header field. type: string required: false source_port_range: @@ -591,13 +605,13 @@ policy_types: type: range required: false constraints: - - in_range: [0, 65535] + - in_range: [ 0, 65535 ] destination_port_range: description: Indicates a range of destination ports. type: range required: false constraints: - - in_range: [0, 65535] + - in_range: [ 0, 65535 ] source_ip_address_prefix: description: Indicates the source IP address range in CIDR format. type: string @@ -616,7 +630,7 @@ policy_types: tosca.policies.nfv.NsMonitoring: derived_from: tosca.policies.Root - description: Policy type is used to identify information to be monitored during the lifetime of a network service instance as defined in ETSI GS NFV-IFA 014 [2]. + description: Policy type is used to identify information to be monitored during the lifetime of a network service instance as defined in ETSI GS NFVIFA 014. properties: ns_monitoring_parameters: type: map #key: id @@ -630,7 +644,7 @@ policy_types: tosca.policies.nfv.VnfMonitoring: derived_from: tosca.policies.Root - description: Policy type is used to identify information to be monitored during the lifetime of a VNF instance as defined in ETSI GS NFV-IFA 014 [2]. + description: Policy type is used to identify information to be monitored during the lifetime of a VNF instance as defined in ETSI GS NFV-IFA 014. properties: vnf_monitoring_parameters: type: map #key: id @@ -644,7 +658,7 @@ policy_types: tosca.policies.nfv.NsScalingAspects: derived_from: tosca.policies.Root - description: The ScalingAspects type is a policy type representing the scaling aspects used for horizontal scaling as defined in ETSI GS NFV-IFA 014 [2] + description: The NsScalingAspects type is a policy type representing the scaling aspects used for horizontal scaling as defined in ETSI GS NFV-IFA 014 properties: aspects: type: map # key: aspectId @@ -657,7 +671,7 @@ policy_types: tosca.policies.nfv.VnfToLevelMapping: derived_from: tosca.policies.Root - description: The VnfToLevelMapping type is a policy type representing the number of VNF instances to be deployed at each NS level, as defined in ETSI GS NFV-IFA 014 [2] + description: The VnfToLevelMapping type is a policy type representing the number of VNF instances to be deployed at each NS level, as defined in ETSI GS NFV-IFA 014 properties: aspect: type: string @@ -669,15 +683,19 @@ policy_types: required: true key_schema: type: integer # First level is level 0. + constraints: + - greater_or_equal: 0 entry_schema: - type: integer + type: integer + constraints: + - greater_or_equal: 0 constraints: - min_length: 1 targets: [ tosca.nodes.nfv.VNF ] tosca.policies.nfv.NsToLevelMapping: derived_from: tosca.policies.Root - description: The NsToLevelMapping type is a policy type representing the number of NS instances of a nested NS to be deployed at each NS level of the composite NS, as defined in ETSI GS NFV-IFA 014 [2] + description: The NsToLevelMapping type is a policy type representing the number of NS instances of a nested NS to be deployed at each NS level of the composite NS, as defined in ETSI GS NFV-IFA 014 properties: aspect: type: string @@ -689,15 +707,19 @@ policy_types: required: true key_schema: type: integer # First level is level 0. + constraints: + - greater_or_equal: 0 entry_schema: type: integer + constraints: + - greater_or_equal: 0 constraints: - min_length: 1 targets: [ tosca.nodes.nfv.NS ] tosca.policies.nfv.VirtualLinkToLevelMapping: derived_from: tosca.policies.Root - description: The VirtualLinkToLevelMapping type is a policy type representing the number of NS instances of a nested NS to be deployed at each NS level of the composite NS, as defined in ETSI GS NFV-IFA 014 [2] + description: The VirtualLinkToLevelMapping type is a policy type representing the number of NS instances of a nested NS to be deployed at each NS level of the composite NS, as defined in ETSI GS NFV-IFA 014 properties: aspect: type: string @@ -709,6 +731,8 @@ policy_types: required: true key_schema: type: integer # First level is level 0. + constraints: + - greater_or_equal: 0 entry_schema: type: tosca.datatypes.nfv.LinkBitrateRequirements constraints: @@ -717,7 +741,7 @@ policy_types: tosca.policies.nfv.NsInstantiationLevels: derived_from: tosca.policies.Root - description: The NsInstantiationLevels type is a policy type representing all the instantiation levels of resources to be instantiated within a deployment flavour and including default instantiation level in term of the number of VNF and nested NS instances to be created as defined in ETSI GS NFV-IFA 014 [2]. + description: The NsInstantiationLevels type is a policy type representing all the instantiation levels of resources to be instantiated within a deployment flavour and including default instantiation level in term of the number of VNF and nested NS instances to be created as defined in ETSI GS NFV-IFA 014. properties: ns_levels: type: map # key: levelId @@ -734,7 +758,7 @@ policy_types: tosca.policies.nfv.VnfToInstantiationLevelMapping: derived_from: tosca.policies.Root - description: The VnfToInstantiationLevelMapping type is a policy type representing the number of VNF instances to be deployed at each NS instantiation level, as defined in ETSI GS NFV-IFA 014 [2] + description: The VnfToInstantiationLevelMapping type is a policy type representing the number of VNF instances to be deployed at each NS instantiation level, as defined in ETSI GS NFV-IFA 014 properties: number_of_instances: type: map # key: Ns instantiation level @@ -742,13 +766,15 @@ policy_types: required: true entry_schema: type: integer + constraints: + - greater_or_equal: 0 constraints: - min_length: 1 targets: [ tosca.nodes.nfv.VNF ] tosca.policies.nfv.NsToInstantiationLevelMapping: derived_from: tosca.policies.Root - description: The NsToInstantiationLevelMapping type is a policy type representing the number of NS instances of a nested NS to be deployed at each NS instantiation level of the composite NS, as defined in ETSI GS NFV-IFA 014 [2] + description: The NsToInstantiationLevelMapping type is a policy type representing the number of NS instances of a nested NS to be deployed at each NS instantiation level of the composite NS, as defined in ETSI GS NFV-IFA 014 properties: number_of_instances: type: map # key: Ns instantiation level @@ -756,13 +782,15 @@ policy_types: required: true entry_schema: type: integer + constraints: + - greater_or_equal: 0 constraints: - min_length: 1 targets: [ tosca.nodes.nfv.NS ] tosca.policies.nfv.VirtualLinkToInstantiationLevelMapping: derived_from: tosca.policies.Root - description: The VirtualLinkToInstantiationLevelMapping type is a policy type describing the bitrate requirements of a VL at each NS instantiation level of the composite NS, as defined in ETSI GS NFV-IFA 014 [2] + description: The VirtualLinkToInstantiationLevelMapping type is a policy type describing the bitrate requirements of a VL at each NS instantiation level of the composite NS, as defined in ETSI GS NFV-IFA 014 properties: bit_rate_requirements: type: map # key: Ns instantiation level @@ -776,6 +804,5 @@ policy_types: tosca.policies.nfv.NsAutoScale: derived_from: tosca.policies.Root - description: The NsAutoScale policy type is a base policy type for defining NS auto-scale specific policies as defined in ETSI GS NFV-IFA 014 [2]. + description: The NsAutoScale policy type is a base policy type for defining NS auto-scale specific policies as defined in ETSI GS NFV-IFA 014. targets: [ tosca.nodes.nfv.NS ] - diff --git a/etsi_nfv_sol001_pnfd_types.yaml b/etsi_nfv_sol001_pnfd_types.yaml index bba60fc7923898d06eecf31fc3d8815551def5ae..ffaa5d7f10afa24e7309e626a371fdde92d66d06 100644 --- a/etsi_nfv_sol001_pnfd_types.yaml +++ b/etsi_nfv_sol001_pnfd_types.yaml @@ -1,14 +1,15 @@ tosca_definitions_version: tosca_simple_yaml_1_3 -description: ETSI NFV SOL 001 pnfd types definitions version 3.6.1 +description: ETSI NFV SOL 001 pnfd types definitions version 3.7.1 metadata: template_name: etsi_nfv_sol001_pnfd_types template_author: ETSI_NFV - template_version: 3.6.1 + template_version: 3.7.1 imports: - - https://forge.etsi.org/rep/nfv/SOL001/raw/v3.6.1/etsi_nfv_sol001_common_types.yaml + - etsi_nfv_sol001_common_types.yaml data_types: + tosca.datatypes.nfv.LocationInfo: derived_from: tosca.datatypes.Root description: Represents geographical information on the location where a PNF is deployed. @@ -20,30 +21,30 @@ data_types: civic_address_element: type: list entry_schema: - type: tosca.datatypes.nfv.CivicAddressElement - description: Elements composing the civic address where the PNF is deployed. + type: tosca.datatypes.nfv.CivicAddressElement + description: Elements composing the civic address where the PNF is deployed. required: false geographic_coordinates: type: tosca.datatypes.nfv.GeographicCoordinates description: Geographic coordinates (e.g. Altitude, Longitude, Latitude) where the PNF is deployed. required: false - + tosca.datatypes.nfv.CivicAddressElement: derived_from: tosca.datatypes.Root - description: Represents an element of a civic location as specified in IETF RFC 4776 [11]. + description: Represents an element of a civic location as specified in IETF RFC 4776. properties: ca_type: - type: string # RFC4776 - description: caType as per RFC4776 - required: true + type: string # RFC4776 + description: caType as per RFC4776 + required: true ca_value: - type: string # RFC4776 - description: caValue as per RFC4776. - required: true + type: string # RFC4776 + description: caValue as per RFC4776. + required: true tosca.datatypes.nfv.GeographicCoordinates: derived_from: tosca.datatypes.Root - description: Represents an element of a geographic coordinate location as specified in IETF RFC?6225. + description: Represents an element of a geographic coordinate location as specified in IETF RFC 6225. properties: latitude_uncertainty: type: string # RFC 6225 @@ -75,43 +76,44 @@ data_types: required: true node_types: + tosca.nodes.nfv.PNF: derived_from: tosca.nodes.Root properties: descriptor_id: # instead of pnfd_id - type: string # UUID - required: true - description: Identifier of this PNFD information element. It uniquely identifies the PNFD. + type: string # UUID + required: true + description: Identifier of this PNFD information element. It uniquely identifies the PNFD. function_description: - type: string - required: true - description: Describes the PNF function. + type: string + required: true + description: Describes the PNF function. provider: - type: string - required: true - description: Identifies the provider of the PNFD. + type: string + required: true + description: Identifies the provider of the PNFD. version: - type: string - required: true - description: Identifies the version of the PNFD. + type: string + required: true + description: Identifies the version of the PNFD. descriptor_invariant_id: # instead of pnfd-invariant-id - type: string # UUID - required: true - description: Identifier of this PNFD in a version independent manner. This attribute is invariant across versions of PNFD. + type: string # UUID + required: true + description: Identifier of this PNFD in a version independent manner. This attribute is invariant across versions of PNFD. name: - type: string - required: true - description: Name to identify the PNFD. + type: string + required: true + description: Name to identify the PNFD. geographical_location_info: - type: tosca.datatypes.nfv.LocationInfo - required: false - description: Provides information about the geographical location (e.g. geographic coordinates or address of the building, etc.) of the PNF + type: tosca.datatypes.nfv.LocationInfo + required: false + description: Provides information about the geographical location (e.g. geographic coordinates or address of the building, etc.) of the PNF. requirements: - virtual_link: capability: tosca.capabilities.nfv.VirtualLinkable relationship: tosca.relationships.nfv.VirtualLinksTo occurrences: [ 0, 1 ] - # Additional requirements shall be defined in the PNF specific node type (deriving from tosca.nodes.nfv.PNF) corresponding to NS virtual links that need to connect to PnfExtCps + # Additional requirements shall be defined in the PNF specific node type (deriving from tosca.nodes.nfv.PNF) corresponding to NS virtual links that need to connect to PnfExtCps tosca.nodes.nfv.PnfExtCp: derived_from: tosca.nodes.nfv.Cp @@ -123,6 +125,7 @@ node_types: occurrences: [0, 1] policy_types: + tosca.policies.nfv.PnfSecurityGroupRule: derived_from: tosca.policies.nfv.Abstract.SecurityGroupRule description: The PnfSecurityGroupRule type is a policy type specified the matching criteria for the ingress and/or egress traffic to/from visited PNF external connection points. diff --git a/etsi_nfv_sol001_vnfd_types.yaml b/etsi_nfv_sol001_vnfd_types.yaml index 3fad5a97619b9004dddc607e6cc727f7c6de5c60..1640ef1ccd038231ead75bd3d8415b03f80f64e9 100644 --- a/etsi_nfv_sol001_vnfd_types.yaml +++ b/etsi_nfv_sol001_vnfd_types.yaml @@ -1,813 +1,754 @@ tosca_definitions_version: tosca_simple_yaml_1_3 -description: ETSI NFV SOL 001 vnfd types definitions version 3.6.1 +description: ETSI NFV SOL 001 vnfd types definitions version 3.7.1 metadata: template_name: etsi_nfv_sol001_vnfd_types template_author: ETSI_NFV - template_version: 3.6.1 + template_version: 3.7.1 imports: - - https://forge.etsi.org/rep/nfv/SOL001/raw/v3.6.1/etsi_nfv_sol001_common_types.yaml -# editor's note: During the development of the SOL001ed361 GS, to enable this file to be verified by a TOSCA parser, the imports statement has to be replaced with a reference to a local copy of the common definitions YAML file + - etsi_nfv_sol001_common_types.yaml + data_types: + tosca.datatypes.nfv.VirtualNetworkInterfaceRequirements: - derived_from: tosca.datatypes.Root - description: Describes requirements on a virtual network interface - properties: - name: - type: string - description: Provides a human readable name for the requirement. - required: false - description: - type: string - description: Provides a human readable description of the requirement. - required: false - network_interface_requirements: - type: map - description: The network interface requirements. A single-element map of strings where the string contains a set of key-value pairs that describes hardware platform specific network interface deployment requirements. - required: true - entry_schema: - type: string - constraints: - - max_length: 1 - nic_io_requirements: - type: tosca.datatypes.nfv.LogicalNodeData - description: references (couples) the CP with any logical node I/O requirements (for network devices) that may have been created. Linking these attributes is necessary so that so that I/O requirements that need to be articulated at the logical node level can be associated with the network interface requirements associated with the CP. - required: false + derived_from: tosca.datatypes.Root + description: Describes requirements on a virtual network interface + properties: + name: + type: string + description: Provides a human readable name for the requirement. + required: false + description: + type: string + description: Provides a human readable description of the requirement. + required: false + network_interface_requirements: + type: map + description: The network interface requirements. A single-element map of strings where the string contains a set of key-value pairs that describes hardware platform specific network interface deployment requirements. + required: true + entry_schema: + type: string + constraints: + - max_length: 1 + nic_io_requirements: + type: tosca.datatypes.nfv.LogicalNodeData + description: references (couples) the CP with any logical node I/O requirements (for network devices) that may have been created. Linking these attributes is necessary so that so that I/O requirements that need to be articulated at the logical node level can be associated with the network interface requirements associated with the CP. + required: false tosca.datatypes.nfv.RequestedAdditionalCapability: - derived_from: tosca.datatypes.Root - description: describes requested additional capability for a particular VDU - properties: - requested_additional_capability_name: - type: string - description: Identifies a requested additional capability for the VDU. - required: true - support_mandatory: - type: boolean - description: Indicates whether the requested additional capability is mandatory for successful operation. - required: true - min_requested_additional_capability_version: - type: string - description: Identifies the minimum version of the requested additional capability. - required: false - preferred_requested_additional_capability_version: - type: string - description: Identifies the preferred version of the requested additional capability. - required: false - target_performance_parameters: - type: map - description: Identifies specific attributes, dependent on the requested additional capability type. - required: true - entry_schema: - type: string - + derived_from: tosca.datatypes.Root + description: describes requested additional capability for a particular VDU + properties: + requested_additional_capability_name: + type: string + description: Identifies a requested additional capability for the VDU. + required: true + support_mandatory: + type: boolean + description: Indicates whether the requested additional capability is mandatory for successful operation. + required: true + min_requested_additional_capability_version: + type: string + description: Identifies the minimum version of the requested additional capability. + required: false + preferred_requested_additional_capability_version: + type: string + description: Identifies the preferred version of the requested additional capability. + required: false + target_performance_parameters: + type: map + description: Identifies specific attributes, dependent on the requested additional capability type. + required: true + entry_schema: + type: string tosca.datatypes.nfv.VirtualMemory: - derived_from: tosca.datatypes.Root - description: supports the specification of requirements related to virtual memory of a virtual compute resource - properties: - virtual_mem_size: - type: scalar-unit.size - description: Amount of virtual memory. - required: true - virtual_mem_oversubscription_policy: - type: string - description: The memory core oversubscription policy in terms of virtual memory to physical memory on the platform. - required: false - vdu_mem_requirements: - type: map - description: The hardware platform specific VDU memory requirements. A map of strings where each string contains a set of key-value pairs that describes hardware platform specific VDU memory requirements. - required: false - entry_schema: - type: string - numa_enabled: - type: boolean - description: It specifies the memory allocation to be cognisant of the relevant process/core allocation. - required: true - default: false + derived_from: tosca.datatypes.Root + description: supports the specification of requirements related to virtual memory of a virtual compute resource + properties: + virtual_mem_size: + type: scalar-unit.size + description: Amount of virtual memory. + required: true + virtual_mem_oversubscription_policy: + type: string + description: The memory core oversubscription policy in terms of virtual memory to physical memory on the platform. + required: false + vdu_mem_requirements: + type: map + description: The hardware platform specific VDU memory requirements. A map of strings where each string contains a set of key-value pairs that describes hardware platform specific VDU memory requirements. + required: false + entry_schema: + type: string + numa_enabled: + type: boolean + description: It specifies the memory allocation to be cognisant of the relevant process/core allocation. + required: true + default: false tosca.datatypes.nfv.VirtualCpu: - derived_from: tosca.datatypes.Root - description: Supports the specification of requirements related to virtual CPU(s) of a virtual compute resource - properties: - cpu_architecture: - type: string - description: CPU architecture type. Examples are x86, ARM - required: false - num_virtual_cpu: - type: integer - description: Number of virtual CPUs - required: true - constraints: - - greater_than: 0 - virtual_cpu_clock: - type: scalar-unit.frequency - description: Minimum virtual CPU clock rate - required: false - virtual_cpu_oversubscription_policy: - type: string - description: CPU core oversubscription policy e.g. the relation of virtual CPU cores to physical CPU cores/threads. - required: false - vdu_cpu_requirements: - type: map - description: The hardware platform specific VDU CPU requirements. A map of strings where each string contains a set of key-value pairs describing VDU CPU specific hardware platform requirements. - required: false - entry_schema: - type: string - virtual_cpu_pinning: - type: tosca.datatypes.nfv.VirtualCpuPinning - description: The virtual CPU pinning configuration for the virtualised compute resource. - required: false + derived_from: tosca.datatypes.Root + description: Supports the specification of requirements related to virtual CPU(s) of a virtual compute resource + properties: + cpu_architecture: + type: string + description: CPU architecture type. Examples are x86, ARM + required: false + num_virtual_cpu: + type: integer + description: Number of virtual CPUs + required: true + constraints: + - greater_than: 0 + virtual_cpu_clock: + type: scalar-unit.frequency + description: Minimum virtual CPU clock rate + required: false + virtual_cpu_oversubscription_policy: + type: string + description: CPU core oversubscription policy e.g. the relation of virtual CPU cores to physical CPU cores/threads. + required: false + vdu_cpu_requirements: + type: map + description: The hardware platform specific VDU CPU requirements. A map of strings where each string contains a set of key-value pairs describing VDU CPU specific hardware platform requirements. + required: false + entry_schema: + type: string + virtual_cpu_pinning: + type: tosca.datatypes.nfv.VirtualCpuPinning + description: The virtual CPU pinning configuration for the virtualised compute resource. + required: false tosca.datatypes.nfv.VirtualCpuPinning: - derived_from: tosca.datatypes.Root - description: Supports the specification of requirements related to the virtual CPU pinning configuration of a virtual compute resource - properties: - virtual_cpu_pinning_policy: - type: string - description: Indicates the policy for CPU pinning. The policy can take values of "static" or "dynamic". In case of "dynamic" the allocation of virtual CPU cores to logical CPU cores is decided by the VIM. (e.g. SMT (Simultaneous Multi-Threading) requirements). In case of "static" the allocation is requested to be according to the virtual_cpu_pinning_rule. - required: false - constraints: - - valid_values: [ static, dynamic ] - virtual_cpu_pinning_rule: - type: list - description: Provides the list of rules for allocating virtual CPU cores to logical CPU cores/threads - required: false - entry_schema: - type: string - + derived_from: tosca.datatypes.Root + description: Supports the specification of requirements related to the virtual CPU pinning configuration of a virtual compute resource + properties: + virtual_cpu_pinning_policy: + type: string + description: Indicates the policy for CPU pinning. The policy can take values of "static" or "dynamic". In case of "dynamic" the allocation of virtual CPU cores to logical CPU cores is decided by the VIM. (e.g. SMT (Simultaneous Multi-Threading) requirements). In case of "static" the allocation is requested to be according to the virtual_cpu_pinning_rule. + required: false + constraints: + - valid_values: [ static, dynamic ] + virtual_cpu_pinning_rule: + type: list + description: Provides the list of rules for allocating virtual CPU cores to logical CPU cores/threads + required: false + entry_schema: + type: string tosca.datatypes.nfv.VnfcConfigurableProperties: - derived_from: tosca.datatypes.Root - description: Defines the configurable properties of a VNFC - #properties: - # additional_vnfc_configurable_properties: - # type: tosca.datatypes.nfv.VnfcAdditionalConfigurableProperties - # description: Describes additional configuration for VNFC that can be modified using the ModifyVnfInfo operation - # required: false - # derived types are expected to introduce - # additional_vnfc_configurable_properties with its type derived from - # tosca.datatypes.nfv.VnfcAdditionalConfigurableProperties + derived_from: tosca.datatypes.Root + description: Defines the configurable properties of a VNFC + properties: + additional_vnfc_configurable_properties: + type: tosca.datatypes.nfv.VnfcAdditionalConfigurableProperties + description: Describes additional configuration for VNFC that can be modified using the ModifyVnfInfo operation + required: false + # derived types are expected to introduce + # additional_vnfc_configurable_properties with its type derived from + # tosca.datatypes.nfv.VnfcAdditionalConfigurableProperties tosca.datatypes.nfv.VnfcAdditionalConfigurableProperties: - derived_from: tosca.datatypes.Root - description: VnfcAdditionalConfigurableProperties type is an empty base type for deriving data types for describing additional configurable properties for a given VNFC. + derived_from: tosca.datatypes.Root + description: VnfcAdditionalConfigurableProperties type is an empty base type for deriving data types for describing additional configurable properties for a given VNFC. tosca.datatypes.nfv.VduProfile: - derived_from: tosca.datatypes.Root - description: describes additional instantiation data for a given Vdu.Compute used in a specific deployment flavour. - properties: - min_number_of_instances: - type: integer - description: Minimum number of instances of the VNFC based on this Vdu.Compute that is permitted to exist for a particular VNF deployment flavour. - required: true - constraints: - - greater_or_equal: 0 - max_number_of_instances: - type: integer - description: Maximum number of instances of the VNFC based on this Vdu.Compute that is permitted to exist for a particular VNF deployment flavour. - required: true - constraints: - - greater_or_equal: 0 - nfvi_maintenance_info: - type: tosca.datatypes.nfv.NfviMaintenanceInfo - description: Provides information on the impact tolerance and rules to be observed when instance(s) of the Vdu.Compute are impacted during NFVI operation and maintenance (e.g. NFVI resource upgrades). - required: false + derived_from: tosca.datatypes.Root + description: describes additional instantiation data for a given Vdu.Compute used in a specific deployment flavour. + properties: + min_number_of_instances: + type: integer + description: Minimum number of instances of the VNFC based on this Vdu.Compute that is permitted to exist for a particular VNF deployment flavour. + required: true + constraints: + - greater_or_equal: 0 + max_number_of_instances: + type: integer + description: Maximum number of instances of the VNFC based on this Vdu.Compute that is permitted to exist for a particular VNF deployment flavour. + required: true + constraints: + - greater_or_equal: 0 + nfvi_maintenance_info: + type: tosca.datatypes.nfv.NfviMaintenanceInfo + description: Provides information on the impact tolerance and rules to be observed when instance(s) of the Vdu.Compute are impacted during NFVI operation and maintenance (e.g. NFVI resource upgrades). + required: false tosca.datatypes.nfv.VlProfile: - derived_from: tosca.datatypes.Root - description: Describes additional instantiation data for a given VL used in a specific VNF deployment flavour. - properties: - max_bitrate_requirements: - type: tosca.datatypes.nfv.LinkBitrateRequirements - description: Specifies the maximum bitrate requirements for a VL instantiated according to this profile. - required: true - min_bitrate_requirements: - type: tosca.datatypes.nfv.LinkBitrateRequirements - description: Specifies the minimum bitrate requirements for a VL instantiated according to this profile. - required: true - qos: - type: tosca.datatypes.nfv.Qos - description: Specifies the QoS requirements of a VL instantiated according to this profile. - required: false - virtual_link_protocol_data: - type: list - description: Specifies the protocol data for a virtual link. - required: false - entry_schema: - type: tosca.datatypes.nfv.VirtualLinkProtocolData + derived_from: tosca.datatypes.Root + description: Describes additional instantiation data for a given VL used in a specific VNF deployment flavour. + properties: + max_bitrate_requirements: + type: tosca.datatypes.nfv.LinkBitrateRequirements + description: Specifies the maximum bitrate requirements for a VL instantiated according to this profile. + required: true + min_bitrate_requirements: + type: tosca.datatypes.nfv.LinkBitrateRequirements + description: Specifies the minimum bitrate requirements for a VL instantiated according to this profile. + required: true + qos: + type: tosca.datatypes.nfv.Qos + description: Specifies the QoS requirements of a VL instantiated according to this profile. + required: false + virtual_link_protocol_data: + type: list + description: Specifies the protocol data for a virtual link. + required: false + entry_schema: + type: tosca.datatypes.nfv.VirtualLinkProtocolData tosca.datatypes.nfv.VirtualLinkProtocolData: - derived_from: tosca.datatypes.Root - description: describes one protocol layer and associated protocol data for a given virtual link used in a specific VNF deployment flavour - properties: - associated_layer_protocol: + derived_from: tosca.datatypes.Root + description: describes one protocol layer and associated protocol data for a given virtual link used in a specific VNF deployment flavour + properties: + associated_layer_protocol: + type: string + description: Identifies one of the protocols a virtualLink gives access to (ethernet, mpls, odu2, ipv4, ipv6, pseudo-wire) as specified by the connectivity_type property. + required: true + constraints: + - valid_values: [ ethernet, mpls, odu2, ipv4, ipv6, pseudo-wire ] + l2_protocol_data: + type: tosca.datatypes.nfv.L2ProtocolData + description: Specifies the L2 protocol data for a virtual link. Shall be present when the associatedLayerProtocol attribute indicates a L2 protocol and shall be absent otherwise. + required: false + l3_protocol_data: + type: tosca.datatypes.nfv.L3ProtocolData + description: Specifies the L3 protocol data for this virtual link. Shall be present when the associatedLayerProtocol attribute indicates a L3 protocol and shall be absent otherwise. + required: false + + tosca.datatypes.nfv.L2ProtocolData: + derived_from: tosca.datatypes.Root + description: describes L2 protocol data for a given virtual link used in a specific VNF deployment flavour. + properties: + name: type: string - description: Identifies one of the protocols a virtualLink gives access to (ethernet, mpls, odu2, ipv4, ipv6, pseudo-wire) as specified by the connectivity_type property. - required: true + description: Identifies the network name associated with this L2 protocol. + required: false + network_type: + type: string + description: Specifies the network type for this L2 protocol. The value may be overridden at run-time. + required: false constraints: - - valid_values: [ ethernet, mpls, odu2, ipv4, ipv6, pseudo-wire ] - l2_protocol_data: - type: tosca.datatypes.nfv.L2ProtocolData - description: Specifies the L2 protocol data for a virtual link. Shall be present when the associatedLayerProtocol attribute indicates a L2 protocol and shall be absent otherwise. + - valid_values: [ flat, vlan, vxlan, gre ] + vlan_transparent: + type: boolean + description: Specifies whether to support VLAN transparency for this L2 protocol or not. + required: true + default: false + mtu: + type: integer + description: Specifies the maximum transmission unit (MTU) value for this L2 protocol. required: false - l3_protocol_data: - type: tosca.datatypes.nfv.L3ProtocolData - description: Specifies the L3 protocol data for this virtual link. Shall be present when the associatedLayerProtocol attribute indicates a L3 protocol and shall be absent otherwise. + constraints: + - greater_than: 0 + segmentation_id: + type: string + description: Specifies a specific virtualised network segment, which depends on the network type. For e.g. VLAN ID for VLAN network type and tunnel ID for GRE/VXLAN network types required: false - tosca.datatypes.nfv.L2ProtocolData: - derived_from: tosca.datatypes.Root - description: describes L2 protocol data for a given virtual link used in a specific VNF deployment flavour. - properties: - name: - type: string - description: Identifies the network name associated with this L2 protocol. - required: false - network_type: - type: string - description: Specifies the network type for this L2 protocol. The value may be overridden at run-time. - required: false - constraints: - - valid_values: [ flat, vlan, vxlan, gre ] - vlan_transparent: - type: boolean - description: Specifies whether to support VLAN transparency for this L2 protocol or not. - required: true - default: false - mtu: - type: integer - description: Specifies the maximum transmission unit (MTU) value for this L2 protocol. - required: false - constraints: - - greater_than: 0 - segmentation_id: - type: string - description: Specifies a specific virtualised network segment, which depends on the network type. For e.g., VLAN ID for VLAN network type and tunnel ID for GRE/VXLAN network types - required: false - - tosca.datatypes.nfv.L3ProtocolData: - derived_from: tosca.datatypes.Root - description: describes L3 protocol data for a given virtual link used in a specific VNF deployment flavour. - properties: - name: - type: string - description: Identifies the network name associated with this L3 protocol. - required: false - ip_version: - type: string - description: Specifies IP version of this L3 protocol. The value of the ip_version property shall be consistent with the value of the layer_protocol in the connectivity_type property of the virtual link node. - required: true - constraints: - - valid_values: [ ipv4, ipv6 ] - cidr: - type: string - description: Specifies the CIDR (Classless Inter-Domain Routing) of this L3 protocol. The value may be overridden at run-time. - required: true - ip_allocation_pools: - type: list - description: Specifies the allocation pools with start and end IP addresses for this L3 protocol. The value may be overridden at run-time. - required: false - entry_schema: - type: tosca.datatypes.nfv.IpAllocationPool - gateway_ip: - type: string - description: Specifies the gateway IP address for this L3 protocol. The value may be overridden at run-time. - required: false - dhcp_enabled: - type: boolean - description: Indicates whether DHCP (Dynamic Host Configuration Protocol) is enabled or disabled for this L3 protocol. The value may be overridden at run-time. - required: false - ipv6_address_mode: - type: string - description: Specifies IPv6 address mode. May be present when the value of the ipVersion attribute is "ipv6" and shall be absent otherwise. The value may be overridden at run-time. - required: false - constraints: - - valid_values: [ slaac, dhcpv6-stateful, dhcpv6-stateless ] + derived_from: tosca.datatypes.Root + description: describes L3 protocol data for a given virtual link used in a specific VNF deployment flavour. + properties: + name: + type: string + description: Identifies the network name associated with this L3 protocol. + required: false + ip_version: + type: string + description: Specifies IP version of this L3 protocol. The value of the ip_version property shall be consistent with the value of the layer_protocol in the connectivity_type property of the virtual link node. + required: true + constraints: + - valid_values: [ ipv4, ipv6 ] + cidr: + type: string + description: Specifies the CIDR (Classless Inter-Domain Routing) of this L3 protocol. The value may be overridden at run-time. + required: true + ip_allocation_pools: + type: list + description: Specifies the allocation pools with start and end IP addresses for this L3 protocol. The value may be overridden at run-time. + required: false + entry_schema: + type: tosca.datatypes.nfv.IpAllocationPool + gateway_ip: + type: string + description: Specifies the gateway IP address for this L3 protocol. The value may be overridden at run-time. + required: false + dhcp_enabled: + type: boolean + description: Indicates whether DHCP (Dynamic Host Configuration Protocol) is enabled or disabled for this L3 protocol. The value may be overridden at run-time. + required: false + ipv6_address_mode: + type: string + description: Specifies IPv6 address mode. May be present when the value of the ipVersion attribute is "ipv6" and shall be absent otherwise. The value may be overridden at run-time. + required: false + constraints: + - valid_values: [ slaac, dhcpv6-stateful, dhcpv6-stateless ] tosca.datatypes.nfv.IpAllocationPool: - derived_from: tosca.datatypes.Root - description: Specifies a range of IP addresses - properties: - start_ip_address: - type: string - description: The IP address to be used as the first one in a pool of addresses derived from the cidr block full IP range - required: true - end_ip_address: - type: string - description: The IP address to be used as the last one in a pool of addresses derived from the cidr block full IP range - required: true + derived_from: tosca.datatypes.Root + description: Specifies a range of IP addresses + properties: + start_ip_address: + type: string + description: The IP address to be used as the first one in a pool of addresses derived from the cidr block full IP range + required: true + end_ip_address: + type: string + description: The IP address to be used as the last one in a pool of addresses derived from the cidr block full IP range + required: true tosca.datatypes.nfv.InstantiationLevel: - derived_from: tosca.datatypes.Root - description: Describes the scale level for each aspect that corresponds to a given level of resources to be instantiated within a deployment flavour in term of the number VNFC instances - properties: - description: - type: string - description: Human readable description of the level - required: true - scale_info: - type: map # key: aspectId - description: Represents for each aspect the scale level that corresponds to this instantiation level. scale_info shall be present if the VNF supports scaling. - required: false - entry_schema: - type: tosca.datatypes.nfv.ScaleInfo + derived_from: tosca.datatypes.Root + description: Describes the scale level for each aspect that corresponds to a given level of resources to be instantiated within a deployment flavour in term of the number VNFC instances + properties: + description: + type: string + description: Human readable description of the level + required: true + scale_info: + type: map # key: aspectId + description: Represents for each aspect the scale level that corresponds to this instantiation level. scale_info shall be present if the VNF supports scaling. + required: false + entry_schema: + type: tosca.datatypes.nfv.ScaleInfo tosca.datatypes.nfv.VduLevel: - derived_from: tosca.datatypes.Root - description: Indicates for a given Vdu.Compute in a given level the number of instances to deploy - properties: - number_of_instances: - type: integer - description: Number of instances of VNFC based on this VDU to deploy for this level. - required: true - constraints: - - greater_or_equal: 0 + derived_from: tosca.datatypes.Root + description: Indicates for a given Vdu.Compute in a given level the number of instances to deploy + properties: + number_of_instances: + type: integer + description: Number of instances of VNFC based on this VDU to deploy for this level. + required: true + constraints: + - greater_or_equal: 0 tosca.datatypes.nfv.VnfLcmOperationsConfiguration: - derived_from: tosca.datatypes.Root - description: Represents information to configure lifecycle management operations - properties: - instantiate: - type: tosca.datatypes.nfv.VnfInstantiateOperationConfiguration - description: Configuration parameters for the InstantiateVnf operation - required: false - scale: - type: tosca.datatypes.nfv.VnfScaleOperationConfiguration - description: Configuration parameters for the ScaleVnf operation - required: false - scale_to_level: - type: tosca.datatypes.nfv.VnfScaleToLevelOperationConfiguration - description: Configuration parameters for the ScaleVnfToLevel operation - required: false - change_flavour: - type: tosca.datatypes.nfv.VnfChangeFlavourOperationConfiguration - description: Configuration parameters for the changeVnfFlavourOpConfig operation - required: false - heal: - type: tosca.datatypes.nfv.VnfHealOperationConfiguration - description: Configuration parameters for the HealVnf operation - required: false - terminate: - type: tosca.datatypes.nfv.VnfTerminateOperationConfiguration - description: Configuration parameters for the TerminateVnf operation - required: false - operate: - type: tosca.datatypes.nfv.VnfOperateOperationConfiguration - description: Configuration parameters for the OperateVnf operation - required: false - change_ext_connectivity: - type: tosca.datatypes.nfv.VnfChangeExtConnectivityOperationConfiguration - description: Configuration parameters for the changeExtVnfConnectivityOpConfig operation - required: false - change_current_package: - type: tosca.datatypes.nfv.VnfChangeCurrentPackageOperationConfiguration - description: Configuration parameters for the ChangeCurrentVnfPackage operation - required: false - # derived types are expected to introduce new properties, with their type derived from - # tosca.datatypes.nfv.VnfChangeCurrentPackageOperationConfiguration, - # with the same name as the operation designated to the ChangeCurrentVnfPackage request - create_snapshot: - type: tosca.datatypes.nfv.VnfCreateSnapshotOperationConfiguration - description: Configuration parameters for the CreateVnfSnapshot operation - required: false - revert_to_snapshot: - type: tosca.datatypes.nfv.VnfRevertToSnapshotOperationConfiguration - description: Configuration parameters for the RevertToVnfSnapshot operation - required: false + derived_from: tosca.datatypes.Root + description: Represents information to configure lifecycle management operations + properties: + instantiate: + type: tosca.datatypes.nfv.VnfInstantiateOperationConfiguration + description: Configuration parameters for the InstantiateVnf operation + required: false + scale: + type: tosca.datatypes.nfv.VnfScaleOperationConfiguration + description: Configuration parameters for the ScaleVnf operation + required: false + scale_to_level: + type: tosca.datatypes.nfv.VnfScaleToLevelOperationConfiguration + description: Configuration parameters for the ScaleVnfToLevel operation + required: false + change_flavour: + type: tosca.datatypes.nfv.VnfChangeFlavourOperationConfiguration + description: Configuration parameters for the changeVnfFlavourOpConfig operation + required: false + heal: + type: tosca.datatypes.nfv.VnfHealOperationConfiguration + description: Configuration parameters for the HealVnf operation + required: false + terminate: + type: tosca.datatypes.nfv.VnfTerminateOperationConfiguration + description: Configuration parameters for the TerminateVnf operation + required: false + operate: + type: tosca.datatypes.nfv.VnfOperateOperationConfiguration + description: Configuration parameters for the OperateVnf operation + required: false + change_ext_connectivity: + type: tosca.datatypes.nfv.VnfChangeExtConnectivityOperationConfiguration + description: Configuration parameters for the changeExtVnfConnectivityOpConfig operation + required: false + change_current_package: + type: tosca.datatypes.nfv.VnfChangeCurrentPackageOperationConfiguration + description: Configuration parameters for the ChangeCurrentVnfPackage operation + required: false + # derived types are expected to introduce new properties, with their type derived from + # tosca.datatypes.nfv.VnfChangeCurrentPackageOperationConfiguration, + # with the same name as the operation designated to the ChangeCurrentVnfPackage request + create_snapshot: + type: tosca.datatypes.nfv.VnfCreateSnapshotOperationConfiguration + description: Configuration parameters for the CreateVnfSnapshot operation + required: false + revert_to_snapshot: + type: tosca.datatypes.nfv.VnfRevertToSnapshotOperationConfiguration + description: Configuration parameters for the RevertToVnfSnapshot operation + required: false tosca.datatypes.nfv.VnfInstantiateOperationConfiguration: - derived_from: tosca.datatypes.Root - description: represents information that affect the invocation of the InstantiateVnf operation. - # This data type definition is reserved for future use in the present document. - # properties: + derived_from: tosca.datatypes.Root + description: represents information that affect the invocation of the InstantiateVnf operation. + # This data type definition is reserved for future use in the present document. + # properties: tosca.datatypes.nfv.VnfScaleOperationConfiguration: - derived_from: tosca.datatypes.Root - description: Represents information that affect the invocation of the ScaleVnf operation - properties: - scaling_by_more_than_one_step_supported: - type: boolean - description: Signals whether passing a value larger than one in the numScalingSteps parameter of the ScaleVnf operation is supported by this VNF. - required: true - default: false + derived_from: tosca.datatypes.Root + description: Represents information that affect the invocation of the ScaleVnf operation + properties: + scaling_by_more_than_one_step_supported: + type: boolean + description: Signals whether passing a value larger than one in the numScalingSteps parameter of the ScaleVnf operation is supported by this VNF. + required: true + default: false tosca.datatypes.nfv.VnfScaleToLevelOperationConfiguration: - derived_from: tosca.datatypes.Root - description: represents information that affect the invocation of the ScaleVnfToLevel operation - properties: - arbitrary_target_levels_supported: - type: boolean - description: Signals whether scaling according to the parameter "scaleInfo" is supported by this VNF - required: true + derived_from: tosca.datatypes.Root + description: represents information that affect the invocation of the ScaleVnfToLevel operation + properties: + arbitrary_target_levels_supported: + type: boolean + description: Signals whether scaling according to the parameter "scaleInfo" is supported by this VNF + required: true tosca.datatypes.nfv.VnfHealOperationConfiguration: - derived_from: tosca.datatypes.Root - description: represents information that affect the invocation of the HealVnf operation - properties: - causes: - type: list - description: Supported "cause" parameter values - required: false - entry_schema: - type: string + derived_from: tosca.datatypes.Root + description: represents information that affect the invocation of the HealVnf operation + properties: + causes: + type: list + description: Supported "cause" parameter values + required: false + entry_schema: + type: string tosca.datatypes.nfv.VnfTerminateOperationConfiguration: - derived_from: tosca.datatypes.Root - description: represents information that affect the invocation of the TerminateVnf - properties: - min_graceful_termination_timeout: - type: scalar-unit.time - description: Minimum timeout value for graceful termination of a VNF instance - required: true - max_recommended_graceful_termination_timeout: - type: scalar-unit.time - description: Maximum recommended timeout value that can be needed to gracefully terminate a VNF instance of a particular type under certain conditions, such as maximum load condition. This is provided by VNF provider as information for the operator facilitating the selection of optimal timeout value. This value is not used as constraint - required: false + derived_from: tosca.datatypes.Root + description: represents information that affect the invocation of the TerminateVnf + properties: + min_graceful_termination_timeout: + type: scalar-unit.time + description: Minimum timeout value for graceful termination of a VNF instance + required: true + max_recommended_graceful_termination_timeout: + type: scalar-unit.time + description: Maximum recommended timeout value that can be needed to gracefully terminate a VNF instance of a particular type under certain conditions, such as maximum load condition. This is provided by VNF provider as information for the operator facilitating the selection of optimal timeout value. This value is not used as constraint + required: false tosca.datatypes.nfv.VnfOperateOperationConfiguration: - derived_from: tosca.datatypes.Root - description: represents information that affect the invocation of the OperateVnf operation - properties: - min_graceful_stop_timeout: - type: scalar-unit.time - description: Minimum timeout value for graceful stop of a VNF instance - required: true - max_recommended_graceful_stop_timeout: - type: scalar-unit.time - description: Maximum recommended timeout value that can be needed to gracefully stop a VNF instance of a particular type under certain conditions, such as maximum load condition. This is provided by VNF provider as information for the operator facilitating the selection of optimal timeout value. This value is not used as constraint - required: false + derived_from: tosca.datatypes.Root + description: represents information that affect the invocation of the OperateVnf operation + properties: + min_graceful_stop_timeout: + type: scalar-unit.time + description: Minimum timeout value for graceful stop of a VNF instance + required: true + max_recommended_graceful_stop_timeout: + type: scalar-unit.time + description: Maximum recommended timeout value that can be needed to gracefully stop a VNF instance of a particular type under certain conditions, such as maximum load condition. This is provided by VNF provider as information for the operator facilitating the selection of optimal timeout value. This value is not used as constraint + required: false tosca.datatypes.nfv.ScaleInfo: - derived_from: tosca.datatypes.Root - description: Indicates for a given scaleAspect the corresponding scaleLevel - properties: - scale_level: - type: integer - description: The scale level for a particular aspect - required: true - constraints: - - greater_or_equal: 0 + derived_from: tosca.datatypes.Root + description: Indicates for a given scaleAspect the corresponding scaleLevel + properties: + scale_level: + type: integer + description: The scale level for a particular aspect + required: true + constraints: + - greater_or_equal: 0 tosca.datatypes.nfv.ScalingAspect: - derived_from: tosca.datatypes.Root - description: describes the details of an aspect used for horizontal scaling - properties: - name: - type: string - description: Human readable name of the aspect - required: true - description: - type: string - description: Human readable description of the aspect - required: true - max_scale_level: - type: integer # positiveInteger - description: Total number of scaling steps that can be applied w.r.t. this aspect. The value of this property corresponds to the number of scaling steps can be applied to this aspect when scaling it from the minimum scale level (i.e. 0) to the maximum scale level defined by this property - required: true - constraints: - - greater_or_equal: 0 - step_deltas: - type: list - description: List of scaling deltas to be applied for the different subsequent scaling steps of this aspect. The first entry in the array shall correspond to the first scaling step (between scale levels 0 to 1) and the last entry in the array shall correspond to the last scaling step (between maxScaleLevel-1 and maxScaleLevel) - required: false - entry_schema: - type: string # Identifier + derived_from: tosca.datatypes.Root + description: describes the details of an aspect used for horizontal scaling + properties: + name: + type: string + description: Human readable name of the aspect + required: true + description: + type: string + description: Human readable description of the aspect + required: true + max_scale_level: + type: integer # positiveInteger + description: Total number of scaling steps that can be applied w.r.t. this aspect. The value of this property corresponds to the number of scaling steps can be applied to this aspect when scaling it from the minimum scale level (i.e. 0) to the maximum scale level defined by this property + required: true + constraints: + - greater_or_equal: 0 + step_deltas: + type: list + description: List of scaling deltas to be applied for the different subsequent scaling steps of this aspect. The first entry in the array shall correspond to the first scaling step (between scale levels 0 to 1) and the last entry in the array shall correspond to the last scaling step (between maxScaleLevel-1 and maxScaleLevel) + required: false + entry_schema: + type: string # Identifier tosca.datatypes.nfv.VnfConfigurableProperties: - derived_from: tosca.datatypes.Root - description: indicates configuration properties for a given VNF (e.g. related to auto scaling and auto healing). - properties: - is_autoscale_enabled: - type: boolean - description: It permits to enable (TRUE)/disable (FALSE) the auto-scaling functionality. If the property is not present, then configuring this VNF property is not supported - required: false - is_autoheal_enabled: - type: boolean - description: It permits to enable (TRUE)/disable (FALSE) the auto-healing functionality. If the property is not present, then configuring this VNF property is not supported - required: false - vnfm_interface_info: - type: list - description: Contains information enabling access to the NFV-MANO interfaces produced by the VNFM (e.g. URIs and credentials), If the property is not present, then configuring this VNF property is not supported. - required: false - entry_schema: - type: tosca.datatypes.nfv.VnfmInterfaceInfo - vnfm_oauth_server_info: - type: tosca.datatypes.nfv.OauthServerInfo - description: Contains information to enable discovery of the authorization server protecting access to VNFM interfaces. If the property is not present, then configuring this VNF property is not supported. - required: false - vnf_oauth_server_info: - type: tosca.datatypes.nfv.OauthServerInfo - description: Contains information to enable discovery of the authorization server to validate the access tokens provided by the VNFM when the VNFM accesses the VNF interfaces, if that functionality (token introspection) is supported by the authorization server. If the property is not present, then configuring this VNF property is not supported. - required: false - # additional_configurable_properties: - # description: It provides VNF specific configurable properties that can be - # modified using the ModifyVnfInfo operation - # required: false - # type: tosca.datatypes.nfv.VnfAdditionalConfigurableProperties - # derived types are expected to introduce - # additional_configurable_properties with its type derived from - # tosca.datatypes.nfv.VnfAdditionalConfigurableProperties + derived_from: tosca.datatypes.Root + description: indicates configuration properties for a given VNF (e.g. related to auto scaling and auto healing). + properties: + is_autoscale_enabled: + type: boolean + description: It permits to enable (TRUE)/disable (FALSE) the auto-scaling functionality. If the property is not present, then configuring this VNF property is not supported. + required: false + is_autoheal_enabled: + type: boolean + description: It permits to enable (TRUE)/disable (FALSE) the auto-healing functionality. If the property is not present, then configuring this VNF property is not supported. + required: false + vnfm_interface_info: + type: list + description: Contains information enabling access to the NFV-MANO interfaces produced by the VNFM (e.g. URIs and credentials). If the property is not present, then configuring this VNF property is not supported. + required: false + entry_schema: + type: tosca.datatypes.nfv.VnfmInterfaceInfo + vnfm_oauth_server_info: + type: tosca.datatypes.nfv.OauthServerInfo + description: Contains information to enable discovery of the authorization server protecting access to VNFM interfaces. If the property is not present, then configuring this VNF property is not supported. + required: false + vnf_oauth_server_info: + type: tosca.datatypes.nfv.OauthServerInfo + description: Contains information to enable discovery of the authorization server to validate the access tokens provided by the VNFM when the VNFM accesses the VNF interfaces, if that functionality (token introspection) is supported by the authorization server. If the property is not present, then configuring this VNF property is not supported. + required: false + additional_configurable_properties: + description: It provides VNF specific configurable properties that can be modified using the ModifyVnfInfo operation + required: false + type: tosca.datatypes.nfv.VnfAdditionalConfigurableProperties + # derived types are expected to introduce + # additional_configurable_properties with its type derived from + # tosca.datatypes.nfv.VnfAdditionalConfigurableProperties tosca.datatypes.nfv.VnfAdditionalConfigurableProperties: - derived_from: tosca.datatypes.Root - description: is an empty base type for deriving data types for describing additional configurable properties for a given VNF - properties: - is_writable_anytime: - type: boolean - description: It specifies whether these additional configurable properties are writeable (TRUE) at any time (i.e. prior to / at instantiation time as well as after instantiation).or (FALSE) only prior to / at instantiation time. If this property is not present, the additional configurable properties are writable anytime. - required: true - default : true - + derived_from: tosca.datatypes.Root + description: is an empty base type for deriving data types for describing additional configurable properties for a given VNF + properties: + is_writable_anytime: + type: boolean + description: It specifies whether these additional configurable properties are writeable (TRUE) at any time (i.e. prior to / at instantiation time as well as after instantiation).or (FALSE) only prior to / at instantiation time. If this property is not present, the additional configurable properties are writable anytime. + required: true + default: true + tosca.datatypes.nfv.VnfInfoModifiableAttributes: - derived_from: tosca.datatypes.Root - description: Describes VNF-specific extension and metadata for a given VNF - #properties: - #extensions: - #type: tosca.datatypes.nfv.VnfInfoModifiableAttributesExtensions - #description: "Extension" properties of VnfInfo that are writeable - #required: false - # derived types are expected to introduce - # extensions with its type derived from - # tosca.datatypes.nfv.VnfInfoModifiableAttributesExtensions - #metadata: - #type: tosca.datatypes.nfv.VnfInfoModifiableAttributesMetadata - #description: "Metadata" properties of VnfInfo that are writeable - #required: false - # derived types are expected to introduce - # metadata with its type derived from - # tosca.datatypes.nfv.VnfInfoModifiableAttributesMetadata + derived_from: tosca.datatypes.Root + description: Describes VNF-specific extension and metadata for a given VNF + properties: + extensions: + type: tosca.datatypes.nfv.VnfInfoModifiableAttributesExtensions + description: Extension properties of VnfInfo that are writeable + required: false + # derived types are expected to introduce + # extensions with its type derived from + # tosca.datatypes.nfv.VnfInfoModifiableAttributesExtensions + metadata: + type: tosca.datatypes.nfv.VnfInfoModifiableAttributesMetadata + description: Metadata properties of VnfInfo that are writeable + required: false + # derived types are expected to introduce + # metadata with its type derived from + # tosca.datatypes.nfv.VnfInfoModifiableAttributesMetadata tosca.datatypes.nfv.VnfInfoModifiableAttributesExtensions: - derived_from: tosca.datatypes.Root - description: is an empty base type for deriving data types for describing VNF-specific extension + derived_from: tosca.datatypes.Root + description: is an empty base type for deriving data types for describing VNF-specific extension tosca.datatypes.nfv.VnfInfoModifiableAttributesMetadata: - derived_from: tosca.datatypes.Root - description: is an empty base type for deriving data types for describing VNF-specific metadata + derived_from: tosca.datatypes.Root + description: is an empty base type for deriving data types for describing VNF-specific metadata tosca.datatypes.nfv.LogicalNodeData: - derived_from: tosca.datatypes.Root - description: Describes compute, memory and I/O requirements associated with a particular VDU. - properties: - logical_node_requirements: - type: map - description: The logical node-level compute, memory and I/O requirements. A map of strings where each string contains a set of key-value pairs that describes hardware platform specific deployment requirements, including the number of CPU cores on this logical node, a memory configuration specific to a logical node or a requirement related to the association of an I/O device with the logical node. - required: false - entry_schema: - type: string - - tosca.datatypes.nfv.SwImageData: - derived_from: tosca.datatypes.Root - description: describes information related to a software image artifact - properties: - name: - type: string - description: Name of this software image - required: true - version: - type: string - description: Version of this software image - required: true - provider: - type: string - description: Provider of this software image - required: false - checksum: - type: tosca.datatypes.nfv.ChecksumData - description: Checksum of the software image file - required: true - container_format: - type: string - description: The container format describes the container file format in which software image is provided - required: true - constraints: - - valid_values: [ aki, ami, ari, bare, docker, ova, ovf ] - disk_format: - type: string - description: The disk format of a software image is the format of the underlying disk image - required: true - constraints: - - valid_values: [ aki, ami, ari, iso, qcow2, raw, vdi, vhd, vhdx, vmdk ] - min_disk: - type: scalar-unit.size # Number - description: The minimal disk size requirement for this software image - required: true - constraints: - - greater_or_equal: 0 B - min_ram: - type: scalar-unit.size # Number - description: The minimal RAM requirement for this software image - required: false - constraints: - - greater_or_equal: 0 B - size: - type: scalar-unit.size # Number - description: The size of this software image - required: true - operating_system: - type: string - description: Identifies the operating system used in the software image - required: false - supported_virtualisation_environments: - type: list - description: Identifies the virtualisation environments (e.g. hypervisor) compatible with this software image - required: false - entry_schema: - type: string + derived_from: tosca.datatypes.Root + description: Describes compute, memory and I/O requirements associated with a particular VDU. + properties: + logical_node_requirements: + type: map + description: The logical node-level compute, memory and I/O requirements. A map of strings where each string contains a set of key-value pairs that describes hardware platform specific deployment requirements, including the number of CPU cores on this logical node, a memory configuration specific to a logical node or a requirement related to the association of an I/O device with the logical node. + required: false + entry_schema: + type: string tosca.datatypes.nfv.VirtualBlockStorageData: - derived_from: tosca.datatypes.Root - description: VirtualBlockStorageData describes block storage requirements associated with compute resources in a particular VDU, either as a local disk or as virtual attached storage - properties: - size_of_storage: - type: scalar-unit.size - description: Size of virtualised storage resource - required: true - constraints: - - greater_or_equal: 0 B - vdu_storage_requirements: - type: map - description: The hardware platform specific storage requirements. A map of strings where each string contains a set of key-value pairs that represents the hardware platform specific storage deployment requirements - required: false - entry_schema: - type: string - rdma_enabled: - type: boolean - description: Indicates if the storage support RDMA - required: true - default: false + derived_from: tosca.datatypes.Root + description: VirtualBlockStorageData describes block storage requirements associated with compute resources in a particular VDU, either as a local disk or as virtual attached storage + properties: + size_of_storage: + type: scalar-unit.size + description: Size of virtualised storage resource + required: true + constraints: + - greater_or_equal: 0 B + vdu_storage_requirements: + type: map + description: The hardware platform specific storage requirements. A map of strings where each string contains a set of key-value pairs that represents the hardware platform specific storage deployment requirements + required: false + entry_schema: + type: string + rdma_enabled: + type: boolean + description: Indicates if the storage support RDMA + required: true + default: false tosca.datatypes.nfv.VirtualObjectStorageData: - derived_from: tosca.datatypes.Root - description: VirtualObjectStorageData describes object storage requirements associated with compute resources in a particular VDU - properties: - max_size_of_storage: - type: scalar-unit.size - description: Maximum size of virtualized storage resource - required: false - constraints: - - greater_or_equal: 0 B + derived_from: tosca.datatypes.Root + description: VirtualObjectStorageData describes object storage requirements associated with compute resources in a particular VDU + properties: + max_size_of_storage: + type: scalar-unit.size + description: Maximum size of virtualised storage resource + required: false + constraints: + - greater_or_equal: 0 B tosca.datatypes.nfv.VirtualFileStorageData: - derived_from: tosca.datatypes.Root - description: VirtualFileStorageData describes file storage requirements associated with compute resources in a particular VDU - properties: - size_of_storage: - type: scalar-unit.size - description: Size of virtualized storage resource - required: true - constraints: - - greater_or_equal: 0 B - file_system_protocol: - type: string - description: The shared file system protocol (e.g. NFS, CIFS) - required: true + derived_from: tosca.datatypes.Root + description: VirtualFileStorageData describes file storage requirements associated with compute resources in a particular VDU + properties: + size_of_storage: + type: scalar-unit.size + description: Size of virtualised storage resource + required: true + constraints: + - greater_or_equal: 0 B + file_system_protocol: + type: string + description: The shared file system protocol (e.g. NFS, CIFS) + required: true + constraints: + - valid_values: [ nfs, cifs ] tosca.datatypes.nfv.VirtualLinkBitrateLevel: derived_from: tosca.datatypes.Root - description: Describes bitrate requirements applicable to the virtual link instantiated from a particicular VnfVirtualLink + description: Describes bitrate requirements applicable to the virtual link instantiated from a particular VnfVirtualLink properties: bitrate_requirements: - type: tosca.datatypes.nfv.LinkBitrateRequirements - description: Virtual link bitrate requirements for an instantiation level or bitrate delta for a scaling step - required: true + type: tosca.datatypes.nfv.LinkBitrateRequirements + description: Virtual link bitrate requirements for an instantiation level or bitrate delta for a scaling step + required: true tosca.datatypes.nfv.VnfOperationAdditionalParameters: derived_from: tosca.datatypes.Root description: Is an empty base type for deriving data type for describing VNF-specific parameters to be passed when invoking lifecycle management operations - # properties: + #properties: tosca.datatypes.nfv.VnfChangeFlavourOperationConfiguration: derived_from: tosca.datatypes.Root description: represents information that affect the invocation of the ChangeVnfFlavour operation - # This data type definition is reserved for future use in the present document. - # properties: + # This data type definition is reserved for future use in the present document. + # properties: tosca.datatypes.nfv.VnfChangeExtConnectivityOperationConfiguration: derived_from: tosca.datatypes.Root description: represents information that affect the invocation of the ChangeExtVnfConnectivity operation - # This data type definition is reserved for future use in the present document. - # properties: - + # This data type definition is reserved for future use in the present document. + # properties: + tosca.datatypes.nfv.VnfcMonitoringParameter: derived_from: tosca.datatypes.Root description: Represents information on virtualised resource related performance metrics applicable to the VNF. properties: name: - type: string - description: Human readable name of the monitoring parameter - required: true + type: string + description: Human readable name of the monitoring parameter + required: true performance_metric: - type: string - description: Identifies a performance metric to be monitored, according to ETSI GS NFV-IFA 027. - required: true - constraints: - - valid_values: [ v_cpu_usage_mean_vnf, v_cpu_usage_peak_vnf, v_memory_usage_mean_vnf, v_memory_usage_peak_vnf, v_disk_usage_mean_vnf, v_disk_usage_peak_vnf, byte_incoming_vnf_int_cp, byte_outgoing_vnf_int_cp, packet_incoming_vnf_int_cp, packet_outgoing_vnf_int_cp, v_cpu_usage_mean, v_cpu_usage_peak,v_memory_usage_mean,v_memory_usage_peak, v_disk_usage_mean, v_disk_usage_peak, v_net_byte_incoming, v_net_byte_outgoing, v_net_packet_incoming, v_net_packet_outgoing, usage_mean_vStorage, usage_peak_vStorage ] + type: string + description: Identifies a performance metric to be monitored, according to ETSI GS NFV-IFA 027. + required: true + constraints: + - valid_values: [ v_cpu_usage_mean_vnf, v_cpu_usage_peak_vnf, v_memory_usage_mean_vnf, v_memory_usage_peak_vnf, v_disk_usage_mean_vnf, v_disk_usage_peak_vnf, byte_incoming_vnf_int_cp, byte_outgoing_vnf_int_cp, +packet_incoming_vnf_int_cp, packet_outgoing_vnf_int_cp, v_cpu_usage_mean, v_cpu_usage_peak,v_memory_usage_mean,v_memory_usage_peak, v_disk_usage_mean, v_disk_usage_peak, v_net_byte_incoming, v_net_byte_outgoing, v_net_packet_incoming, v_net_packet_outgoing, usage_mean_vStorage, usage_peak_vStorage ] collection_period: - type: scalar-unit.time - description: Describes the periodicity at which to collect the performance information. - required: false - constraints: - - greater_than: 0 s + type: scalar-unit.time + description: Describes the periodicity at which to collect the performance information. + required: false + constraints: + - greater_than: 0 s tosca.datatypes.nfv.VirtualLinkMonitoringParameter: derived_from: tosca.datatypes.Root description: Represents information on virtualised resource related performance metrics applicable to the VNF. properties: name: - type: string - description: Human readable name of the monitoring parameter - required: true + type: string + description: Human readable name of the monitoring parameter + required: true performance_metric: - type: string - description: Identifies a performance metric to be monitored. - required: true - constraints: - - valid_values: [ byte_incoming, byte_outgoing, packet_incoming, packet_outgoing ] + type: string + description: Identifies a performance metric to be monitored. + required: true + constraints: + - valid_values: [ byte_incoming, byte_outgoing, packet_incoming, packet_outgoing ] collection_period: - type: scalar-unit.time - description: Describes the periodicity at which to collect the performance information. - required: false - constraints: - - greater_than: 0 s + type: scalar-unit.time + description: Describes the periodicity at which to collect the performance information. + required: false + constraints: + - greater_than: 0 s tosca.datatypes.nfv.InterfaceDetails: derived_from: tosca.datatypes.Root description: information used to access an interface exposed by a VNF properties: uri_components: - type: tosca.datatypes.nfv.UriComponents - description: Provides components to build a Uniform Ressource Identifier (URI) where to access the interface end point. - required: false + type: tosca.datatypes.nfv.UriComponents + description: Provides components to build a Uniform Resource Identifier (URI) where to access the interface end point. + required: false interface_specific_data: - type: map - description: Provides additional details that are specific to the type of interface considered. - required: false - entry_schema: - type: string + type: map + description: Provides additional details that are specific to the type of interface considered. + required: false + entry_schema: + type: string tosca.datatypes.nfv.UriComponents: derived_from: tosca.datatypes.Root - description: information used to build a URI that complies with IETF RFC 3986 [8]. + description: information used to build a URI that complies with IETF RFC 3986. properties: scheme: - type: string # shall comply with IETF RFC 3986 - description: scheme component of a URI. - required: true + type: string # shall comply with IETF RFC 3986 + description: scheme component of a URI. + required: true authority: - type: tosca.datatypes.nfv.UriAuthority - description: Authority component of a URI - required: false + type: tosca.datatypes.nfv.UriAuthority + description: Authority component of a URI + required: false path: - type: string # shall comply with IETF RFC 3986 - description: path component of a URI. - required: false + type: string # shall comply with IETF RFC 3986 + description: path component of a URI. + required: false query: - type: string # shall comply with IETF RFC 3986 - description: query component of a URI. - required: false + type: string # shall comply with IETF RFC 3986 + description: query component of a URI. + required: false fragment: - type: string # shall comply with IETF RFC 3986 - description: fragment component of a URI. - required: false + type: string # shall comply with IETF RFC 3986 + description: fragment component of a URI. + required: false tosca.datatypes.nfv.UriAuthority: derived_from: tosca.datatypes.Root - description: information that corresponds to the authority component of a URI as specified in IETF RFC 3986 [8] - properties: - user_info: - type: string # shall comply with IETF RFC 3986 - description: user_info field of the authority component of a URI - required: false - host: - type: string # shall comply with IETF RFC 3986 - description: host field of the authority component of a URI - required: false - port: - type: string # shall comply with IETF RFC 3986 - description: port field of the authority component of a URI - required: false + description: information that corresponds to the authority component of a URI as specified in IETF RFC 3986 + properties: + user_info: + type: string # shall comply with IETF RFC 3986 + description: user_info field of the authority component of a URI + required: false + host: + type: string # shall comply with IETF RFC 3986 + description: host field of the authority component of a URI + required: false + port: + type: string # shall comply with IETF RFC 3986 + description: port field of the authority component of a URI + required: false tosca.datatypes.nfv.ChecksumData: - derived_from: tosca.datatypes.Root - description: Describes information about the result of performing a checksum operation over some arbitrary data - properties: - algorithm: - type: string - description: Describes the algorithm used to obtain the checksum value - required: true - constraints: - - valid_values: [sha-224, sha-256, sha-384, sha-512 ] - hash: - type: string - description: Contains the result of applying the algorithm indicated by the algorithm property to the data to which this ChecksumData refers - required: true + derived_from: tosca.datatypes.Root + description: Describes information about the result of performing a checksum operation over some arbitrary data + properties: + algorithm: + type: string + description: Describes the algorithm used to obtain the checksum value + required: true + constraints: + - valid_values: [sha-224, sha-256, sha-384, sha-512 ] + hash: + type: string + description: Contains the result of applying the algorithm indicated by the algorithm property to the data to which this ChecksumData refers + required: true tosca.datatypes.nfv.VnfmInterfaceInfo: derived_from: tosca.datatypes.Root - description: describes information enabling the VNF instance to access the NFV-MANO interfaces produced by the VNFM + description: Describes information enabling the VNF instance to access the NFV-MANO interfaces produced by the VNFM properties: interface_name: type: string @@ -822,15 +763,16 @@ data_types: credentials: type: map description: Provides credential enabling access to the interface - required: false + required: false entry_schema: type: string tosca.datatypes.nfv.OauthServerInfo: derived_from: tosca.datatypes.Root description: information to enable discovery of the authorization server - #properties: FFS + #properties: #This data type definition is reserved for future use in the present document + tosca.datatypes.nfv.BootData: derived_from: tosca.datatypes.Root @@ -876,11 +818,11 @@ data_types: required: false source_path: type: string - description: The URL to a file contained in the VNF package used to customize a virtualised compute resource. The content shall comply with IETF RFC 3986 [8]. + description: The URL to a file contained in the VNF package used to customize a virtualised compute resource. The content shall comply with IETF RFC 3986. required: false destination_path: type: string - description: The URL address when inject a file into the virtualised compute resource. The content shall comply with IETF RFC 3986 [8]. + description: The URL address when inject a file into the virtualised compute resource. The content shall comply with IETF RFC 3986. required: false tosca.datatypes.nfv.BootDataVimSpecificProperties: @@ -943,7 +885,7 @@ data_types: description: represents information that affect the invocation of the change current VNF Package operation. # This data type definition is reserved for future use in the present document. # properties: - # derived types are expected to introduce new properties, with their type derived from tosca.datatypes.nfv.VnfChangeCurrentPackageOperationConfiguration, with the same name as the operation designated to the ChangeCurrentVnfPackage request + # derived types are expected to introduce new properties, with their type derived from tosca.datatypes.nfv.VnfChangeCurrentPackageOperationConfiguration, with the same name as the operation designated to the ChangeCurrentVnfPackage request tosca.datatypes.nfv.VnfCreateSnapshotOperationConfiguration: derived_from: tosca.datatypes.Root @@ -967,7 +909,7 @@ data_types: required: false endpoint_type: type: string - description: Specifies the type of the endpoint exposing the LCM operation coordination such as other operations supporting or management systems (e.g. an EM) or the VNF instance. If the VNF produces the LCM coordination interface, this property may be omitted or may have the value "vnf". If this attribute is omitted, the type of endpoint that provides the interface is determined at deployment time. If the VNF does not produce the LCM coordination interface but coordination via this interface is needed, it is expected that a management entity such as the EM exposes the coordination interface, and consequently, this attribute shall be present and shall have the value “mgmtâ€? + description: Specifies the type of the endpoint exposing the LCM operation coordination such as other operations supporting or management systems (e.g. an EM) or the VNF instance. If the VNF produces the LCM coordination interface, this property may be omitted or may have the value "vnf". If this attribute is omitted, the type of endpoint that provides the interface is determined at deployment time. If the VNF does not produce the LCM coordination interface but coordination via this interface is needed, it is expected that a management entity such as the EM exposes the coordination interface, and consequently, this attribute shall be present and shall have the value "mgmt". required: false constraints: - valid_values: [ mgmt, vnf ] @@ -977,19 +919,23 @@ data_types: required: false constraints: - valid_values: [ start, end ] - # input_parameters: - # type: tosca.datatypes.nfv.InputOpCoordParams - # description: Input parameters to be provided in the LCM coordination request. - # required: false - # output_parameters: - # type: tosca.datatypes.nfv.OutputOpCoordParams - # description: Output parameters provided in the LCM coordination response. - # required: false + input_parameters: + type: tosca.datatypes.nfv.InputOpCoordParams + description: Input parameters to be provided in the LCM coordination request. + required: false + output_parameters: + type: tosca.datatypes.nfv.OutputOpCoordParams + description: Output parameters provided in the LCM coordination response. + required: false + + tosca.datatypes.nfv.InputOpCoordParams: + derived_from: tosca.datatypes.Root + description: is an empty base type for deriving data types for describing additional input operation coordination parameters for a given coordination action tosca.datatypes.nfv.OutputOpCoordParams: derived_from: tosca.datatypes.Root description: is an empty base type for deriving data types for describing additional Output operation coordination parameters for a given coordination action - + tosca.datatypes.nfv.MaxNumberOfImpactedInstances: derived_from: tosca.datatypes.Root description: Specifies the maximum number of instances of a given Vdu.Compute node or VnfVirtualLink node that may be impacted simultaneously without impacting the functionality of the group of a given size. @@ -998,10 +944,14 @@ data_types: type: integer description: Determines the size of the group for which the max_number_of_impacted_instances is specified. If not present the size is not limited. required: false + constraints: + - greater_than: 0 max_number_of_impacted_instances: type: integer description: The maximum number of instances that can be impacted simultaneously within the group of the specified size. required: true + constraints: + - greater_than: 0 tosca.datatypes.nfv.NfviMaintenanceInfo: derived_from: tosca.datatypes.Root @@ -1041,7 +991,7 @@ data_types: min_number_of_preserved_instances: type: list description: Specifies for different group sizes the minimum number of instances which need to be preserved simultaneously within the group of virtualised resources. - required:false + required: false entry_schema: type: tosca.datatypes.nfv.MinNumberOfPreservedInstances @@ -1053,12 +1003,28 @@ data_types: type: integer description: Determines the size of the group for which the min_number_of_preserved_instances is specified. If not present the size is not limited. required: false + constraints: + - greater_than: 0 min_number_of_preserved_instances: type: integer description: The minimum number of instances which need to be preserved simultaneously within the group of the specified size. - required: true - -artifact_types: + required: true + constraints: + - greater_than: 0 + + tosca.datatypes.nfv.VipCpLevel: + derived_from: tosca.datatypes.Root + description: Indicates for a given VipCp in a given level the number of instances to deploy + properties: + number_of_instances: + type: integer + description: Number of instances of VipCp based on the referenced VipCp node template to deploy for an instantiation level or for a scaling delta. + required: true + constraints: + - greater_or_equal: 0 + +artifact_types: + tosca.artifacts.nfv.SwImage: derived_from: tosca.artifacts.Deployment.Image description: describes the software image which is directly loaded on the virtualisation container realizing of the VDU or is to be loaded on a virtual storage resource @@ -1124,48 +1090,48 @@ artifact_types: mime_type: application/x-yaml file_ext: [ yaml ] +capability_types: -capability_types: tosca.capabilities.nfv.VirtualBindable: derived_from: tosca.capabilities.Node description: Indicates that the node that includes it can be pointed by a tosca.relationships.nfv.VirtualBindsTo relationship type which is used to model the VduHasCpd association - tosca.capabilities.nfv.VirtualCompute: + tosca.capabilities.nfv.VirtualCompute: derived_from: tosca.capabilities.Node description: Describes the capabilities related to virtual compute resources properties: logical_node: - type: map - description: Describes the Logical Node requirements - required: false - entry_schema: - type: tosca.datatypes.nfv.LogicalNodeData + type: map + description: Describes the Logical Node requirements + required: false + entry_schema: + type: tosca.datatypes.nfv.LogicalNodeData requested_additional_capabilities: - type: map - description: Describes additional capability for a particular VDU - required: false - entry_schema: - type: tosca.datatypes.nfv.RequestedAdditionalCapability + type: map + description: Describes additional capability for a particular VDU + required: false + entry_schema: + type: tosca.datatypes.nfv.RequestedAdditionalCapability compute_requirements: - type: map - required: false - entry_schema: - type: string + type: map + required: false + entry_schema: + type: string virtual_memory: - type: tosca.datatypes.nfv.VirtualMemory - description: Describes virtual memory of the virtualized compute - required: true + type: tosca.datatypes.nfv.VirtualMemory + description: Describes virtual memory of the virtualised compute + required: true virtual_cpu: - type: tosca.datatypes.nfv.VirtualCpu - description: Describes virtual CPU(s) of the virtualized compute - required: true + type: tosca.datatypes.nfv.VirtualCpu + description: Describes virtual CPU(s) of the virtualised compute + required: true virtual_local_storage: - type: list - description: A list of virtual system disks created and destroyed as part of the VM lifecycle - required: false - entry_schema: - type: tosca.datatypes.nfv.VirtualBlockStorageData - description: virtual system disk definition + type: list + description: A list of virtual system disks created and destroyed as part of the VM lifecycle + required: false + entry_schema: + type: tosca.datatypes.nfv.VirtualBlockStorageData + description: virtual system disk definition tosca.capabilities.nfv.VirtualStorage: derived_from: tosca.capabilities.Root @@ -1174,8 +1140,9 @@ capability_types: tosca.capabilities.nfv.TrunkBindable: derived_from: tosca.capabilities.Node description: Indicates that the node that includes it can be pointed by a tosca.relationships.nfv.TrunkBindsTo relationship type which is used to model the trunkPortTopology. - + relationship_types: + tosca.relationships.nfv.VirtualBindsTo: derived_from: tosca.relationships.DependsOn description: Represents an association relationship between Vdu.Compute and VduCp node types @@ -1189,33 +1156,34 @@ relationship_types: tosca.relationships.nfv.TrunkBindsTo: derived_from: tosca.relationships.DependsOn description: Represents the association relationship between a VduCp node used as a trunk port and other VduSubCp nodes used as subports of the same trunk. - valid_target_types: [ tosca.capabilities.nfv.TrunkBindable ] + valid_target_types: [ tosca.capabilities.nfv.TrunkBindable ] interface_types: + tosca.interfaces.nfv.Vnflcm: derived_from: tosca.interfaces.Root description: This interface encompasses a set of TOSCA operations corresponding to the VNF LCM operations defined in ETSI GS NFV-IFA 007 as well as to preamble and postamble procedures to the execution of the VNF LCM operations. operations: instantiate: description: Invoked upon receipt of an Instantiate VNF request - # inputs: - # additional_parameters: - # type: tosca.datatypes.nfv.VnfOperationAdditionalParameters - # required: false - # derived types are expected to introduce additional_parameters with its - # type derived from tosca.datatypes.nfv.VnfOperationAdditionalParameters + inputs: + additional_parameters: + type: tosca.datatypes.nfv.VnfOperationAdditionalParameters + required: false + # derived types are expected to introduce additional_parameters with its + # type derived from tosca.datatypes.nfv.VnfOperationAdditionalParameters instantiate_start: description: Invoked before instantiate instantiate_end: description: Invoked after instantiate terminate: description: Invoked upon receipt Terminate VNF request - # inputs: - # additional_parameters: - # type: tosca.datatypes.nfv.VnfOperationAdditionalParameters - # required: false - # derived types are expected to introduce additional_parameters with its - # type derived from tosca.datatypes.nfv.VnfOperationAdditionalParameters + inputs: + additional_parameters: + type: tosca.datatypes.nfv.VnfOperationAdditionalParameters + required: false + # derived types are expected to introduce additional_parameters with its + # type derived from tosca.datatypes.nfv.VnfOperationAdditionalParameters terminate_start: description: Invoked before terminate terminate_end: @@ -1228,49 +1196,48 @@ interface_types: description: Invoked after modify_information change_flavour: description: Invoked upon receipt of a Change VNF Flavour request - # inputs: - # additional_parameters: - # type: tosca.datatypes.nfv.VnfOperationAdditionalParameters - # required: false - # derived types are expected to introduce additional_parameters with its - # type derived from tosca.datatypes.nfv.VnfOperationAdditionalParameters + inputs: + additional_parameters: + type: tosca.datatypes.nfv.VnfOperationAdditionalParameters + required: false + # derived types are expected to introduce additional_parameters with its + # type derived from tosca.datatypes.nfv.VnfOperationAdditionalParameters change_flavour_start: description: Invoked before change_flavour change_flavour_end: description: Invoked after change_flavour change_external_connectivity: description: Invoked upon receipt of a Change External VNF Connectivity request - # inputs: - # additional_parameters: - # type: tosca.datatypes.nfv.VnfOperationAdditionalParameters - # required: false - # derived types are expected to introduce additional_parameters with its - # type derived from tosca.datatypes.nfv.VnfOperationAdditionalParameters + inputs: + additional_parameters: + type: tosca.datatypes.nfv.VnfOperationAdditionalParameters + required: false + # derived types are expected to introduce additional_parameters with its + # type derived from tosca.datatypes.nfv.VnfOperationAdditionalParameters change_external_connectivity_start: description: Invoked before change_external_connectivity change_external_connectivity_end: description: Invoked after change_external_connectivity operate: description: Invoked upon receipt of an Operate VNF request - # inputs: - # additional_parameters: - # type: tosca.datatypes.nfv.VnfOperationAdditionalParameters - # required: false - # derived types are expected to introduce additional_parameters with its - # type derived from tosca.datatypes.nfv.VnfOperationAdditionalParameters + inputs: + additional_parameters: + type: tosca.datatypes.nfv.VnfOperationAdditionalParameters + required: false + # derived types are expected to introduce additional_parameters with its + # type derived from tosca.datatypes.nfv.VnfOperationAdditionalParameters operate_start: description: Invoked before operate operate_end: description: Invoked after operate heal: description: Invoked upon receipt of a Heal VNF request - # inputs: - # additional_parameters: - # type: tosca.datatypes.nfv.VnfOperationAdditionalParameters - # required: false - # derived types are expected to introduce additional_parameters with its - # type derived from tosca.datatypes.nfv.VnfOperationAdditionalParameters inputs: + additional_parameters: + type: tosca.datatypes.nfv.VnfOperationAdditionalParameters + required: false + # derived types are expected to introduce additional_parameters with its + # type derived from tosca.datatypes.nfv.VnfOperationAdditionalParameters cause: type: string description: Indicates the reason why a healing procedure is required. @@ -1287,13 +1254,12 @@ interface_types: description: Invoked after heal scale: description: Invoked upon receipt of a Scale VNF request - # inputs: - # additional_parameters: - # type: tosca.datatypes.nfv.VnfOperationAdditionalParameters - # required: false - # derived types are expected to introduce additional_parameters with its - # type derived from tosca.datatypes.nfv.VnfOperationAdditionalParameters inputs: + additional_parameters: + type: tosca.datatypes.nfv.VnfOperationAdditionalParameters + required: false + # derived types are expected to introduce additional_parameters with its + # type derived from tosca.datatypes.nfv.VnfOperationAdditionalParameters type: type: string description: Indicates the type of the scale operation requested. @@ -1317,13 +1283,12 @@ interface_types: description: Invoked after scale scale_to_level: description: Invoked upon receipt of a Scale VNF to Level request - # inputs: - # additional_parameters: - # type: tosca.datatypes.nfv.VnfOperationAdditionalParameters - # required: false - # derived types are expected to introduce additional_parameters with its - # type derived from tosca.datatypes.nfv.VnfOperationAdditionalParameters inputs: + additional_parameters: + type: tosca.datatypes.nfv.VnfOperationAdditionalParameters + required: false + # derived types are expected to introduce additional_parameters with its + # type derived from tosca.datatypes.nfv.VnfOperationAdditionalParameters instantiation_level: type: string description: Identifier of the target instantiation level of the current deployment flavour to which the VNF is requested to be scaled. Either instantiation_level or scale_info shall be provided. @@ -1340,36 +1305,36 @@ interface_types: description: Invoked after scale_to_level create_snapshot: description: Invoked upon receipt of a Create VNF snapshot request - # inputs: - # additional_parameters: - # type: tosca.datatypes.nfv.VnfOperationAdditionalParameters - # required: false - # derived types are expected to introduce additional_parameters with its - # type derived from tosca.datatypes.nfv.VnfOperationAdditionalParameters + inputs: + additional_parameters: + type: tosca.datatypes.nfv.VnfOperationAdditionalParameters + required: false + # derived types are expected to introduce additional_parameters with its + # type derived from tosca.datatypes.nfv.VnfOperationAdditionalParameters create_snapshot_start: description: Invoked before create_snapshot create_snapshot_end: description: Invoked after create_snapshot revert_to_snapshot: description: Invoked upon receipt of a Revert to VNF snapshot request - # inputs: - # additional_parameters: - # type: tosca.datatypes.nfv.VnfOperationAdditionalParameters - # required: false - # derived types are expected to introduce additional_parameters with its - # type derived from tosca.datatypes.nfv.VnfOperationAdditionalParameters + inputs: + additional_parameters: + type: tosca.datatypes.nfv.VnfOperationAdditionalParameters + required: false + # derived types are expected to introduce additional_parameters with its + # type derived from tosca.datatypes.nfv.VnfOperationAdditionalParameters revert_to_snapshot_start: description: Invoked before revert_to_snapshot revert_to_snapshot_end: description: Invoked after revert_to_snapshot change_current_package: description: Invoked by tosca.policies.nfv.VnfPackageChange - # inputs: - # additional_parameters: - # type: tosca.datatypes.nfv.VnfOperationAdditionalParameters - # required: false - # derived types are expected to introduce additional_parameters with its - # type derived from tosca.datatypes.nfv.VnfOperationAdditionalParameters + inputs: + additional_parameters: + type: tosca.datatypes.nfv.VnfOperationAdditionalParameters + required: false + # derived types are expected to introduce additional_parameters with its + # type derived from tosca.datatypes.nfv.VnfOperationAdditionalParameters change_current_package_start: description: Invoked by tosca.policies.nfv.VnfPackageChange change_current_package_end: @@ -1400,91 +1365,92 @@ interface_types: # type derived from tosca.datatypes.nfv.VnfOperationAdditionalParameters node_types: + tosca.nodes.nfv.VNF: derived_from: tosca.nodes.Root description: The generic abstract type from which all VNF specific node types shall be derived to form, together with other node types, the TOSCA service template(s) representing the VNFD properties: descriptor_id: # instead of vnfd_id - type: string # UUID - description: Identifier of this VNFD information element. This attribute shall be globally unique - required: true + type: string # UUID + description: Identifier of this VNFD information element. This attribute shall be globally unique + required: true descriptor_version: # instead of vnfd_version - type: string - description: Identifies the version of the VNFD - required: true + type: string + description: Identifies the version of the VNFD + required: true provider: # instead of vnf_provider - type: string - description: Provider of the VNF and of the VNFD - required: true + type: string + description: Provider of the VNF and of the VNFD + required: true product_name: # instead of vnf_product_name - type: string - description: Human readable name for the VNF Product - required: true + type: string + description: Human readable name for the VNF Product + required: true software_version: # instead of vnf_software_version - type: string - description: Software version of the VNF - required: true + type: string + description: Software version of the VNF + required: true product_info_name: # instead of vnf_product_info_name - type: string - description: Human readable name for the VNF Product - required: false + type: string + description: Human readable name for the VNF Product + required: false product_info_description: # instead of vnf_product_info_description - type: string - description: Human readable description of the VNF Product - required: false - vnfm_info: - type: list - required: true - description: Identifies VNFM(s) compatible with the VNF - entry_schema: type: string - constraints: - - pattern: (^etsivnfm:v[0-9]?[0-9]\.[0-9]?[0-9]\.[0-9]?[0-9]$)|(^[0-9]+:[a-zA-Z0-9.-]+$) + description: Human readable description of the VNF Product + required: false + vnfm_info: + type: list + required: true + description: Identifies VNFM(s) compatible with the VNF + entry_schema: + type: string + constraints: + - pattern: (^etsivnfm:v[0-9]?[0-9]\.[0-9]?[0-9]\.[0-9]?[0-9]$)|(^[0-9]+:[a-zA-Z0-9.-]+$) localization_languages: - type: list - description: Information about localization languages of the VNF - required: false - entry_schema: - type: string #IETF RFC 5646 string + type: list + description: Information about localization languages of the VNF + required: false + entry_schema: + type: string #IETF RFC 5646 string default_localization_language: - type: string #IETF RFC 5646 string - description: Default localization language that is instantiated if no information about selected localization language is available - required: false - #configurable_properties: - #type: tosca.datatypes.nfv.VnfConfigurableProperties - #description: Describes the configurable properties of the VNF - #required: false - # derived types are expected to introduce configurable_properties - # with its type derived from tosca.datatypes.nfv.VnfConfigurableProperties - #modifiable_attributes: - #type: tosca.datatypes.nfv.VnfInfoModifiableAttributes - #description: Describes the modifiable attributes of the VNF - #required: false - # derived types are expected to introduce modifiable_attributes - # with its type derived from - # tosca.datatypes.nfv.VnfInfoModifiableAttributes + type: string #IETF RFC 5646 string + description: Default localization language that is instantiated if no information about selected localization language is available + required: false + configurable_properties: + type: tosca.datatypes.nfv.VnfConfigurableProperties + description: Describes the configurable properties of the VNF + required: false + # derived types are expected to introduce configurable_properties + # with its type derived from tosca.datatypes.nfv.VnfConfigurableProperties + modifiable_attributes: + type: tosca.datatypes.nfv.VnfInfoModifiableAttributes + description: Describes the modifiable attributes of the VNF + required: false + # derived types are expected to introduce modifiable_attributes + # with its type derived from + # tosca.datatypes.nfv.VnfInfoModifiableAttributes lcm_operations_configuration: - type: tosca.datatypes.nfv.VnfLcmOperationsConfiguration - description: Describes the configuration parameters for the VNF LCM operations - required: false + type: tosca.datatypes.nfv.VnfLcmOperationsConfiguration + description: Describes the configuration parameters for the VNF LCM operations + required: false monitoring_parameters: - type: map # key: id - entry_schema: - type: tosca.datatypes.nfv.VnfMonitoringParameter - description: Describes monitoring parameters applicable to the VNF. - required: false + type: map # key: id + entry_schema: + type: tosca.datatypes.nfv.VnfMonitoringParameter + description: Describes monitoring parameters applicable to the VNF. + required: false flavour_id: - type: string - description: Identifier of the Deployment Flavour within the VNFD - required: true + type: string + description: Identifier of the Deployment Flavour within the VNFD + required: true flavour_description: - type: string - description: Human readable description of the DF - required: true + type: string + description: Human readable description of the DF + required: true vnf_profile: - type: tosca.datatypes.nfv.VnfProfile - description: Describes a profile for instantiating VNFs of a particular NS DF according to a specific VNFD and VNF DF - required: false + type: tosca.datatypes.nfv.VnfProfile + description: Describes a profile for instantiating VNFs of a particular NS DF according to a specific VNFD and VNF DF + required: false attributes: scale_status: type: map # key: aspectId @@ -1496,25 +1462,25 @@ node_types: capability: tosca.capabilities.nfv.VirtualLinkable relationship: tosca.relationships.nfv.VirtualLinksTo occurrences: [ 0, 1 ] - # Additional requirements shall be defined in the VNF specific node type (deriving from tosca.nodes.nfv.VNF) corresponding to NS virtual links that need to connect to VnfExtCps + # Additional requirements shall be defined in the VNF specific node type (deriving from tosca.nodes.nfv.VNF) corresponding to NS virtual links that need to connect to VnfExtCps interfaces: Vnflcm: type: tosca.interfaces.nfv.Vnflcm - # VnfIndicator: - # type: tosca.interfaces.nfv.VnfIndicator - # derived types are expected to introduce Vnf Indicator interfaces - # with their type derived from tosca.interfaces.nfv.VnfIndicator + VnfIndicator: + type: tosca.interfaces.nfv.VnfIndicator + # derived types are expected to introduce Vnf Indicator interfaces + # with their type derived from tosca.interfaces.nfv.VnfIndicator tosca.nodes.nfv.VnfExtCp: derived_from: tosca.nodes.nfv.Cp description: Describes a logical external connection point, exposed by the VNF enabling connection with an external Virtual Link properties: virtual_network_interface_requirements: - type: list - description: The actual virtual NIC requirements that is been assigned when instantiating the connection point - required: false - entry_schema: - type: tosca.datatypes.nfv.VirtualNetworkInterfaceRequirements + type: list + description: The actual virtual NIC requirements that is been assigned when instantiating the connection point + required: false + entry_schema: + type: tosca.datatypes.nfv.VirtualNetworkInterfaceRequirements requirements: - external_virtual_link: capability: tosca.capabilities.nfv.VirtualLinkable @@ -1538,7 +1504,7 @@ node_types: description: Human readable description of the VDU required: true boot_order: - type: boolean + type: boolean description: indicates whether the order of the virtual_storage requirements is used as the boot index (the first requirement represents the lowest index and defines highest boot priority) required: true default: false @@ -1554,12 +1520,12 @@ node_types: required: false entry_schema: type: tosca.datatypes.nfv.VnfcMonitoringParameter - #configurable_properties: - #type: tosca.datatypes.nfv.VnfcConfigurableProperties - #required: false - # derived types are expected to introduce - # configurable_properties with its type derived from - # tosca.datatypes.nfv.VnfcConfigurableProperties + configurable_properties: + type: tosca.datatypes.nfv.VnfcConfigurableProperties + required: false + # derived types are expected to introduce + # configurable_properties with its type derived from + # tosca.datatypes.nfv.VnfcConfigurableProperties vdu_profile: type: tosca.datatypes.nfv.VduProfile description: Defines additional instantiation data for the VDU.Compute node @@ -1630,56 +1596,56 @@ node_types: capabilities: virtual_storage: type: tosca.capabilities.nfv.VirtualStorage - #description: Defines the capabilities of virtual_storage. + description: Defines the capabilities of virtual_storage. + requirements: + - virtual_link: + capability: tosca.capabilities.nfv.VirtualLinkable + relationship: tosca.relationships.nfv.VirtualLinksTo + occurrences: [1, 1] + # description: Describes the requirements for linking to virtual link + + tosca.nodes.nfv.VduCp: + derived_from: tosca.nodes.nfv.Cp + description: describes network connectivity between a VNFC instance based on this VDU and an internal VL + properties: + bitrate_requirement: + type: integer # in bits per second + description: Bitrate requirement in bit per second on this connection point + required: false + constraints: + - greater_or_equal: 0 + virtual_network_interface_requirements: + type: list + description: Specifies requirements on a virtual network interface realizing the CPs instantiated from this CPD + required: false + entry_schema: + type: tosca.datatypes.nfv.VirtualNetworkInterfaceRequirements + order: + type: integer + description: The order of the NIC on the compute instance (e.g.eth2) + required: false + constraints: + - greater_or_equal: 0 + vnic_type: + type: string + description: Describes the type of the virtual network interface realizing the CPs instantiated from this CPD + required: false + constraints: + - valid_values: [ normal, macvtap, direct, baremetal, virtio-forwarder, direct-physical, smart-nic ] + capabilities: + trunk_binding: # This capability is available only the trunk_mode property value of this VduCp is "true" and there is at least one VduSubCp defined as subport of the same trunk. + type: tosca.capabilities.nfv.TrunkBindable + occurrences: [ 0, UNBOUNDED ] requirements: - virtual_link: capability: tosca.capabilities.nfv.VirtualLinkable relationship: tosca.relationships.nfv.VirtualLinksTo occurrences: [1, 1] - # description: Describes the requirements for linking to virtual link - - tosca.nodes.nfv.VduCp: - derived_from: tosca.nodes.nfv.Cp - description: describes network connectivity between a VNFC instance based on this VDU and an internal VL - properties: - bitrate_requirement: - type: integer # in bits per second - description: Bitrate requirement in bit per second on this connection point - required: false - constraints: - - greater_or_equal: 0 - virtual_network_interface_requirements: - type: list - description: Specifies requirements on a virtual network interface realising the CPs instantiated from this CPD - required: false - entry_schema: - type: tosca.datatypes.nfv.VirtualNetworkInterfaceRequirements - order: - type: integer - description: The order of the NIC on the compute instance (e.g.eth2) - required: false - constraints: - - greater_or_equal: 0 - vnic_type: - type: string - description: Describes the type of the virtual network interface realizing the CPs instantiated from this CPD - required: false - constraints: - - valid_values: [ normal, macvtap, direct, baremetal, virtio-forwarder, direct-physical, smart-nic ] - capabilities: - trunk_binding: # This capability is available only the trunk_mode property value of this VduCp is “trueâ€?and there is at least one VduSubCp defined as subport of the same trunk. - type: tosca.capabilities.nfv.TrunkBindable - occurrences: [ 0, UNBOUNDED ] - requirements: - - virtual_link: - capability: tosca.capabilities.nfv.VirtualLinkable - relationship: tosca.relationships.nfv.VirtualLinksTo - occurrences: [1, 1] - - virtual_binding: - capability: tosca.capabilities.nfv.VirtualBindable - relationship: tosca.relationships.nfv.VirtualBindsTo - node: tosca.nodes.nfv.Vdu.Compute - occurrences: [0, 1] + - virtual_binding: + capability: tosca.capabilities.nfv.VirtualBindable + relationship: tosca.relationships.nfv.VirtualBindsTo + node: tosca.nodes.nfv.Vdu.Compute + occurrences: [0, 1] tosca.nodes.nfv.VnfVirtualLink: derived_from: tosca.nodes.Root @@ -1717,15 +1683,14 @@ node_types: required: false externally_managed: type: string - description: Specifies the intent of the VNF designer w.r.t. the external management of the internal VL instances created from this descriptor, i.e. whether it is "allowed" or "required" that these are externally managed. If this property is absent, the value "allowed" is assumed. If the VNFD does not reference any LCM script and if the "vnfm_info" property in the VNF-specific node type derived from the "tosca.nodes.nfv.VNF" node type indicates that the VNF can be managed by any ETSI NFV compliant VNFM, this property shall not be present. + description: Specifies the intent of the VNF designer w.r.t. the external management of the internal VL instances created from this descriptor, i.e. whether it is "allowed" or "required" that these are externally managed. If this property is absent, the value "allowed" is assumed. If the VNFD does not reference any LCM script and if the "vnfm_info" property in the VNF-specific node type derived from the tosca.nodes.nfv.VNF node type indicates that the VNF can be managed by any ETSI NFV compliant VNFM, this property shall not be present. required: false - entry_schema: - type: string - constraints: - - valid_values: [ allowed, required ] + + constraints: + - valid_values: [ allowed, required ] capabilities: virtual_linkable: - type: tosca.capabilities.nfv.VirtualLinkable + type: tosca.capabilities.nfv.VirtualLinkable tosca.nodes.nfv.VipCp: derived_from: tosca.nodes.nfv.Cp @@ -1735,7 +1700,7 @@ node_types: type: boolean description: Indicates whether the VIP address shall be different from the addresses allocated to all associated VduCp instances or shall be the same as one of them. required: true - default: true + default: true vip_function: type: string description: "Indicates the function the virtual IP address is used for: high availability or load balancing. When used for high availability, only one of the internal VDU CP instances or VNF external CP instances that share the virtual IP is bound to the VIP address at a time. When used for load balancing purposes all CP instances that share the virtual IP are bound to it." @@ -1775,132 +1740,133 @@ node_types: relationship: tosca.relationships.nfv.TrunkBindsTo node: tosca.nodes.nfv.VduCp occurrences: [1, 1] - + group_types: + tosca.groups.nfv.PlacementGroup: derived_from: tosca.groups.Root - description: PlacementGroup is used for describing the affinity or anti-affinity relationship applicable between the virtualization containers to be created based on different VDUs, or between internal VLs to be created based on different VnfVirtualLinkDesc(s) + description: PlacementGroup is used for describing the affinity or anti-affinity relationship applicable between the virtualisation containers to be created based on different VDUs, or between internal VLs to be created based on different VnfVirtualLinkDesc(s) properties: description: - type: string - description: Human readable description of the group - required: true + type: string + description: Human readable description of the group + required: true members: [ tosca.nodes.nfv.Vdu.Compute, tosca.nodes.nfv.VnfVirtualLink ] - policy_types: + tosca.policies.nfv.InstantiationLevels: derived_from: tosca.policies.Root - description: The InstantiationLevels type is a policy type representing all the instantiation levels of resources to be instantiated within a deployment flavour and including default instantiation level in term of the number of VNFC instances to be created as defined in ETSI GS NFV-IFA 011 [1]. + description: The InstantiationLevels type is a policy type representing all the instantiation levels of resources to be instantiated within a deployment flavour and including default instantiation level in term of the number of VNFC instances to be created as defined in ETSI GS NFV-IFA 011. properties: levels: - type: map # key: levelId - description: Describes the various levels of resources that can be used to instantiate the VNF using this flavour. - required: true - entry_schema: - type: tosca.datatypes.nfv.InstantiationLevel - constraints: - - min_length: 1 + type: map # key: levelId + description: Describes the various levels of resources that can be used to instantiate the VNF using this flavour. + required: true + entry_schema: + type: tosca.datatypes.nfv.InstantiationLevel + constraints: + - min_length: 1 default_level: - type: string # levelId - description: The default instantiation level for this flavour. - required: false # required if multiple entries in levels + type: string # levelId + description: The default instantiation level for this flavour. + required: false # required if multiple entries in levels tosca.policies.nfv.VduInstantiationLevels: derived_from: tosca.policies.Root - description: The VduInstantiationLevels type is a policy type representing all the instantiation levels of resources to be instantiated within a deployment flavour in term of the number of VNFC instances to be created from each vdu.Compute. as defined in ETSI GS NFV-IFA 011 [1] + description: The VduInstantiationLevels type is a policy type representing all the instantiation levels of resources to be instantiated within a deployment flavour in term of the number of VNFC instances to be created from each vdu.Compute. as defined in ETSI GS NFV-IFA 011 properties: levels: - type: map # key: levelId - description: Describes the Vdu.Compute levels of resources that can be used to instantiate the VNF using this flavour - required: true - entry_schema: - type: tosca.datatypes.nfv.VduLevel - constraints: - - min_length: 1 + type: map # key: levelId + description: Describes the Vdu.Compute levels of resources that can be used to instantiate the VNF using this flavour + required: true + entry_schema: + type: tosca.datatypes.nfv.VduLevel + constraints: + - min_length: 1 targets: [ tosca.nodes.nfv.Vdu.Compute ] tosca.policies.nfv.VirtualLinkInstantiationLevels: derived_from: tosca.policies.Root - description: The VirtualLinkInstantiationLevels type is a policy type representing all the instantiation levels of virtual link resources to be instantiated within a deployment flavour as defined in ETSI GS NFV-IFA 011 [1]. + description: The VirtualLinkInstantiationLevels type is a policy type representing all the instantiation levels of virtual link resources to be instantiated within a deployment flavour as defined in ETSI GS NFV-IFA 011. properties: levels: - type: map # key: levelId - description: Describes the virtual link levels of resources that can be used to instantiate the VNF using this flavour. - required: true - entry_schema: - type: tosca.datatypes.nfv.VirtualLinkBitrateLevel - constraints: - - min_length: 1 + type: map # key: levelId + description: Describes the virtual link levels of resources that can be used to instantiate the VNF using this flavour. + required: true + entry_schema: + type: tosca.datatypes.nfv.VirtualLinkBitrateLevel + constraints: + - min_length: 1 targets: [ tosca.nodes.nfv.VnfVirtualLink ] tosca.policies.nfv.ScalingAspects: derived_from: tosca.policies.Root - description: The ScalingAspects type is a policy type representing the scaling aspects used for horizontal scaling as defined in ETSI GS NFV-IFA 011 [1] + description: The ScalingAspects type is a policy type representing the scaling aspects used for horizontal scaling as defined in ETSI GS NFV-IFA 011 properties: aspects: - type: map # key: aspectId - description: Describe maximum scale level for total number of scaling steps that can be applied to a particular aspect - required: true - entry_schema: - type: tosca.datatypes.nfv.ScalingAspect - constraints: - - min_length: 1 + type: map # key: aspectId + description: Describe maximum scale level for total number of scaling steps that can be applied to a particular aspect + required: true + entry_schema: + type: tosca.datatypes.nfv.ScalingAspect + constraints: + - min_length: 1 tosca.policies.nfv.VduScalingAspectDeltas: derived_from: tosca.policies.Root - description: The VduScalingAspectDeltas type is a policy type representing the Vdu.Compute detail of an aspect deltas used for horizontal scaling, as defined in ETSI GS NFV-IFA 011 [1] + description: The VduScalingAspectDeltas type is a policy type representing the Vdu.Compute detail of an aspect deltas used for horizontal scaling, as defined in ETSI GS NFV-IFA 011 properties: aspect: - type: string - description: Represents the scaling aspect to which this policy applies - required: true + type: string + description: Represents the scaling aspect to which this policy applies + required: true deltas: - type: map # key: scalingDeltaId - description: Describes the Vdu.Compute scaling deltas to be applied for every scaling steps of a particular aspect. - required: true - entry_schema: - type: tosca.datatypes.nfv.VduLevel - constraints: - - min_length: 1 + type: map # key: scalingDeltaId + description: Describes the Vdu.Compute scaling deltas to be applied for every scaling steps of a particular aspect. + required: true + entry_schema: + type: tosca.datatypes.nfv.VduLevel + constraints: + - min_length: 1 targets: [ tosca.nodes.nfv.Vdu.Compute ] tosca.policies.nfv.VirtualLinkBitrateScalingAspectDeltas: derived_from: tosca.policies.Root - description: The VirtualLinkBitrateScalingAspectDeltas type is a policy type representing the VnfVirtualLink detail of an aspect deltas used for horizontal scaling, as defined in ETSI GS NFV-IFA 011 [1]. + description: The VirtualLinkBitrateScalingAspectDeltas type is a policy type representing the VnfVirtualLink detail of an aspect deltas used for horizontal scaling, as defined in ETSI GS NFV-IFA 011. properties: aspect: - type: string - description: Represents the scaling aspect to which this policy applies. - required: true + type: string + description: Represents the scaling aspect to which this policy applies. + required: true deltas: - type: map # key: scalingDeltaId - description: Describes the VnfVirtualLink scaling deltas to be applied for every scaling steps of a particular aspect. - required: true - entry_schema: - type: tosca.datatypes.nfv.VirtualLinkBitrateLevel - constraints: - - min_length: 1 + type: map # key: scalingDeltaId + description: Describes the VnfVirtualLink scaling deltas to be applied for every scaling steps of a particular aspect. + required: true + entry_schema: + type: tosca.datatypes.nfv.VirtualLinkBitrateLevel + constraints: + - min_length: 1 targets: [ tosca.nodes.nfv.VnfVirtualLink ] tosca.policies.nfv.VduInitialDelta: derived_from: tosca.policies.Root - description: The VduInitialDelta type is a policy type representing the Vdu.Compute detail of an initial delta used for horizontal scaling, as defined in ETSI GS NFV-IFA 011 [1]. + description: The VduInitialDelta type is a policy type representing the Vdu.Compute detail of an initial delta used for horizontal scaling, as defined in ETSI GS NFV-IFA 011. properties: - initial_delta: - type: tosca.datatypes.nfv.VduLevel - description: Represents the initial minimum size of the VNF. - required: true + initial_delta: + type: tosca.datatypes.nfv.VduLevel + description: Represents the initial minimum size of the VNF. + required: true targets: [ tosca.nodes.nfv.Vdu.Compute ] tosca.policies.nfv.VirtualLinkBitrateInitialDelta: derived_from: tosca.policies.Root - description: The VirtualLinkBitrateInitialDelta type is a policy type representing the VnfVirtualLink detail of an initial deltas used for horizontal scaling, as defined in ETSI GS NFV-IFA 011 [1]. + description: The VirtualLinkBitrateInitialDelta type is a policy type representing the VnfVirtualLink detail of an initial deltas used for horizontal scaling, as defined in ETSI GS NFV-IFA 011. properties: initial_delta: - type: tosca.datatypes.nfv.VirtualLinkBitrateLevel - description: Represents the initial minimum size of the VNF. - required: true + type: tosca.datatypes.nfv.VirtualLinkBitrateLevel + description: Represents the initial minimum size of the VNF. + required: true targets: [ tosca.nodes.nfv.VnfVirtualLink ] tosca.policies.nfv.AffinityRule: @@ -1908,11 +1874,11 @@ policy_types: description: The AffinityRule describes the affinity rules applicable for the defined targets properties: scope: - type: string - description: scope of the rule is an NFVI_node, an NFVI_PoP, etc. - required: true - constraints: - - valid_values: [ nfvi_node, zone, zone_group, nfvi_pop, network_link_and_node ] + type: string + description: scope of the rule is an NFVI_node, an NFVI_PoP, etc. + required: true + constraints: + - valid_values: [ nfvi_node, zone, zone_group, nfvi_pop, network_link_and_node ] nfvi_maintenance_group_info: type: tosca.datatypes.nfv.NfviMaintenanceInfo description: Provides information on the impact tolerance and rules to be observed when a group of instances based on the same Vdu.Compute node is impacted during NFVI operation and maintenance (e.g. NFVI resource upgrades). @@ -1924,41 +1890,41 @@ policy_types: description: The AntiAffinityRule describes the anti-affinity rules applicable for the defined targets properties: scope: - type: string - description: scope of the rule is an NFVI_node, an NFVI_PoP, etc. - required: true - constraints: - - valid_values: [ nfvi_node, zone, zone_group, nfvi_pop, network_link_and_node ] + type: string + description: scope of the rule is an NFVI_node, an NFVI_PoP, etc. + required: true + constraints: + - valid_values: [ nfvi_node, zone, zone_group, nfvi_pop, network_link_and_node ] nfvi_maintenance_group_info: type: tosca.datatypes.nfv.NfviMaintenanceInfo description: Provides information on the impact tolerance and rules to be observed when a group of instances based on the same Vdu.Compute node is impacted during NFVI operation and maintenance (e.g. NFVI resource upgrades). required: false targets: [ tosca.nodes.nfv.Vdu.Compute, tosca.nodes.nfv.VnfVirtualLink, tosca.groups.nfv.PlacementGroup ] - + tosca.policies.nfv.SupportedVnfInterface: - derived_from: tosca.policies.Root - description: this policy type represents interfaces produced by a VNF, the details to access them and the applicable connection points to use to access these interfaces - properties: - interface_name: - type: string - description: Identifies an interface produced by the VNF. - required: true - constraints: - - valid_values: [ vnf_indicator, vnf_configuration, vnf_lcm_coordination ] - details: - type: tosca.datatypes.nfv.InterfaceDetails - description: Provide additional data to access the interface endpoint - required: false - targets: [ tosca.nodes.nfv.VnfExtCp, tosca.nodes.nfv.VduCp ] + derived_from: tosca.policies.Root + description: this policy type represents interfaces produced by a VNF, the details to access them and the applicable connection points to use to access these interfaces + properties: + interface_name: + type: string + description: Identifies an interface produced by the VNF. + required: true + constraints: + - valid_values: [ vnf_indicator, vnf_configuration, vnf_lcm_coordination ] + details: + type: tosca.datatypes.nfv.InterfaceDetails + description: Provide additional data to access the interface endpoint + required: false + targets: [ tosca.nodes.nfv.VnfExtCp, tosca.nodes.nfv.VduCp ] tosca.policies.nfv.SecurityGroupRule: derived_from: tosca.policies.nfv.Abstract.SecurityGroupRule - description: The SecurityGroupRule type is a policy type specified the matching criteria for the ingress and/or egress traffic to/from visited connection points as defined in ETSI GS NFV-IFA 011 [1]. + description: The SecurityGroupRule type is a policy type specified the matching criteria for the ingress and/or egress traffic to/from visited connection points as defined in ETSI GS NFV-IFA 011. targets: [ tosca.nodes.nfv.VduCp, tosca.nodes.nfv.VnfExtCp ] tosca.policies.nfv.VnfIndicator: derived_from: tosca.policies.Root - description: The VnfIndicator policy type is a base policy type for defining VNF indicator specific policies that define the conditions to assess and the action to perform when a VNF indicator changes value as defined in ETSI GS NFV-IFA 011 [1]. + description: The VnfIndicator policy type is a base policy type for defining VNF indicator specific policies that define the conditions to assess and the action to perform when a VNF indicator changes value as defined in ETSI GS NFV-IFA 011. properties: source: type: string @@ -2008,7 +1974,7 @@ policy_types: entry_schema: type: string targets: [ tosca.nodes.nfv.VNF ] - + tosca.policies.nfv.LcmCoordinationAction: derived_from: tosca.policies.Root description: The LcmCoordinationAction type is a policy type representing the LCM coordination actions supported by a VNF and/or expected to be supported by its EM for a particular VNF LCM operation. This policy concerns the whole VNF (deployment flavour) represented by the topology_template and thus has no explicit target list. @@ -2017,10 +1983,10 @@ policy_types: type: string description: Coordination action name. required: true - # action: #represents a place holder for specifying actions of a VNF-specific type derived from tosca.datatypes.nfv.VnfLcmOpCoord - # type: tosca.datatypes.nfv.VnfLcmOpCoord - # description: Describes a set of information needed for coordination action in the VNF LCM operation. - # required: true + action: #represents a place holder for specifying actions of a VNF-specific type derived from tosca.datatypes.nfv.VnfLcmOpCoord + type: tosca.datatypes.nfv.VnfLcmOpCoord + description: Describes a set of information needed for coordination action in the VNF LCM operation. + required: true tosca.policies.nfv.LcmCoordinationsForLcmOperation: derived_from: tosca.policies.Root @@ -2044,8 +2010,45 @@ policy_types: required: false entry_schema: type: string - - + tosca.policies.nfv.VipCpScalingAspectDeltas: + derived_from: tosca.policies.Root + description: The VipCpScalingAspectDeltas type is a policy type representing the VipCp detail of an aspect deltas used for horizontal scaling, as defined in ETSI GS NFV-IFA 011 [1] + properties: + aspect: + type: string + description: Represents the scaling aspect to which this policy applies + required: true + deltas: + type: map # key: scalingDeltaId + description: Describes the VipCp scaling deltas to be applied for every scaling steps of a particular aspect. + required: true + entry_schema: + type: tosca.datatypes.nfv.VipCpLevel + constraints: + - min_length: 1 + targets: [ tosca.nodes.nfv.VipCp ] + tosca.policies.nfv.VipCpInitialDelta: + derived_from: tosca.policies.Root + description: The VipCpInitialDelta type is a policy type representing the VipCp detail of an initial delta used for horizontal scaling, as defined in ETSI GS NFV-IFA 011 [1] + properties: + initial_delta: + type: tosca.datatypes.nfv.VipCpLevel + description: Represents the initial minimum size of the VNF. + required: true + targets: [ tosca.nodes.nfv.VipCp ] + tosca.policies.nfv.VipCpInstantiationLevels: + derived_from: tosca.policies.Root + description: The VipCpInstantiationLevels type is a policy type representing all the instantiation levels of resources to be instantiated within a deployment flavour in term of the number of VipCp instances to be created from each VipCp as defined in ETSI GS NFV-IFA 011. + properties: + levels: + type: map # key: levelId + description: Describes the VipCp levels of resources that can be used to instantiate the VNF using this flavour + required: true + entry_schema: + type: tosca.datatypes.nfv.VipCpLevel + constraints: + - min_length: 1 + targets: [ tosca.nodes.nfv.VipCp ] diff --git a/scripts/Dockerfile.puccini b/scripts/Dockerfile.puccini new file mode 100644 index 0000000000000000000000000000000000000000..ff4187850cac0a11c97a988f1ee15abc7e1e25a0 --- /dev/null +++ b/scripts/Dockerfile.puccini @@ -0,0 +1,14 @@ +FROM ubuntu:16.04 + +#COPY requirements.txt /requirements.txt +RUN apt-get update && apt-get install -y -qq curl git gcc +RUN curl -OL https://golang.org/dl/go1.18.3.linux-amd64.tar.gz +RUN tar -C /usr/local -xzf go1.18.3.linux-amd64.tar.gz + +ENV PATH="${PATH}:/usr/local/go/bin" + +RUN git clone https://github.com/tliron/puccini.git /puccini + +RUN ./puccini/scripts/build + +ENV PATH="${PATH}:/root/go/bin" diff --git a/scripts/build_tosca_parser.sh b/scripts/build_tosca_parser.sh new file mode 100755 index 0000000000000000000000000000000000000000..9f68332e5c80e28dc698d60eee561aa420029899 --- /dev/null +++ b/scripts/build_tosca_parser.sh @@ -0,0 +1,36 @@ +#!/bin/bash +TOSCA_PARSER="Cloudnet-TOSCA-toolbox" +GIT_URL_TOSCA_TOOLBOX="https://github.com/Orange-OpenSource/Cloudnet-TOSCA-toolbox.git" +TOSCA_PARSER_FOLDER="tosca-parser/" + +while getopts v: flag +do + case "${flag}" in + v) TOSCA_PARSER=${OPTARG};; + esac +done + +if [ ${TOSCA_PARSER} == "Cloudnet-TOSCA-toolbox" ] ; then + # clone robot tests + git clone $GIT_URL_TOSCA_TOOLBOX $TOSCA_PARSER_FOLDER + cd $TOSCA_PARSER_FOLDER + + docker build -t cloudnet/toscaware bin/toscaware + + #pwd + #docker run -v "${PWD}:/work" -v "${PWD}/bin/cloudnet:/cloudnet" --workdir="/work" cloudnet/toscaware /bin/sh -c "echo Building image" + #docker run --name=tosca-parser -v "${PWD}:/work" --workdir="/work" cloudnet/toscaware /bin/sh -c "ls" + #sleep 5; + #container_to_update=`docker ps -n 1 --format '{{.Names}}'` + #echo "Creating updated image from container ${container_to_update}" + #docker container commit ${container_to_update} cloudnet/toscaware:latest + #echo "Deleting old container ${container_to_update}" + #docker container rm ${container_to_update} + +elif [ ${TOSCA_PARSER} == "Puccini" ] ; then + #Build Puccini docker from Dockerfile + docker build -t puccini -f scripts/Dockerfile.puccini . + +fi + +exit diff --git a/scripts/parse_tosca_definitions.sh b/scripts/parse_tosca_definitions.sh new file mode 100755 index 0000000000000000000000000000000000000000..20b0c0501ddaa4c036201a65e182a61acc358e15 --- /dev/null +++ b/scripts/parse_tosca_definitions.sh @@ -0,0 +1,79 @@ +#!/bin/bash +TOSCA_PARSER="Cloudnet-TOSCA-toolbox" +GIT_URL_TOSCA_TOOLBOX="https://github.com/Orange-OpenSource/Cloudnet-TOSCA-toolbox.git" +TOSCA_PARSER_FOLDER="tosca-parser/" + +while getopts v: flag +do + case "${flag}" in + v) TOSCA_PARSER=${OPTARG};; + esac +done + +if [ ${TOSCA_PARSER} == "Cloudnet-TOSCA-toolbox" ] ; then + # Parse TOSCA definitions + echo "Cloudnet-TOSCA-toolbox: Validation starting ..." + # Cloudnet-TOSCA-toolbox + git clone $GIT_URL_TOSCA_TOOLBOX $TOSCA_PARSER_FOLDER + + mkdir ${TOSCA_PARSER_FOLDER}examples/sol001 + cp *.yaml -t ${TOSCA_PARSER_FOLDER}examples/sol001 + + cd ${TOSCA_PARSER_FOLDER}examples/sol001 + + CLOUDNET_BINDIR=../../bin + . ${CLOUDNET_BINDIR}/cloudnet_rc.sh + + finalResult=0 + for i in *.yaml ; do + + result=0 + echo "Cloudnet-TOSCA-toolbox: Validating file $i..." >> debugCloudnet.log + ../../bin/toscaware/toscaware $i &> debug.log + #docker ${DOCKER_OPTS} run --user "$(id -u)":"$(id -g)" -v "${PWD}/${TOSCA_PARSER_FOLDER}:/work" -v "${PWD}/${TOSCA_PARSER_FOLDER}/bin/cloudnet:/cloudnet" --workdir="/work" --rm --attach=stdin --attach=stdout --attach=stderr cloudnet/toscaware python ${PYTHON_OPTS} /cloudnet/tosca/tosca2cloudnet.py --template-file "$i" ${TOSCAWARE_OPTS} + + #docker ${DOCKER_OPTS} run --user "$(id -u)":"$(id -g)" --rm --attach=stdin --attach=stdout --attach=stderr cloudnet/toscaware python ${PYTHON_OPTS} /cloudnet/tosca/tosca2cloudnet.py --template-file "$1" ${TOSCAWARE_OPTS} + #./${TOSCA_PARSER_FOLDER}/bin/toscaware/toscaware $i $> debug.log + + if [ $? == 2 ] ; then + + echo "Cloudnet-TOSCA-toolbox: ++++ Issues found with TOSCA file syntax in $i" + grep "ERROR" < debug.log + finalResult=1 + else + echo "Cloudnet-TOSCA-toolbox: ++++ TOSCA parser finished validation of $i" + #Check the debug messages, if there's at least one ERROR then res=1 + if [ `grep "ERROR" < debug.log | wc -l` == 0 ] ; then + echo "++++ TOSCA parser finished validation of $i with no errors" + else + echo "Cloudnet-TOSCA-toolbox: ++++ TOSCA parser finished validation of $i with errors" + grep "ERROR" < debug.log + finalResult=1 + fi + fi + cat debug.log >> debugCloudnet.log + done + + cp debugCloudnet.log ../../../debugCloudnet.log +elif [ ${TOSCA_PARSER} == "Puccini" ] ; then + finalResult=0 + echo "Puccini: Validation starting ..." + + docker run --rm -v "${PWD}:/sol001" puccini ./sol001/scripts/puccini_parse.sh &> debugPuccini.log + + if [ $? == 0 ] ; then + echo "Puccini: ++++ TOSCA parser finished validation with no errors" + elif [ $? == 1 ] ; then + echo "Puccini: ++++ TOSCA parser finished validation with errors" + #Check the debug messages, if there's at least one ERROR then res=1 + #if [ `grep "PROBLEMS" < debug.log | wc -l` > 0 ] ; then + # echo "Puccini: ++++ ERRORS: " + # grep "PROBLEMS" < debug.log + # res=1 + #fi + finalResult=1 + fi + +fi + +exit $finalResult \ No newline at end of file diff --git a/scripts/puccini_parse.sh b/scripts/puccini_parse.sh new file mode 100755 index 0000000000000000000000000000000000000000..d935c88932530885c8b30f314640b3f1479b8ba6 --- /dev/null +++ b/scripts/puccini_parse.sh @@ -0,0 +1,15 @@ +#!/bin/bash + +res=0 +for i in /sol001/*.yaml ; do + + echo "Puccini: Validating file $i..." + + puccini-tosca parse $i + + if [ $? == 1 ] ; then + res=1 + fi + +done +exit $res \ No newline at end of file