VNF Package CSAR Format Tal Halfon Amdocs Andrei
- Slides: 7
VNF Package CSAR Format Tal Halfon, Amdocs Andrei Kojukhov, Ph. D, Amdocs Aug 3, 2017
Main Principles for ONAP VNF Package CSAR Current Open-O CSAR is old based on xml-based TOSCA We need to implement a migration path to a new Telcograde VNF package format – ETSI GS NFV-SOL 004 standard, Consensus for CSAR format for ONAP R 1 is reached in https: //wiki. onap. org/pages/viewpage. action? page. Id=10781 062 Introducing a YAML-like Manifest file at the root of CSAR Key directory for all artifacts Adding digests for all artifacts (internal and external) Adding a CMS certificate signature – Optional for R 1
Items covered in ETSI GS NFV-SOL 004 CSAR Formats and how to use them Naming Conventions and Location for • Manifest file • Change History file • Testing files directory • Licensing information directory • Certificate files Security Features of the CSAR • Digests • Signature • Certificates • Encryption 4 © ETSI 2016. All rights reserved
VNF Package The VNF Package contains: • the VNF descriptor (VNFD) that defines metadata for package onboarding and VNF management, • the software images needed to run the VNF, and • Manifest file that provides package integrity and authenticity • (optional) additional files to manage the VNF (e. g. scripts, vendor-specific files etc. ). The VNF Package is delivered by the VNF provider as a whole and is immutable (protected from modification). The VNF Package or its Manifest file is digitally signed The VNF Package is stored in a repository by the NFVO. The VNF Package can be accessed by VNFM. 5 VNF Package Manifest file VNFD Software image(s) Additional files Reference: - ETSI GS NFV-IFA 011 - ETSI GS NFV-SOL 004
VNF Package Structure: TOSCA YAML CSAR without Metadata File CSAR contains a single yaml (. yml or. yaml) file at the root of the archive – MRF. yaml The yaml file contains a metadata section with template_name and template_version metadata. This file is the CSAR Entry-Definition file The CSAR-Version is defined by the template_version metadata: tosca_definitions_version: tosca_simple_yaml_1_1 metadata: template_name: MRF template_author: Company Name template_version: 1. 0 !----- MRF. yaml(R 1) !----- MRF. mf (R 1) !----- MRF. cert (R 2) !----- Change. Log. txt (R 2) !----- Tests (R 2) !----- file(s) !----- Licenses (R 1) !----- file(s) !----- Artifacts (R 1) !----- install. sh !----- images !----- templates !----- start. yang References: - ETSI GS NFV-SOL 004 - TOSCA-Simple-Profile-YAML-v 1. 1 6
VNF Package Manifest File with Optional security support VNF package metadata A list of blocks each is related to one file in the VNF package, including • Source: artifact URI • Optional Algorithm: name of an algorithm used to generate the hash • Optional Hash: text string corresponding to the hexadecimal representation of the hash 7 Optional Manifest file Signature metadata: vnf_product_name: v. MRF-1 -0 -0 vnf_provider_id: Acme vnf_package_version: 1. 0 vnf_release_data_time: 2017. 01 T 10: 00+03: 00 Source: MRF. yaml Algorithm: SHA-256 Hash: 09 e 5 a 788 acb 180162 c 51679 ae 4 c 998039 fa 6644505 db 2415 e 35107 d 1 ee 213943 Source: scripts/install. sh Algorithm: SHA-256 Hash: d 0 e 7828293355 a 07 c 2 dccaaa 765 c 80 b 507 e 60 e 6167067 c 950 dc 2 e 6 b 0 da 0 dbd 8 b Source: https: //www. vendor_org. com/MRF/v 4. 1/scripts/scale. sh Algorithm: SHA-256 Hash: 36 f 945953929812 aca 2701 b 114 b 068 c 71 bd 8 c 95 ceb 3609711428 c 26325649165 -----BEGIN CMS----MIGDBgsqhki. G 9 w 0 BCRABCa. B 0 MHICAQAw. DQYLKo. ZIhvc. NAQk. QAwgw. Xg. YJKo. ZIhvc. N AQc. Bo. FEET 3 icc 87 PK 0 n. NK 9 ENq. Sx. It. VIo. Sa 0 o 0 S/IScz. Ms 1 ZIzkgs. Kk 4 ts. Q 0 N 1 n. UM dvb 05 OXi 5 XLPLEt. Vi. Mwv. LVLw. SE 0 s. Kl. FIVHAq. Sk 3 MBkk. BAJv 0 Fx 0= -----END CMS----- References: - IANA register for Hash Function Textual Names https: //www. iana. org/assignments/hash-function-text-names. xhtml
SDC CSAR Mock-up metadata: vnf_product_name: VNF_Name vnf_provider_id: ZTE vnf_package_version: 1. 0 vnf_release_data_time: 2017. 01 T 10: 00+03: 00 source: Main. Service. Template. yaml source: Definitions/Global. Substitution. Types. Service. Template. yaml source: Artifacts/install. sh source: Artifacts/create_stack. sh source: Licenses/license. xml References: - IANA register for Hash Function Textual Names https: //www. iana. org/assignments/hash-function-text-names. xhtml 8