summaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorMickael JEZEQUEL <mickael.jezequel@orange.com>2018-05-29 16:35:04 +0200
committerMickael JEZEQUEL <mickael.jezequel@orange.com>2018-05-29 14:56:20 +0000
commit3ec68d7822417204c238be2647489f4f13b46a2d (patch)
treee87c48cd22f60740280936c0b97efbbf326a13f4 /docs
parenta6c38d3e6ca96ab7ac4fddb89c043e727388e372 (diff)
Add ICE documentation
Change-Id: Ie735d3dcd1abf97a8c8f09a63306d79428ba7d90 Issue-ID: VNFSDK-214 Signed-off-by: Mickael JEZEQUEL <mickael.jezequel@orange.com>
Diffstat (limited to 'docs')
-rw-r--r--docs/files/ICE.rst64
-rw-r--r--docs/files/ice-report.pngbin0 -> 43266 bytes
-rw-r--r--docs/index.rst10
3 files changed, 74 insertions, 0 deletions
diff --git a/docs/files/ICE.rst b/docs/files/ICE.rst
new file mode 100644
index 0000000..a3ba77e
--- /dev/null
+++ b/docs/files/ICE.rst
@@ -0,0 +1,64 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. Copyright 2018 Orange Labs.
+
+ICE validation scripts
+======================
+
+The ICE validation scripts are based on the python ``pytest`` tool.
+These scripts check that the Heat Templates are compliant with the ONAP Heat Template Guidelines.
+
+Installation
+------------
+
+This software is not platform dependent and can be run in a Windows, Unix or
+OS X environment.
+
+- Install python 2.7 or python 3
+- Install pip
+
+In addition to python, this project requires the following packages:
+
+- pytest
+- PyYAML
+
+Depending on the desired output format, you should add the following optional packages:
+
+- pytest-tap
+- pytest-html
+
+These can be installed using pip (assuming pip is installed) with the command:
+
+``$ pip install pytest PyYAML pytest-tap pytest-html``
+
+Usage
+-----
+
+Retrieve the ICE scripts, by cloning the sources:
+
+``$ git clone https://git.onap.org/vnfsdk/ice``
+
+Go into the ice_validator directory:
+
+``$ cd ice/validation-scripts/ice_validator``
+
+The Heat templates validation may generate different ouput format (plain, tap, html):
+
+- plain format
+
+``$ pytest --template-directory=<Directory>``
+
+- tap format
+
+``$ pytest --tap-stream --template-directory=<Directory>``
+
+- html format
+
+``$ pytest --html=/path/to/report.html --template-directory=<Directory>``
+
+NB: ``<Directory>`` is the absolute path of the folder containing the Heat
+Templates to be verified.
+
+.. image:: ./ice-report.png
+
+Figure 1: example of html report generated by ICE scripts
diff --git a/docs/files/ice-report.png b/docs/files/ice-report.png
new file mode 100644
index 0000000..74f6e98
--- /dev/null
+++ b/docs/files/ice-report.png
Binary files differ
diff --git a/docs/index.rst b/docs/index.rst
index a16fd09..af04833 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -137,3 +137,13 @@ VNF Certification Testing Framework - Dovetail
:titlesonly:
files/Dovetail
+
+ICE tools for HEAT validation
+-----------------------------
+
+.. toctree::
+ :maxdepth: 1
+ :titlesonly:
+
+ files/ICE
+