summaryrefslogtreecommitdiffstats
path: root/docs/validation-scripts.rst
diff options
context:
space:
mode:
authorstark, steven <steven.stark@att.com>2018-10-02 12:39:27 -0700
committerstark, steven <steven.stark@att.com>2018-10-02 12:39:27 -0700
commit7306a2b43b75a4db5d21f95d9bd96ea7d59a50cf (patch)
treeeee73ffe140aab5c63158d611a3be2b3b6278812 /docs/validation-scripts.rst
parent6dee9df5bf854047df8b1c0944dad13f77d0c9ee (diff)
[VVP] update VVP documentation
update the documentation and release notes Change-Id: I3dba97ff17119b90de119ba0a3e4a2aa41a05fd4 Issue-ID: VVP-110 Signed-off-by: stark, steven <steven.stark@att.com>
Diffstat (limited to 'docs/validation-scripts.rst')
-rw-r--r--docs/validation-scripts.rst113
1 files changed, 113 insertions, 0 deletions
diff --git a/docs/validation-scripts.rst b/docs/validation-scripts.rst
new file mode 100644
index 0000000..0ff6e32
--- /dev/null
+++ b/docs/validation-scripts.rst
@@ -0,0 +1,113 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. Copyright 2018 AT&T Intellectual Property. All rights reserved.
+
+Manual Heat Template Validation
+===============================
+
+validation-scripts
+------------------
+
+This project contains validation scripts to test
+that a set of Heat Templates adheres to
+the ONAP VNF Heat Orchestration Template guidelines.
+
+For more information on the ONAP Heat Orchestration
+Template Guidelines, vist the `Heat Guidelines <https://onap.readthedocs.io/en/latest/submodules/vnfrqts/requirements.git/docs/Chapter5/Heat/index.html>`__
+
+About
+_____
+
+The validation scripts project allows performing heat template
+validation without installing the full VVP platform. The following
+instructions apply to running these validation scripts in that manner.
+
+
+Installation
+____________
+
+This software is not platform dependent and can be run in a Windows, Unix or
+OS X environment.
+
+Satisfy Dependencies
+####################
+
+
+ These can be installed using pip (assuming pip is installed) with the command:
+
+``$ pip install -r requirements.txt``
+
+Use
+___
+
+Clone this project.
+
+To validate Heat templates just run this the command under the folder ``ice_validator``:
+
+``</path/to/validation-scripts/ice_validator>$ pytest --tap-stream --template-directory=<Directory>``
+
+where ``<Directory>`` is the full path to a folder containing heat templates.
+
+Output
+______
+
+After performing a validation, an output folder will be created.
+
+``/path/to/validation-scripts/ice_validator/output/``
+
+This folder will contain a file ``report.html`` which contains a list of all
+of the ONAP VNF Heat Template Guideline violations. If there are no violations,
+the report will say ``No validation errors found.``
+
+Interpreting the Output
+_______________________
+
+The report file will have 4 columns for details about a violation, and one
+row for each violation. Below contains details about each column.
+
+File
+####
+
+This is the file(s) that contained the violation
+
+Error Message
+#############
+
+This shows the test and brief error message from the validation script that
+contained the violation. There is a ``Full Details`` button to show the
+complete raw test output. The error message will also contain details
+about what element is involved with the violation (such as the parameter
+name, resource id, etc...).
+
+Requirement(s)
+##############
+
+This column contains the requirement(s) that each test/violation is
+mapped to. These requirements are taken directly from the VNF Requirements
+project Heat Orchestration Template Guidelines section.
+
+
+Resolution Steps
+################
+
+For some violations, there are pre-defined resolution steps that
+indicate what action the user should take to resolve the violation.
+
+**Note**: Not all violations will have resolution steps. Most violations
+can be resolved simply by reviewing the requirements that have been violated
+in the previous column.
+
+
+Self-Test Suite
+_______________
+
+The ``ice_validator`` includes an extensive self-test suite. It is a
+**requirement** for any additions or changes to the test suite to
+successfully and cleanly complete a tox run. Simply run ``tox`` from
+the project root as:
+
+``$ tox``
+
+You can also run it under the folder ``ice_validator``:
+
+``$ pytest --self-test``