summaryrefslogtreecommitdiffstats
path: root/docs/index.rst
diff options
context:
space:
mode:
authorChris Donley <christopher.donley@huawei.com>2017-09-20 06:42:44 -0700
committerChris Donley <christopher.donley@huawei.com>2017-09-20 06:46:17 -0700
commit17032db43dda5fda5e8165d5e3ba8b4e9657883c (patch)
tree75e2b42c3a0661f1eab5cd0b1b09a927c72e89ef /docs/index.rst
parentbb55a8f2f59bd954fc820ce4ec42f24dc60b556a (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.rst53
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