diff --git a/tests/README.md b/tests/README.md index 2e12bd4b572e24df90e7f64fb272b042ceb68596..d187575e3987b72d88df82104083b4fc920088ed 100644 --- a/tests/README.md +++ b/tests/README.md @@ -2,11 +2,9 @@ ## Before starting -In order to run ansible-freeipa tests you will need to have `ansible` and `pytest` -installed on your machine. We'll call this local machine `controller`. +In order to run ansible-freeipa tests you will need to have `ansible` and `pytest` installed on your machine. We'll call this local machine `controller`. -You will also need to have a remote host with freeipa server installed and configured. -We'll call this remote host `ipaserver`. +You will also need to have a remote host with freeipa server installed and configured. We'll call this remote host `ipaserver`. Some other requirements: @@ -19,27 +17,32 @@ Some other requirements: ## Running the tests To run the tests run: + ``` IPA_SERVER_HOST=<ipaserver_host_or_ip> pytest ``` If you need to run using a different user you can use `ANSIBLE_REMOTE_USER` environment variable. For example: + ``` ANSIBLE_REMOTE_USER=root IPA_SERVER_HOST=<ipaserver_host_or_ip> pytest ``` To select which tests to run use the option `-k`. For example: + ``` IPA_SERVER_HOST=<ipaserver_host_or_ip> pytest -k dnszone ``` To see the ansible output use the option `--capture=sys`. For example: + ``` IPA_SERVER_HOST=<ipaserver_host_or_ip> pytest --capture=sys ``` To see why tests were skipped use `-rs`. For example: + ``` IPA_SERVER_HOST=<ipaserver_host_or_ip> pytest -rs ``` @@ -52,3 +55,4 @@ For a complete list of options check `pytest --help`. * A script to pre-config the complete test environment using virsh. * A test matrix to run tests against different distros in parallel (probably using tox). * Allow to connect to `ipaserver` using ssh and password. +