summaryrefslogtreecommitdiffstats
path: root/docs/files/ICE.rst
diff options
context:
space:
mode:
Diffstat (limited to 'docs/files/ICE.rst')
-rw-r--r--docs/files/ICE.rst64
1 files changed, 64 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