2025-03-14 21:59:59 -06:00
|
|
|
# tmt run
|
|
|
|
|
|
2025-12-16 10:20:31 -07:00
|
|
|
> Execute `tmt` test steps. By default, all steps are run.
|
|
|
|
|
> More information: <https://tmt.readthedocs.io/en/stable/stories/cli.html#run>.
|
2025-03-14 21:59:59 -06:00
|
|
|
|
|
|
|
|
- Run all test steps for each plan:
|
|
|
|
|
|
|
|
|
|
`tmt run`
|
|
|
|
|
|
|
|
|
|
- Run only the discover step to show what tests would be run:
|
|
|
|
|
|
2025-12-16 10:20:31 -07:00
|
|
|
`tmt run discover {{[-v|--verbose]}}`
|
2025-03-14 21:59:59 -06:00
|
|
|
|
|
|
|
|
- Run all steps and adjust the provision step options:
|
|
|
|
|
|
2025-12-16 10:20:31 -07:00
|
|
|
`tmt run {{[-a|--all]}} provision {{[-h|--how]}} {{container}} {{[-i|--image]}} {{fedora:rawhide}}`
|
2025-03-14 21:59:59 -06:00
|
|
|
|
|
|
|
|
- Run only selected plans and tests:
|
|
|
|
|
|
2025-12-16 10:20:31 -07:00
|
|
|
`tmt run plan {{[-n|--name]}} {{/plan/name}} test {{[-n|--name]}} {{/test/name}}`
|
2025-03-14 21:59:59 -06:00
|
|
|
|
|
|
|
|
- Show results from the last run in a web browser:
|
|
|
|
|
|
2025-12-16 10:20:31 -07:00
|
|
|
`tmt run {{[-l|--last]}} report {{[-h|--how]}} {{html}} {{[-o|--open]}}`
|
2025-03-14 21:59:59 -06:00
|
|
|
|
|
|
|
|
- Run tests with the provided context:
|
|
|
|
|
|
2025-12-16 10:20:31 -07:00
|
|
|
`tmt run {{[-c|--context]}} {{key=value}} {{[-c|--context]}} {{distro=fedora}}`
|
2025-03-14 21:59:59 -06:00
|
|
|
|
|
|
|
|
- Run tests interactively (debug test code in the middle of a test):
|
|
|
|
|
|
2025-12-16 10:20:31 -07:00
|
|
|
`tmt run {{[-a|--all]}} execute {{[-h|--how]}} {{tmt}} --interactive`
|
2025-03-14 21:59:59 -06:00
|
|
|
|
|
|
|
|
- Use dry mode to see what actions would happen and use the highest verbosity:
|
|
|
|
|
|
2025-12-16 10:20:31 -07:00
|
|
|
`tmt run {{[-n|--dry]}} {{[-vvv|--verbose --verbose --verbose]}}`
|