Document the requirements for running ZeroMQ-based integration tests

This commit is contained in:
Denys Havrysh 2016-12-10 22:16:18 +02:00
parent 7596313be0
commit e9f419ff64
2 changed files with 45 additions and 1 deletions

View file

@ -45,7 +45,7 @@ sent through the started daemons.
Integration tests are particularly good at testing modules, states, and
shell commands, among other segments of Salt's ecosystem. By utilizing
the integration test daemons, integration tests are easy to write. They
are also SaltStack's gerneally preferred method of adding new tests.
are also SaltStack's generally preferred method of adding new tests.
The discussion in the :ref:`Integration vs. Unit <integration-vs-unit>`
section of the :ref:`testing tutorial <tutorial-salt-testing>` is
@ -88,6 +88,28 @@ the lines below, depending on the relevant Python version:
pip install -r requirements/dev_python26.txt
pip install -r requirements/dev_python27.txt
To be able to run integration tests which utilizes ZeroMQ transport, you also
need to install additional requirements for it. Make sure you have installed
the C compiler and development libraries and header files needed for your
Python version.
This is an example for RedHat-based operating systems:
.. code-block:: bash
yum install gcc python-devel
pip install -r requirements/zeromq.txt
On Debian, Ubuntu or their derivatives run the following commands:
.. code-block:: bash
apt-get install build-essential python-dev
pip install -r requirements/zeromq.txt
This will install the latest ``pycrypto`` and ``pyzmq`` (with bundled
``libzmq``) Python modules required for running integration tests suite.
.. note::
In Salt 0.17, testing libraries were migrated into their own repo. To install them:

View file

@ -42,6 +42,28 @@ depending on your relevant version of Python:
pip install -r requirements/dev_python26.txt
pip install -r requirements/dev_python27.txt
To be able to run integration tests which utilizes ZeroMQ transport, you also
need to install additional requirements for it. Make sure you have installed
the C compiler and development libraries and header files needed for your
Python version.
This is an example for RedHat-based operating systems:
.. code-block:: bash
yum install gcc python-devel
pip install -r requirements/zeromq.txt
On Debian, Ubuntu or their derivatives run the following commands:
.. code-block:: bash
apt-get install build-essential python-dev
pip install -r requirements/zeromq.txt
This will install the latest ``pycrypto`` and ``pyzmq`` (with bundled
``libzmq``) Python modules required for running integration tests suite.
Test Directory Structure
========================