introduce test-kitchen
Change-Id: I4e230f4a564ead75829a9016eafd0b7ca0825086
Implements: blueprint service-level-testing
diff --git a/README.rst b/README.rst
index 8d87393..9a8bab0 100644
--- a/README.rst
+++ b/README.rst
@@ -249,3 +249,53 @@
Developers should also join the discussion on the IRC list, at:
https://wiki.openstack.org/wiki/Meetings/openstack-salt
+
+Development and testing
+=======================
+
+Development and test workflow with `Test Kitchen <http://kitchen.ci>`_ and
+`kitchen-salt <https://github.com/simonmcc/kitchen-salt>`_ provisioner plugin.
+
+Test Kitchen is a test harness tool to execute your configured code on one or more platforms in isolation.
+There is a ``.kitchen.yml`` in main directory that defines *platforms* to be tested and *suites* to execute on them.
+
+Kitchen CI can spin instances locally or remote, based on used *driver*.
+For local development ``.kitchen.yml`` defines a `vagrant <https://github.com/test-kitchen/kitchen-vagrant>`_ or
+`docker <https://github.com/test-kitchen/kitchen-docker>`_ driver.
+
+To use backend drivers or implement your CI follow the section `INTEGRATION.rst#Continuous Integration`__.
+
+A listing of scenarios to be executed:
+
+.. code-block:: shell
+
+ $ kitchen list
+
+ Instance Driver Provisioner Verifier Transport Last Action
+
+ control-cluster-ubuntu-1404 Vagrant SaltSolo Inspec Ssh <Not Created>
+ control-cluster-ubuntu-1604 Vagrant SaltSolo Inspec Ssh Set Up
+ control-cluster-centos-71 Vagrant SaltSolo Inspec Ssh <Not Created>
+ control-single-ubuntu-1404 Vagrant SaltSolo Inspec Ssh Verified
+ control-single-ubuntu-1604 Vagrant SaltSolo Inspec Ssh <Not Created>
+ control-single-centos-71 Vagrant SaltSolo Inspec Ssh <Not Created>
+
+The `Busser <https://github.com/test-kitchen/busser>`_ *Verifier* is used to setup and run tests
+implementated in `<repo>/test/integration`. It installs the particular driver to tested instance
+(`Serverspec <https://github.com/neillturner/kitchen-verifier-serverspec>`_,
+`InSpec <https://github.com/chef/kitchen-inspec>`_, Shell, Bats, ...) prior the verification is executed.
+
+
+Usage:
+
+.. code-block:: shell
+
+ # list instances and status
+ kitchen list
+
+ # manually execute integration tests
+ kitchen [test || [create|converge|verify|exec|login|destroy|...]] [instance] -t tests/integration
+
+ # use with provided Makefile (ie: within CI pipeline)
+ make kitchen
+