[gnome-build-meta.wiki] Update OpenQA for GNOME developers - need to clone needles
- From: Sam Thursfield <sthursfield src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gnome-build-meta.wiki] Update OpenQA for GNOME developers - need to clone needles
- Date: Fri, 24 Sep 2021 16:35:55 +0000 (UTC)
commit 523994347d99c8c6553df5bf3d20cec0e00af6d8
Author: Sam Thursfield <sam afuera me uk>
Date: Fri Sep 24 16:35:54 2021 +0000
Update OpenQA for GNOME developers - need to clone needles
openqa/OpenQA-for-GNOME-developers.md | 16 +++++++++-------
1 file changed, 9 insertions(+), 7 deletions(-)
---
diff --git a/openqa/OpenQA-for-GNOME-developers.md b/openqa/OpenQA-for-GNOME-developers.md
index b85594d..74257dd 100644
--- a/openqa/OpenQA-for-GNOME-developers.md
+++ b/openqa/OpenQA-for-GNOME-developers.md
@@ -84,13 +84,15 @@ can adapt an existing test. Here are some we know of:
When adding or debugging tests you probably don't want to wait for a full Gitlab CI pipeline. You can run
the test suite locally if you don't mind doing some preparations. You will need Docker / Podman to run the
tests, and `jq`.
-1. Clone gnome-build-meta repo.
+1. Clone [gnome-build-meta](https://gitlab.gnome.org/GNOME/gnome-build-meta/) repo.
-2. Get the `installer.iso` file you want to test. The simplest way is to build the 'iso-installer-x86_64`
job in Gitlab CI, then use the 'Job artifacts' menu to download it.
+2. Clone [openqa-needles](https://gitlab.gnome.org/GNOME/openqa-needles/) repo, link or rename it to be
inside gnome-build-meta folder at `./openqa/needles`.
-3. Get the `vars.json` file from a successful OpenQA run. Visit https://openqa.gnome.org/tests to find the
latest successful run, then visit the 'Logs & Assets' tab and download `vars.json`.
+3. Get the `installer.iso` file you want to test. The simplest way is to build the 'iso-installer-x86_64`
job in Gitlab CI, then use the 'Job artifacts' menu to download it.
-4. Run this command inside the gnome-build-meta clone to start the openqa_worker image:
+4. Get the `vars.json` file from a successful OpenQA run. Visit https://openqa.gnome.org/tests to find the
latest successful run, then visit the 'Logs & Assets' tab and download `vars.json`.
+
+5. Run this command inside the gnome-build-meta clone to start the openqa_worker image:
podman run --privileged -it \
-v ./openqa:/tests -v ./installer.iso:/installer.iso \
@@ -100,14 +102,14 @@ When adding or debugging tests you probably don't want to wait for a full Gitlab
The test log will be written to stdout, the other data is still inside the container.
-5. Find the ID of the container you just ran, using `podman ps -a -l`
+6. Find the ID of the container you just ran, using `podman ps -a -l`
-6. Copy the test results and video out of the container:
+7. Copy the test results and video out of the container:
podman cp 12345678abc:/testresults ./testresults
podman cp 12345678abc:/video.ogv .
# See all files in the container by running: podman export 12345678abc | tar -v -t | less
-7. Remove the container with `podman rm` when you are done.
+8. Remove the container with `podman rm` when you are done.
It's common to use `save_screenshot` when writing testcases, which gives you a `.png` which you can then
convert into a Needle.
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]