diff options
author | Chris Donley <christopher.donley@huawei.com> | 2017-09-20 06:42:44 -0700 |
---|---|---|
committer | Chris Donley <christopher.donley@huawei.com> | 2017-09-20 06:46:17 -0700 |
commit | 17032db43dda5fda5e8165d5e3ba8b4e9657883c (patch) | |
tree | 75e2b42c3a0661f1eab5cd0b1b09a927c72e89ef /docs/index.rst | |
parent | bb55a8f2f59bd954fc820ce4ec42f24dc60b556a (diff) |
adding initial documentation
Adding rough-draft outline plus api docs.
Issue-ID: VNFSDK-95
Change-Id: Icfa4ab711b7e22d13f2bf3b540610ff82d24bff6
Signed-off-by: Chris Donley <christopher.donley@huawei.com>
Diffstat (limited to 'docs/index.rst')
-rw-r--r-- | docs/index.rst | 53 |
1 files changed, 53 insertions, 0 deletions
diff --git a/docs/index.rst b/docs/index.rst new file mode 100644 index 0000000..ec64377 --- /dev/null +++ b/docs/index.rst @@ -0,0 +1,53 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. + +.. toctree:: + :maxdepth: 1 + + vnfsdk-apis + + +# Documentation Outline + +API Documentation +# Components + +VNF Packaging Model/Blueprint +----------------------------- +VNF product model/blueprint provides a declarative way to define deployment, operational and functional attributes of a VNF product. The VNF product is defined in terms of deployment time requirements and dependencies and exposed telemetry indicator definitions. + +The deployment time requirements and dependencies define any and all compute infrastructure needs of the VNF product, such as specific hardware architecture, on-chip features, instruction set availability and hypervisor capabilities. + +The telemetry indicator definitions define a set of default indicators exposed by a given VNF product for use by monitoring and assurance tools. This list can be extended and customized once a given VNF product is on-boarded and instantiated at run-time. + +The VNF product model is specified using the TOSCA NFV simple profile. It is persisted, along with the product executables and data, using TOSCA CSAR files. + +# VNF SDK Tools +VNF SDK tools provide VNF product DevOps engineers with command line tools and client side API language bindings to define the VNF product model and package content. The following tools are included... + +• VNF Package Builder - creates a CSAR file based on inputs provided by the VNF product DevOps engineer + +• VNF Package Validator - validates the content of the VNF packages to ensure that everything has been built correctly + +• VNF Package Extractor - extracts VNF product model and executables from the CSAR file + +• VNF Package Parser - translates VNF proeduct blueprint into a format consumable by OPEN-O components + +• VNF Package Dry Run - performs a "dry run" install to ensure that the package can be deployed during instantiation + +# VNF Validation Tests + +TBD + +# User Guides + + ## VNF Package Tools User Guide + +VNF Package Designer, provides VNF product DevOps engineers with a graphical tool to define the VNF product model and package content. It is made available as part of the VNF Supplier SDK tools.The package designer makes use of the VNF SDK command line interfaces (CLIs) and client-side API language bindings in order to define the model and the package content. As such, it is functionally equivalent to the VNF SDK tools. + + ## Marketplace User Guide for Operators + +TBD + + ## Marketplace User Guide for VNF Suppliers + +TBD |