Zen

Translation

English type: Plain text
ansible-playbook --tags=classic tests.yml
43/430 · 43

Sign in to save the translation.

English French Actions
Output of the test (such as the stdout/stderr output, log files or screenshots) is by default saved in the `artifacts` directory. Use `TEST_ARTIFACTS` environment variable to choose a different location if desired:
 
export TEST_ARTIFACTS=/tmp/artifacts
 
*Artifacts cleanup* +
Before running tests make sure that all logs `/tmp/artifacts/test.*` are deleted.
 
Inventory
 
A _test subject_ is what we call the thing to be tested. To turn a test subject into a launched, installed system to be tested, we use http://docs.ansible.com/ansible/intro_dynamic_inventory.html[Ansible dynamic inventory]. Use the following command to enable it:
 
export ANSIBLE_INVENTORY=$(test -e inventory && echo inventory || echo /usr/share/ansible/inventory)
 
As you can see from the way how the inventory is set, tests may contain their own inventory, which defines their own instructions for turning a _test subject_ into one or more testable systems.
 
Testing
 
Classic
Classique
You can always invoke the tests locally. Many tests modify or change the system they are run against, so take that into account when looking at how to invoke tests. The following examples invoke tests against the same system that the package git repository is checked out on. Below there are further options for invoking tests against another fully formed and integrated systems, such as an Atomic Host or container image _test subject_.
 
There may be more than one test present in a package git repository. Testing system will run each playbook matching the glob `tests/tests*.yml` separately in a clean environment. Most often a single `tests.yml` file is used as the main entry point. To run it use the following command:
 
ansible-playbook tests.yml
 
You can find output artifacts of the tests in an `artifacts/` or specify a specific directory like this:
 
TEST_ARTIFACTS=/tmp/output ansible-playbook tests.yml
 
You can filter which kinds of tests are run by providing a `--tags` argument. To only run tests that are suited for classic systems installed by `yum` or `dnf` you can use a command like:
 
ansible-playbook --tags=classic tests.yml
ansible-playbook --tags=classic tests.yml
When run by a CI System the tests are invoked according to the xref:standard-test-interface.adoc[Standard Test Interface]. Look here for more details and standard invocation variables.
 
Package
 
When you run the tests as above, the tests assume that the system to be tested is the same as the system invoking the tests. In particular, the test assumes that the thing to be tested is already installed.
 
A _test subject_ is what we call the thing to be tested. RPMs are a particular kind of _test subject_. To turn a test subject into a launched, installed system to be tested, we use http://docs.ansible.com/ansible/intro_dynamic_inventory.html[Ansible dynamic inventory]. Let's invoke the tests with an inventory and a specific version of gzip:
 
curl -o gzip.rpm https://kojipkgs.fedoraproject.org//packages/gzip/1.8/2.fc26/x86_64/gzip-1.8-2.fc26.x86_64.rpm
export TEST_SUBJECTS=$PWD/gzip.rpm
ansible-playbook tests.yml
 
You'll notice that the RPM is installed into the testable system before invoking the tests. Some tests contain their own inventory, that is their own instructions for turning a _test subject_ into one or more testable systems. But in this case we use the default `standard-test-roles` inventory in `/usr/share/ansible/inventory` to do this.
 
Container
Conteneur
Another example is to use a _test subject_ of a container image. This is also a fully formed and integrated deliverable. The _test subject_ again represents the thing to be tested. For testing containers there is an additional dependency needed:
 
sudo dnf install standard-test-roles-inventory-docker
sudo dnf install standard-test-roles-inventory-docker
The container image is pulled from a registry and launched using docker by an http://docs.ansible.com/ansible/intro_dynamic_inventory.html[Ansible dynamic inventory].
 
export TEST_SUBJECTS=docker:docker.io/library/fedora:27
ansible-playbook --tags=container tests.yml
 
If you watch closely you'll notice the image is pulled if not already local, launched as a container, and then prepared for the tests to run on. The first time this may take a little longer. Not all tests are able to function in the somewhat different environment of a container. In fact, for certain tests, the software to be tested may not be included in the container. But many of the tests for core packages should work here.
 
The `--tags` argument filters out tests that are not suitable for running in a container, either because the system functions differently, or the correct packages are not installable.
 
See the <<_debug>> section for instructions how to log into a running container and diagnose why the tests failed.
 
Additional arguments for Docker
 

Loading…

User avatar grimst

Translation added
ansible-playbook --tags=classic tests.yml
ansible-playbook --tags=classic tests.yml
a year ago
User avatar grimst

Contributor joined
Contributor joined a year ago
Browse all string changes

Things to check

Unchanged translation

Source and translation are identical

Reset

Glossary

English French
No related strings found in the glossary.

797589 String information

Source string description
type: Plain text
Flags
no-wrap
Source string location
pages/standard-test-roles.adoc:68
String age
4 years ago
Last updated
a year ago
Source string age
4 years ago
Translation file
po/fr/master/pages/standard-test-roles.po, string 25