Project

Profile

Help

Task #4376

closed

Add docs for running molecule tests locally

Added by amacdona@redhat.com about 5 years ago. Updated over 4 years ago.

Status:
CLOSED - CURRENTRELEASE
Priority:
Normal
Category:
-
Sprint/Milestone:
Start date:
Due date:
% Done:

0%

Estimated time:
Platform Release:
Groomed:
No
Sprint Candidate:
No
Tags:
Dev Environment, Documentation
Sprint:
Sprint 50
Quarter:

Description

When the ansible-pulp3 molecule tests fail on travis, the error message is rarely helpful.

The way that I test list locally is to pip install molecule into a virtualenvironment (on my machine, not the vm).

`molecule test --all` runs all scenarios (right now, this is "default" and "source")
`molecule test --scenario-name source` only tests the source installation

`molecule test` actually runs a collection of tasks, (create, prepare, converge, idempotence, test, delete, etc)

if our playbooks fail to run correctly, `molecule converge` only runs a subset (create, prepare, converge) so the tests don't need to run so long.

Any of these can include `--debug`, as in `molecule --debug test` to retrieve a more helpful error message. However, it is best to do this on only a subset because --debug is extremely verbose.

Also available in: Atom PDF