| |
@@ -0,0 +1,57 @@
|
| |
+ :toc:
|
| |
+
|
| |
+ = Test Management Tool =
|
| |
+
|
| |
+ == Summary ==
|
| |
+
|
| |
+ The `tmt` tool aims to provide an efficient and comfortable way to create, execute, debug and enable tests in the Continuous Integration.
|
| |
+
|
| |
+ It implements the https://tmt.readthedocs.io/en/latest/spec.html[Test Metadata Specification] which allows to store all needed test execution data directly within a git repository.
|
| |
+ The same configuration can be used for enabling tests in the Fedora CI (near future), RHEL CI and https://packit.dev/[Packit].
|
| |
+ Tests can be easily executed in your preferred environment, e.g. in virtual machine, container or directly on the localhost.
|
| |
+
|
| |
+ == Examples ==
|
| |
+
|
| |
+ Enable basic smoke test for my component:
|
| |
+
|
| |
+ dnf install -y tmt
|
| |
+ tmt init --template mini
|
| |
+ vim plans/example.fmf
|
| |
+ git add . && git commit -m tests && git push
|
| |
+
|
| |
+ Create a new test based on a shell/beakerlib template:
|
| |
+
|
| |
+ tmt test create --template shell tests/basic
|
| |
+ tmt test create --template beakerlib tests/advanced
|
| |
+
|
| |
+ Run all/selected tests safely in a virtual machine:
|
| |
+
|
| |
+ tmt run
|
| |
+ tmt run test --name smoke
|
| |
+
|
| |
+ Execute tests in my preferred environment:
|
| |
+
|
| |
+ tmt run --all provision --how container
|
| |
+ tmt run --all provision --how virtual
|
| |
+ tmt run --all provision --how local
|
| |
+ tmt run --all provision --how ...
|
| |
+
|
| |
+ See the tmt https://tmt.readthedocs.io/en/latest/examples.html[examples] page for more inspiration.
|
| |
+
|
| |
+ == Links ==
|
| |
+
|
| |
+ * https://tmt.readthedocs.io/
|
| |
+ * https://packit.dev/testing-farm/
|
| |
+
|
| |
+ == Questions ==
|
| |
+
|
| |
+ Does the tool replace/deprecate STI?::
|
| |
+ No, currently there is no plan to decommission STI.
|
| |
+ Both `tmt` and `sti` approach to CI configuration can be used in parallel.
|
| |
+
|
| |
+ Are these tests supported in Fedora CI?::
|
| |
+ Fedora CI support is coming in July/August 2020.
|
| |
+
|
| |
+ Which Linux distributions does the tool support?::
|
| |
+ As a system under test (on which the tests are executed) all supported Fedora versions, Centos 6+ and Red Hat Enterprise Linux 6+ can be used.
|
| |
+ For the test runner (where tmt command is run) all supported Fedora versions, Centos 8+ or Red Hat Enterprise Linux 8+ are required.
|
| |
Just a basic kick-off of the page with some basic content and links.