[gnome-build-meta.wiki] Update OpenQA for GNOME developer - add how to run the tests locally

[Sam Thursfield <sthursfield src gnome org>]

commit 07d699901dab4835869f39ae285aeee8eb405eee
Author: Sam Thursfield <sam afuera me uk>
Date:   Fri Sep 24 11:54:36 2021 +0000

    Update OpenQA for GNOME developer - add how to run the tests locally

 openqa/OpenQA-for-GNOME-developers.md | 15 +++++++++++++++
 1 file changed, 15 insertions(+)
---
diff --git a/openqa/OpenQA-for-GNOME-developers.md b/openqa/OpenQA-for-GNOME-developers.md
index 1c29592..8939d7a 100644
--- a/openqa/OpenQA-for-GNOME-developers.md
+++ b/openqa/OpenQA-for-GNOME-developers.md
@@ -79,3 +79,18 @@ can adapt an existing test. Here are some we know of:
 
   * OpenSuSE: [web UI](http://openqa.opensuse.org/), 
[tests](https://github.com/os-autoinst/os-autoinst-distri-opensuse), 
[needles](https://github.com/os-autoinst/os-autoinst-needles-opensuse)
   * Fedora: [web UI](https://openqa.fedoraproject.org/), 
[tests](https://pagure.io/fedora-qa/os-autoinst-distri-fedora/blob/master/f/tests)
+
+## Running the test suite locally
+
+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.
+
+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.
+
+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`.
+
+4. Run this command inside the gnome-build-meta clone to start the openqa_worker image:
+
+        podman run --privileged --rm -it -v ./openqa:/tests -v ./installer.iso:/installer.iso --entrypoint 
isotovideo quay.io/ssssam/openqa_worker  $(jq -jr 'keys[] as $k | "\($k)=\(.[$k]) "'  < vars.json) 
CASEDIR=/tests
+