blob: 8f28b8bc663c6069adbe081ab31dc1f17b112f8b [file] [log] [blame]
Chris Donley17032db2017-09-20 06:42:44 -07001.. This work is licensed under a Creative Commons Attribution 4.0 International License.
Chris Donley6cd6a1d2017-10-30 11:22:17 -07002.. http://creativecommons.org/licenses/by/4.0
3.. Copyright 2017 Huawei Technologies Co., Ltd.
Chris Donley17032db2017-09-20 06:42:44 -07004
Chris Donley29648052017-10-05 11:40:40 -07005VNFSDK Documentation
6====================
7
Chris Donley17032db2017-09-20 06:42:44 -07008.. toctree::
9 :maxdepth: 1
Chris Donley825678b2017-10-02 10:06:12 -070010 :titlesonly:
Chris Donley17032db2017-09-20 06:42:44 -070011
Chris Donley1e094612018-02-26 09:38:37 -080012 files/swagger.json
Chris Donley825678b2017-10-02 10:06:12 -070013 files/vnfsdk-apis
Chris Donley17032db2017-09-20 06:42:44 -070014
Chris Donley1ac02e72017-09-21 08:59:41 -070015Components
16----------
Chris Donley17032db2017-09-20 06:42:44 -070017
Eric Debeaude6efbf2017-10-14 08:06:12 +000018VNF Packaging Model/Blueprint
Chris Donleyfecfefd2017-09-22 09:25:38 -070019-----------------------------
Chris Donley1ac02e72017-09-21 08:59:41 -070020
Chris Donleya3adf072017-11-09 15:17:45 -080021VNF product model/blueprint provides a declarative way to define deployment,
22operational and functional attributes of a VNF product. The VNF product is
23defined in terms of deployment time requirements and dependencies and exposed
24telemetry indicator definitions.
Chris Donley17032db2017-09-20 06:42:44 -070025
Chris Donleya3adf072017-11-09 15:17:45 -080026The deployment time requirements and dependencies define any and all compute
27infrastructure needs of the VNF product, such as specific hardware
28architecture, on-chip features, instruction set availability and hypervisor
29capabilities.
Chris Donley17032db2017-09-20 06:42:44 -070030
Chris Donleya3adf072017-11-09 15:17:45 -080031The telemetry indicator definitions define a set of default indicators exposed
32by a given VNF product for use by monitoring and assurance tools. This list
33can be extended and customized once a given VNF product is on-boarded and
34instantiated at run-time.
Chris Donley17032db2017-09-20 06:42:44 -070035
Chris Donleya3adf072017-11-09 15:17:45 -080036The VNF product model is specified using the TOSCA NFV simple profile. It is
37persisted, along with the product executables and data, using TOSCA CSAR files.
Chris Donley17032db2017-09-20 06:42:44 -070038
Chris Donley825678b2017-10-02 10:06:12 -070039.. toctree::
40 :maxdepth: 1
41 :titlesonly:
Chris Donley29648052017-10-05 11:40:40 -070042 :glob:
Chris Donley825678b2017-10-02 10:06:12 -070043
Chris Donley29648052017-10-05 11:40:40 -070044 files/pkgtool
45 files/*blueprints
Chris Donley825678b2017-10-02 10:06:12 -070046
Chris Donleydbf7fb12017-10-06 16:45:44 -070047VNF SDK Marketplace
48-------------------
Chris Donley2edcb8b2017-10-10 11:20:43 -070049
50.. include:: files/marketplace-overview.rst
51
52Installation instructions
53-------------------------
54
Chris Donleydbf7fb12017-10-06 16:45:44 -070055.. toctree::
56 :maxdepth: 1
57
Chris Donley2edcb8b2017-10-10 11:20:43 -070058 files/mktplace-install
Chris Donleydbf7fb12017-10-06 16:45:44 -070059
Eric Debeaude6efbf2017-10-14 08:06:12 +000060VNF SDK Tools
Chris Donleyfecfefd2017-09-22 09:25:38 -070061-------------
Chris Donley1ac02e72017-09-21 08:59:41 -070062
Chris Donleya3adf072017-11-09 15:17:45 -080063VNF SDK tools provide VNF product DevOps engineers with command line tools and
64client side API language bindings to define the VNF product model and package
65content. The following tools are included...
Chris Donley17032db2017-09-20 06:42:44 -070066
Chris Donleya3adf072017-11-09 15:17:45 -080067• VNF Package Builder - creates a CSAR file based on inputs provided by the VNF
Chris Donley24d831b2017-11-15 09:57:25 -080068 product DevOps engineer
69
Chris Donleya3adf072017-11-09 15:17:45 -080070• VNF Package Validator - validates the content of the VNF packages to ensure
Chris Donley24d831b2017-11-15 09:57:25 -080071 that everything has been built correctly
72
Chris Donleya3adf072017-11-09 15:17:45 -080073• VNF Package Extractor - extracts VNF product model and executables from the
Chris Donley24d831b2017-11-15 09:57:25 -080074 CSAR file
75
Chris Donleya3adf072017-11-09 15:17:45 -080076• VNF Package Parser - translates VNF proeduct blueprint into a format
Chris Donley24d831b2017-11-15 09:57:25 -080077 consumable by ONAP components
78
Chris Donleya3adf072017-11-09 15:17:45 -080079• VNF Package Dry Run - performs a "dry run" install to ensure that the package
Chris Donley24d831b2017-11-15 09:57:25 -080080 can be deployed during instantiation
Chris Donley17032db2017-09-20 06:42:44 -070081
Chris Donley17032db2017-09-20 06:42:44 -070082
Chris Donleyfecfefd2017-09-22 09:25:38 -070083User Guides
Eric Debeaude6efbf2017-10-14 08:06:12 +000084-----------
Chris Donley1ac02e72017-09-21 08:59:41 -070085
Eric Debeaude6efbf2017-10-14 08:06:12 +000086VNF Package Tools User Guide
Chris Donleyfecfefd2017-09-22 09:25:38 -070087----------------------------
Chris Donley17032db2017-09-20 06:42:44 -070088
Chris Donleya3adf072017-11-09 15:17:45 -080089VNF Package Designer, provides VNF product DevOps engineers with a graphical
90tool to define the VNF product model and package content. It is made available
91as part of the VNF Supplier SDK tools.The package designer makes use of the VNF
92SDK command line interfaces (CLIs) and client-side API language bindings in
93order to define the model and the package content. As such, it is functionally
94equivalent to the VNF SDK tools.
Chris Donley17032db2017-09-20 06:42:44 -070095
Chris Donley825678b2017-10-02 10:06:12 -070096.. toctree::
97 :maxdepth: 1
98 :titlesonly:
Chris Donley29648052017-10-05 11:40:40 -070099 :glob:
Chris Donley825678b2017-10-02 10:06:12 -0700100
Chris Donley29648052017-10-05 11:40:40 -0700101 files/*Bundling*
Chris Donley825678b2017-10-02 10:06:12 -0700102
Eric Debeaude6efbf2017-10-14 08:06:12 +0000103Marketplace User Guide for Operators
Chris Donleyfecfefd2017-09-22 09:25:38 -0700104------------------------------------
Chris Donley17032db2017-09-20 06:42:44 -0700105
Chris Donleydbf7fb12017-10-06 16:45:44 -0700106.. toctree::
107 :maxdepth: 1
108 :titlesonly:
109
110 files/VNFSDK-Marketplace-userguide-operators
Chris Donley17032db2017-09-20 06:42:44 -0700111
Eric Debeaude6efbf2017-10-14 08:06:12 +0000112Marketplace User Guide for VNF Suppliers
Chris Donleyfecfefd2017-09-22 09:25:38 -0700113----------------------------------------
Chris Donley17032db2017-09-20 06:42:44 -0700114
Chris Donleydbf7fb12017-10-06 16:45:44 -0700115.. toctree::
116 :maxdepth: 1
117 :titlesonly:
118
119 files/VNFSDK-Marketplace-userguide-vendors
120
Chris Donley6cd6a1d2017-10-30 11:22:17 -0700121VES Client Guidelines
122---------------------
123
124.. toctree::
125 :maxdepth: 1
126 :titlesonly:
127
128 files/VESEventRegistration
129 files/VESEventListener
brucetciscobfd600e2018-03-01 10:39:51 -0600130
131VNF Certification Testing Framework - Dovetail
132----------------------------------------------
133
134.. toctree::
135 :maxdepth: 1
136 :titlesonly:
137
138 files/Dovetail