From b5f7cfc73b5f03c815fb26916b4ce268300c2c07 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Tina=20M=C3=BCller?= <cpan2@tinita.de>
Date: Mon, 3 Jun 2024 22:01:01 +0200
Subject: [PATCH] Add devcontainer for Codespaces

Issue: https://progress.opensuse.org/issues/87695
---
 .devcontainer/devcontainer.json | 10 ++++++++++
 README.md                       | 20 ++++++++++++++++++++
 2 files changed, 30 insertions(+)
 create mode 100644 .devcontainer/devcontainer.json

diff --git a/.devcontainer/devcontainer.json b/.devcontainer/devcontainer.json
new file mode 100644
index 0000000..025d339
--- /dev/null
+++ b/.devcontainer/devcontainer.json
@@ -0,0 +1,10 @@
+{
+    "name": "openQA Single Instance",
+    "image": "registry.opensuse.org/devel/openqa/containers15.5/openqa-single-instance",
+    "runArgs": [ "--privileged", "--device", "/dev/kvm", "--entrypoint", "bash" ],
+    "postCreateCommand": "chown root:kvm /dev/kvm",
+    "containerEnv": {
+      "VNCPORT_OFFSET": "100"
+    },
+    "postAttachCommand": "(/usr/share/openqa/script/openqa-bootstrap >/var/log/openqa-bootstrap.log 2>&1 &) ; echo \"Welcome to openqa-single-instance! Check the openQA logs with 'tail -f /var/log/openqa-bootstrap.log'. Wait for the Web UI to become available. Then you can clone a job with 'openqa-clone-job url-to-job'.\""
+}
diff --git a/README.md b/README.md
index 8b86fab..a43e80b 100644
--- a/README.md
+++ b/README.md
@@ -39,6 +39,26 @@ Feel free to add issues in github or send pull requests.
 If this is too much hassle for you feel free to provide incomplete pull
 requests for consideration or create an issue with a code change proposal.
 
+## Developing tests in a browser
+
+If you only have a browser available, you can also develop tests with
+[GitHub Codespaces](https://docs.github.com/en/codespaces).
+
+On
+[os-autoinst-distri-example](https://github.com/os-autoinst/os-autoinst-distri-example).
+click on the "Code" button and select "Codespaces". Just click on the plus sign
+to create a new Codespace. Or use
+[this link](https://codespaces.new/os-autoinst/os-autoinst-distri-example?quickstart=1)
+as a quickstart to resume existing instances or create new ones.
+
+See [OpenQA in a browser](https://open.qa/docs/#_openqa_in_a_browser) for
+documentation on how to use it.
+
+You can then directly modify tests in VSCode and run
+```
+openqa-clone-job url-to-job CASEDIR=$PWD
+```
+
 ### Local testing and CI environment
 
 This repo is intended to be used with openQA as a learning example. The