From 3ecb698de11a04e65157d92d4a68e1c00370bf26 Mon Sep 17 00:00:00 2001 From: ♪ I'm a bot, bot, bot ♪ <_update_docs_trans@sundries01.phx2.fedoraproject.org> Date: Aug 07 2020 22:30:06 +0000 Subject: automatic update of pot/po files --- diff --git a/pot/master/antora.yml.pot b/pot/master/antora.yml.pot index a200235..f87220b 100644 --- a/pot/master/antora.yml.pot +++ b/pot/master/antora.yml.pot @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"POT-Creation-Date: 2020-08-06 22:23+0000\n" +"POT-Creation-Date: 2020-08-07 22:24+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" diff --git a/pot/master/nav.pot b/pot/master/nav.pot index 98d9c5d..0f8b1b4 100644 --- a/pot/master/nav.pot +++ b/pot/master/nav.pot @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"POT-Creation-Date: 2020-08-06 22:23+0000\n" +"POT-Creation-Date: 2020-08-07 22:24+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" diff --git a/pot/master/pages/examples.pot b/pot/master/pages/examples.pot index d4dc9f5..3732edf 100644 --- a/pot/master/pages/examples.pot +++ b/pot/master/pages/examples.pot @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"POT-Creation-Date: 2020-08-06 22:23+0000\n" +"POT-Creation-Date: 2020-08-07 22:24+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" diff --git a/pot/master/pages/faq.pot b/pot/master/pages/faq.pot index c6efc17..0895ccb 100644 --- a/pot/master/pages/faq.pot +++ b/pot/master/pages/faq.pot @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"POT-Creation-Date: 2020-08-06 22:23+0000\n" +"POT-Creation-Date: 2020-08-07 22:24+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" diff --git a/pot/master/pages/gating.pot b/pot/master/pages/gating.pot index 80a60db..a414907 100644 --- a/pot/master/pages/gating.pot +++ b/pot/master/pages/gating.pot @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"POT-Creation-Date: 2020-08-06 22:23+0000\n" +"POT-Creation-Date: 2020-08-07 22:24+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" diff --git a/pot/master/pages/how-to-add-dist-git-test.pot b/pot/master/pages/how-to-add-dist-git-test.pot index 0e4df96..8618d82 100644 --- a/pot/master/pages/how-to-add-dist-git-test.pot +++ b/pot/master/pages/how-to-add-dist-git-test.pot @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"POT-Creation-Date: 2020-08-06 22:23+0000\n" +"POT-Creation-Date: 2020-08-07 22:24+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" diff --git a/pot/master/pages/index.pot b/pot/master/pages/index.pot index be016d1..f06db40 100644 --- a/pot/master/pages/index.pot +++ b/pot/master/pages/index.pot @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"POT-Creation-Date: 2020-08-06 22:23+0000\n" +"POT-Creation-Date: 2020-08-07 22:24+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" diff --git a/pot/master/pages/jenkins.pot b/pot/master/pages/jenkins.pot index 512ce1f..7d9c54c 100644 --- a/pot/master/pages/jenkins.pot +++ b/pot/master/pages/jenkins.pot @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"POT-Creation-Date: 2020-08-06 22:23+0000\n" +"POT-Creation-Date: 2020-08-07 22:24+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" diff --git a/pot/master/pages/manifesto.pot b/pot/master/pages/manifesto.pot index ad1cd04..0acaede 100644 --- a/pot/master/pages/manifesto.pot +++ b/pot/master/pages/manifesto.pot @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"POT-Creation-Date: 2020-08-06 22:23+0000\n" +"POT-Creation-Date: 2020-08-07 22:24+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" diff --git a/pot/master/pages/pipeline.pot b/pot/master/pages/pipeline.pot index b73340d..e80cb9f 100644 --- a/pot/master/pages/pipeline.pot +++ b/pot/master/pages/pipeline.pot @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"POT-Creation-Date: 2020-08-06 22:23+0000\n" +"POT-Creation-Date: 2020-08-07 22:24+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" diff --git a/pot/master/pages/pull-requests.pot b/pot/master/pages/pull-requests.pot index ebf9b2e..21e6083 100644 --- a/pot/master/pages/pull-requests.pot +++ b/pot/master/pages/pull-requests.pot @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"POT-Creation-Date: 2020-08-06 22:23+0000\n" +"POT-Creation-Date: 2020-08-07 22:24+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" diff --git a/pot/master/pages/quick-start-guide.pot b/pot/master/pages/quick-start-guide.pot index 76051a0..fc832aa 100644 --- a/pot/master/pages/quick-start-guide.pot +++ b/pot/master/pages/quick-start-guide.pot @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"POT-Creation-Date: 2020-08-06 22:23+0000\n" +"POT-Creation-Date: 2020-08-07 22:24+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" diff --git a/pot/master/pages/rebuild-container-image.pot b/pot/master/pages/rebuild-container-image.pot index b79e8dc..dd800dd 100644 --- a/pot/master/pages/rebuild-container-image.pot +++ b/pot/master/pages/rebuild-container-image.pot @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"POT-Creation-Date: 2020-08-06 22:23+0000\n" +"POT-Creation-Date: 2020-08-07 22:24+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" diff --git a/pot/master/pages/share-test-code.pot b/pot/master/pages/share-test-code.pot index ef4f45e..302e2da 100644 --- a/pot/master/pages/share-test-code.pot +++ b/pot/master/pages/share-test-code.pot @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"POT-Creation-Date: 2020-08-06 22:23+0000\n" +"POT-Creation-Date: 2020-08-07 22:24+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" diff --git a/pot/master/pages/source-git.pot b/pot/master/pages/source-git.pot index f80048c..9ee624b 100644 --- a/pot/master/pages/source-git.pot +++ b/pot/master/pages/source-git.pot @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"POT-Creation-Date: 2020-08-06 22:23+0000\n" +"POT-Creation-Date: 2020-08-07 22:24+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" diff --git a/pot/master/pages/standard-test-interface.pot b/pot/master/pages/standard-test-interface.pot index 7c16201..258f280 100644 --- a/pot/master/pages/standard-test-interface.pot +++ b/pot/master/pages/standard-test-interface.pot @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"POT-Creation-Date: 2020-08-06 22:23+0000\n" +"POT-Creation-Date: 2020-08-07 22:24+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" diff --git a/pot/master/pages/standard-test-roles.pot b/pot/master/pages/standard-test-roles.pot index a98199d..2cf076b 100644 --- a/pot/master/pages/standard-test-roles.pot +++ b/pot/master/pages/standard-test-roles.pot @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"POT-Creation-Date: 2020-08-06 22:23+0000\n" +"POT-Creation-Date: 2020-08-07 22:24+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" diff --git a/pot/master/pages/test-case-relevancy.pot b/pot/master/pages/test-case-relevancy.pot index 401d1f3..cac25ad 100644 --- a/pot/master/pages/test-case-relevancy.pot +++ b/pot/master/pages/test-case-relevancy.pot @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"POT-Creation-Date: 2020-08-06 22:23+0000\n" +"POT-Creation-Date: 2020-08-07 22:24+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" diff --git a/pot/master/pages/tests.pot b/pot/master/pages/tests.pot index be9592d..8a44dc6 100644 --- a/pot/master/pages/tests.pot +++ b/pot/master/pages/tests.pot @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"POT-Creation-Date: 2020-08-06 22:23+0000\n" +"POT-Creation-Date: 2020-08-07 22:24+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" diff --git a/pot/master/pages/tmt.pot b/pot/master/pages/tmt.pot index 2a0f553..d6016b0 100644 --- a/pot/master/pages/tmt.pot +++ b/pot/master/pages/tmt.pot @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"POT-Creation-Date: 2020-08-06 22:23+0000\n" +"POT-Creation-Date: 2020-08-07 22:24+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -50,126 +50,876 @@ msgstr "" #. type: Title == #: ./pages/tmt.adoc:13 #, no-wrap -msgid "Examples" +msgid "First Steps" +msgstr "" + +#. type: Title === +#: ./pages/tmt.adoc:15 +#, no-wrap +msgid "Install" msgstr "" #. type: Plain text -#: ./pages/tmt.adoc:16 -msgid "Enable basic smoke test for my component:" +#: ./pages/tmt.adoc:18 +msgid "Install tmt on your laptop:" msgstr "" #. type: Plain text #: ./pages/tmt.adoc:21 #, no-wrap msgid "" -" dnf install -y tmt\n" -" tmt init --template mini\n" -" vim plans/example.fmf\n" -" git add . && git commit -m tests && git push\n" +" sudo dnf install -y tmt # basic features, executing tests on " +"localhost\n" +" sudo dnf install -y tmt-all # install all available tmt subpackages " +"including all dependencies\n" msgstr "" #. type: Plain text #: ./pages/tmt.adoc:23 -msgid "Create a new test based on a shell/beakerlib template:" +msgid "You can also install selected provision plugins only:" msgstr "" #. type: Plain text #: ./pages/tmt.adoc:26 #, no-wrap msgid "" -" tmt test create --template shell tests/basic\n" -" tmt test create --template beakerlib tests/advanced\n" +" sudo dnf install -y tmt-provision-container # additional dependencies " +"for executing tests in containers\n" +" sudo dnf install -y tmt-provision-virtual # support for running " +"tests in a virtual machine using testcloud\n" msgstr "" #. type: Plain text #: ./pages/tmt.adoc:28 -msgid "Run all/selected tests safely in a virtual machine:" +msgid "" +"See the tmt " +"https://tmt.readthedocs.io/en/latest/overview.html#install[install] section " +"for more installation options." +msgstr "" + +#. type: Title === +#: ./pages/tmt.adoc:29 +#, no-wrap +msgid "Git Repo" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:32 +msgid "Check out the desired dist git branch using fedpkg:" msgstr "" #. type: Plain text -#: ./pages/tmt.adoc:31 +#: ./pages/tmt.adoc:36 +#, no-wrap +msgid "" +" fedpkg clone -a bash\n" +" cd bash\n" +" git checkout f32\n" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:38 +msgid "Or clone your GitHub project repository:" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:42 +#, no-wrap +msgid "" +" git clone https://github.com/psss/tmt/\n" +" cd tmt\n" +" git checkout -b enable-tests\n" +msgstr "" + +#. type: Title === +#: ./pages/tmt.adoc:43 +#, no-wrap +msgid "Smoke Test" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:46 +msgid "Let's enable a simple smoke test using the minimal plan template:" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:52 +#, no-wrap +msgid "" +" $ tmt init --template mini\n" +" Tree '/tmp/bash' initialized.\n" +" Applying template 'mini'.\n" +" Directory '/tmp/bash/plans' created.\n" +" Plan '/tmp/bash/plans/example.fmf' created.\n" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:54 +msgid "Edit the newly created plan as needed, for example like this:" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:59 +#, no-wrap +msgid "" +" summary:\n" +" Basic smoke test for bash\n" +" execute:\n" +" script: bash --version\n" +msgstr "" + +#. type: Title == +#: ./pages/tmt.adoc:60 +#, no-wrap +msgid "Execute Tests" +msgstr "" + +#. type: Title === +#: ./pages/tmt.adoc:62 +#, no-wrap +msgid "Run Tests" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:65 +msgid "Execute all available tests safely in a virtual machine:" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:67 +#, no-wrap +msgid " tmt run\n" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:69 +msgid "Run only tests matching given name or located under the current directory:" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:72 #, no-wrap msgid "" -" tmt run\n" " tmt run test --name smoke\n" +" tmt run test --name .\n" msgstr "" #. type: Plain text -#: ./pages/tmt.adoc:33 -msgid "Execute tests in my preferred environment:" +#: ./pages/tmt.adoc:74 +msgid "Show detailed test results from the latest tmt run executed by current user:" msgstr "" #. type: Plain text -#: ./pages/tmt.adoc:38 +#: ./pages/tmt.adoc:76 +#, no-wrap +msgid " tmt run --last report -fvvv\n" +msgstr "" + +#. type: delimited block = +#: ./pages/tmt.adoc:80 +msgid "" +"Executing tests enabled using the Standard Test Interface in tests/tests.yml " +"is not supported yet but we are working on it." +msgstr "" + +#. type: Title === +#: ./pages/tmt.adoc:83 +#, no-wrap +msgid "Select Steps" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:86 +msgid "Explicitly choose which steps should be run:" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:88 +#, no-wrap +msgid " tmt run discover\n" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:91 +msgid "" +"This will provide an overview of tests which would be run. To list " +"individual tests enable the verbose mode:" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:94 +#, no-wrap +msgid "" +" tmt run discover --verbose\n" +" tmt run discover -v\n" +msgstr "" + +#. type: Title === +#: ./pages/tmt.adoc:96 +#, no-wrap +msgid "Provision Options" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:99 +msgid "Choose `local` as the provision method but run `--all` steps:" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:101 +#, no-wrap +msgid " tmt run --all provision --how local\n" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:103 +msgid "Execute inside a container or virtual machine:" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:106 +#, no-wrap +msgid "" +" tmt run --all provision --how container --image fedora\n" +" tmt run --all provision --how virtual --image fedora-32\n" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:108 +msgid "Check all available provision plugins:" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:110 +#, no-wrap +msgid " tmt run provision --help\n" +msgstr "" + +#. type: Title === +#: ./pages/tmt.adoc:111 +#, no-wrap +msgid "Prepare Options" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:114 +msgid "Install additional packages on the guest:" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:116 +#, no-wrap +msgid " tmt run --all prepare --how install --package httpd\n" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:118 +msgid "Get the latest package from provided copr repository:" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:120 +#, no-wrap +msgid " tmt run --all prepare --how install --copr psss/tmt --package tmt\n" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:122 +msgid "Use the freshly build local rpm or all rpms from provided local directory:" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:125 +#, no-wrap +msgid "" +" tmt run --all prepare --how install --package " +"tmp/RPMS/noarch/tmt-0.20-1.fc32.noarch.rpm\n" +" tmt run --all prepare --how install --directory tmp/RPMS/noarch\n" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:127 +msgid "Check all available prepare options:" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:129 +#, no-wrap +msgid " tmt run prepare --help\n" +msgstr "" + +#. type: Title === +#: ./pages/tmt.adoc:130 +#, no-wrap +msgid "Pull Requests" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:133 +msgid "" +"In order to test a pull request on GitHub enable the " +"https://github.com/marketplace/packit-as-a-service[Packit-as-a-Service] " +"integration and add a `.packit.yaml` configuration file:" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:135 +#, no-wrap +msgid " jobs:\n" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:138 +#, no-wrap +msgid "" +"job: tests\n" +"trigger: pull_request\n" +"metadata:\n" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:139 +#, no-wrap +msgid "targets:\n" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:140 +#, no-wrap +msgid "fedora-all\n" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:143 +msgid "" +"For more details see the https://packit.dev/testing-farm/[Testing Farm] " +"documentation. Once the integration is enabled push the branch, create a " +"new pull request as ususal and wait for results:" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:145 +#, no-wrap +msgid " git push origin -u enable-tests\n" +msgstr "" + +#. type: delimited block = +#: ./pages/tmt.adoc:149 +msgid "Fedora CI support for tmt tests is coming in August/September 2020." +msgstr "" + +#. type: Title == +#: ./pages/tmt.adoc:152 +#, no-wrap +msgid "Create Test" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:155 +msgid "In order to create more complex tests let's use the base plan template:" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:158 +#, no-wrap +msgid "" +" tmt plan create /plans/basic --template base\n" +" tmt plan create /plans/basic -t base\n" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:160 +msgid "" +"Update summary as needed, keep discover method to `fmf` and choose whether " +"tests should be executed as `shell` scripts (just check the exit code) or " +"`beakerlib` tests (investigate journal for test results):" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:167 +#, no-wrap +msgid "" +" summary:\n" +" Check basic bash features\n" +" discover:\n" +" how: fmf\n" +" execute:\n" +" how: beakerlib\n" +msgstr "" + +#. type: Title === +#: ./pages/tmt.adoc:168 +#, no-wrap +msgid "Shell Test" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:171 +msgid "In order to create a simple shell test skeleton use the shell template:" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:177 +#, no-wrap +msgid "" +" $ tmt test create /tests/smoke\n" +" Template (shell or beakerlib): shell\n" +" Directory '/tmp/bash/tests/smoke' created.\n" +" Test metadata '/tmp/bash/tests/smoke/main.fmf' created.\n" +" Test script '/tmp/bash/tests/smoke/test.sh' created.\n" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:179 +msgid "Update metadata file:" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:183 +#, no-wrap +msgid "" +" summary: Check bash version\n" +" contact: Petr Šplíchal \n" +" test: ./test.sh\n" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:185 +msgid "Adjust the test script as desired:" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:192 +#, no-wrap +msgid "" +" #!/bin/sh -eux\n" +" tmp=$(mktemp)\n" +" bash --version > $tmp\n" +" grep 'GNU bash' $tmp\n" +" grep 'Free Software Foundation' $tmp\n" +" rm $tmp\n" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:194 +msgid "Use `tmt run` to verify the test is working as expected." +msgstr "" + +#. type: Title === +#: ./pages/tmt.adoc:195 +#, no-wrap +msgid "BeakerLib Test" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:198 +msgid "Use beakerlib template to create a new beakerlib test:" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:203 +#, no-wrap +msgid "" +" $ tmt test create /tests/smoke -t beakerlib\n" +" Directory '/tmp/bash/tests/smoke' created.\n" +" Test metadata '/tmp/bash/tests/smoke/main.fmf' created.\n" +" Test script '/tmp/bash/tests/smoke/test.sh' created.\n" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:205 +msgid "" +"Update test metadata and code as needed, use `tmt run` to verify everything " +"is working fine." +msgstr "" + +#. type: Title == +#: ./pages/tmt.adoc:206 +#, no-wrap +msgid "Manage Tests" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:209 +msgid "Explore available tests, convert old metadata, share test code." +msgstr "" + +#. type: Title === +#: ./pages/tmt.adoc:210 +#, no-wrap +msgid "Explore Tests" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:213 +msgid "In order to see which tests are available:" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:215 +#, no-wrap +msgid " tmt test ls\n" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:217 +msgid "To show more details about individual tests:" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:219 +#, no-wrap +msgid " tmt test show\n" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:221 +msgid "To see an overview of all metadata:" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:223 +#, no-wrap +msgid " tmt\n" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:225 +msgid "Explore all available options and commands using `--help`." +msgstr "" + +#. type: Title === +#: ./pages/tmt.adoc:226 +#, no-wrap +msgid "Share Tests" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:231 +msgid "" +"Test code does not have to reside in the same git repository (e.g. dist git " +"rpms namespace). It is possible to store tests in a dedicated repository " +"and share them across components or product versions. You only need to " +"reference the repository in the discover step. Use the full plan template to " +"get quickly started:" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:233 +#, no-wrap +msgid " tmt plan create /plans/upstream -t full\n" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:235 +msgid "Update the repository url to point to the right place:" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:243 +#, no-wrap +msgid "" +" summary:\n" +" Essential command line features\n" +" discover:\n" +" how: fmf\n" +" url: https://github.com/psss/tmt\n" +" execute:\n" +" how: beakerlib\n" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:246 +msgid "" +"Now you will be able to run tests from the remote repository. See the " +"https://tmt.readthedocs.io/en/latest/spec/steps.html#discover[discover] step " +"documentation for details." +msgstr "" + +#. type: Title == +#: ./pages/tmt.adoc:248 +#, no-wrap +msgid "Various Hints" +msgstr "" + +#. type: Title === +#: ./pages/tmt.adoc:250 +#, no-wrap +msgid "Multiple Commands" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:253 +msgid "" +"Multiple shell commands can be provided under the `script` attribute as " +"well:" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:258 +#, no-wrap +msgid "" +" summary:\n" +" Basic smoke test for bash\n" +" execute:\n" +" script:\n" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:259 +#, no-wrap +msgid "bash --version\n" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:260 +#, no-wrap +msgid "bash -c 'echo $((1+1+1))' | grep 3\n" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:262 +msgid "" +"See the " +"https://tmt.readthedocs.io/en/latest/spec/steps.html#spec-steps-execute-shell[shell] " +"method documentation for details." +msgstr "" + +#. type: Title === +#: ./pages/tmt.adoc:263 +#, no-wrap +msgid "Multiple Repositories" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:267 +msgid "" +"In the discover step it is possible to reference multiple repositories as " +"well. In this way you can for example easily execute both upstream and " +"fedora tests as part of a single plan:" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:269 +#, no-wrap +msgid " discover:\n" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:272 +#, no-wrap +msgid "" +"name: fedora\n" +"how: fmf\n" +"repository: https://src.fedoraproject.org/tests/selinux.git\n" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:275 #, no-wrap msgid "" -" tmt run --all provision --how container\n" -" tmt run --all provision --how virtual\n" -" tmt run --all provision --how local\n" -" tmt run --all provision --how ...\n" +"name: upstream\n" +"how: fmf\n" +"repository: https://github.com/SELinuxProject/selinux-testsuite\n" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:277 +msgid "" +"See also " +"https://github.com/psss/tmt/blob/master/examples/multiple/basic.fmf[multiple " +"config] example in tmt repo to get a better idea." +msgstr "" + +#. type: Title === +#: ./pages/tmt.adoc:278 +#, no-wrap +msgid "Minimal Path" msgstr "" #. type: Plain text -#: ./pages/tmt.adoc:40 +#: ./pages/tmt.adoc:281 +msgid "Here is an example of a minimal test creation path:" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:288 +#, no-wrap +msgid "" +" dnf install -y tmt-all\n" +" git clone https://src.fedoraproject.org/rpms/bash\n" +" cd bash\n" +" tmt init -t mini\n" +" vim plans/example.fmf\n" +" tmt run\n" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:290 +msgid "" +"A slightly extended example with custom test and plan template and executing " +"test directly on the local host:" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:302 +#, no-wrap +msgid "" +" dnf install -y tmt-all\n" +" git clone https://src.fedoraproject.org/rpms/bash\n" +" cd bash\n" +" tmt init\n" +" tmt plan create --template base plans/smoke\n" +" tmt test create --template beakerlib tests/smoke\n" +" vim plans/smoke.fmf tests/smoke/*\n" +" tmt run --all provision -h local\n" +" git add .\n" +" git commit -m \"Enable basic tests\"\n" +" git push\n" +msgstr "" + +#. type: Title === +#: ./pages/tmt.adoc:303 +#, no-wrap +msgid "Virtualization Tips" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:306 +msgid "Make sure libvirtd is running:" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:308 +#, no-wrap +msgid " sudo systemctl start libvirtd\n" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:311 +msgid "" +"Add your user account to the libvirt group. You might need to restart your " +"desktop session to get it fully working." +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:314 +#, no-wrap +msgid "" +" sudo usermod -a -G libvirt $(whoami)\n" +" newgrp libvirt\n" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:316 +msgid "" +"Here you can find vm https://kojipkgs.fedoraproject.org/compose/[images for " +"download]." +msgstr "" + +#. type: Title == +#: ./pages/tmt.adoc:318 +#, no-wrap +msgid "More Info" +msgstr "" + +#. type: Title === +#: ./pages/tmt.adoc:320 +#, no-wrap +msgid "Test Examples" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:323 +msgid "Example projects with tmt tests:" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:325 +msgid "https://github.com/InfrastructureServices/bind-tests" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:326 +msgid "https://github.com/psss/tmt" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:327 +msgid "https://github.com/psss/fmf" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:328 +msgid "https://github.com/psss/did" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:330 msgid "" "See the tmt https://tmt.readthedocs.io/en/latest/examples.html[examples] " "page for more inspiration." msgstr "" -#. type: Title == -#: ./pages/tmt.adoc:41 +#. type: Title === +#: ./pages/tmt.adoc:332 #, no-wrap msgid "Links" msgstr "" #. type: Plain text -#: ./pages/tmt.adoc:44 -msgid "https://tmt.readthedocs.io/" +#: ./pages/tmt.adoc:335 +msgid "https://tmt.readthedocs.io/[Test Management Tool]" msgstr "" #. type: Plain text -#: ./pages/tmt.adoc:45 -msgid "https://packit.dev/testing-farm/" +#: ./pages/tmt.adoc:336 +msgid "https://fmf.readthedocs.io/[Flexible Metadata Format]" +msgstr "" + +#. type: Plain text +#: ./pages/tmt.adoc:337 +msgid "https://packit.dev/testing-farm/[Packit Testing Farm]" msgstr "" #. type: Title == -#: ./pages/tmt.adoc:46 +#: ./pages/tmt.adoc:339 #, no-wrap msgid "Questions" msgstr "" #. type: Labeled list -#: ./pages/tmt.adoc:48 +#: ./pages/tmt.adoc:341 #, no-wrap msgid "Does the tool replace/deprecate STI?" msgstr "" #. type: Plain text -#: ./pages/tmt.adoc:51 +#: ./pages/tmt.adoc:344 msgid "" "No, currently there is no plan to decommission STI. Both `tmt` and `sti` " "approach to CI configuration can be used in parallel." msgstr "" #. type: Labeled list -#: ./pages/tmt.adoc:52 +#: ./pages/tmt.adoc:345 #, no-wrap msgid "Are these tests supported in Fedora CI?" msgstr "" #. type: Plain text -#: ./pages/tmt.adoc:54 -msgid "Fedora CI support is coming in July/August 2020." +#: ./pages/tmt.adoc:347 +msgid "Fedora CI support is coming in August/September 2020." msgstr "" #. type: Labeled list -#: ./pages/tmt.adoc:55 +#: ./pages/tmt.adoc:348 #, no-wrap msgid "Which Linux distributions does the tool support?" msgstr "" #. type: Plain text -#: ./pages/tmt.adoc:57 +#: ./pages/tmt.adoc:350 msgid "" "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 "