From 0b94cedd20f69db6e2690cc82520983953df49ce Mon Sep 17 00:00:00 2001
From: Casey Brooks <casey.brooks@agyn.io>
Date: Fri, 13 Mar 2026 18:36:25 +0000
Subject: [PATCH] docs: add devspace test commands

---
 README.md     | 16 ++++++++++------
 devspace.yaml | 20 ++++++++++++++++++++
 2 files changed, 30 insertions(+), 6 deletions(-)

diff --git a/README.md b/README.md
index bbff63d..a84b56e 100644
--- a/README.md
+++ b/README.md
@@ -39,15 +39,19 @@ It also forwards gRPC on port `50051` to your local machine.
 
 ## Running Tests
 
+Keep `devspace dev` running in another terminal, then use:
+
 ```sh
-devspace enter
-pnpm test
-DOCKER_RUNNER_SHARED_SECRET=change-me pnpm test:e2e
+devspace run test
+devspace run test:e2e
+devspace run enter
 ```
 
-`pnpm test` runs unit + integration tests; the integration suite requires
-Docker, provided by the DinD sidecar in the dev pod. The e2e suite requires the
-shared secret env var shown above.
+`devspace run test` runs unit + integration tests; the integration suite
+requires Docker, provided by the DinD sidecar in the dev pod. `devspace run
+test:e2e` runs the e2e suite, with `DOCKER_RUNNER_SHARED_SECRET` already
+provided by the Helm deployment. `devspace run enter` opens an interactive shell
+in the dev container.
 
 ## Troubleshooting
 
diff --git a/devspace.yaml b/devspace.yaml
index 91ccbf2..e2e1dc0 100644
--- a/devspace.yaml
+++ b/devspace.yaml
@@ -3,6 +3,26 @@ version: v2beta1
 vars:
   DOCKER_RUNNER_NAMESPACE: platform
 
+commands:
+  test: |-
+    exec_container \
+      --label-selector "app.kubernetes.io/name=docker-runner,app.kubernetes.io/instance=docker-runner" \
+      --container docker-runner \
+      -n ${DOCKER_RUNNER_NAMESPACE} \
+      -- pnpm test
+  test:e2e: |-
+    exec_container \
+      --label-selector "app.kubernetes.io/name=docker-runner,app.kubernetes.io/instance=docker-runner" \
+      --container docker-runner \
+      -n ${DOCKER_RUNNER_NAMESPACE} \
+      -- pnpm test:e2e
+  enter: |-
+    exec_container \
+      --label-selector "app.kubernetes.io/name=docker-runner,app.kubernetes.io/instance=docker-runner" \
+      --container docker-runner \
+      -n ${DOCKER_RUNNER_NAMESPACE} \
+      -- sh
+
 pipelines:
   dev: |-
     if kubectl get application docker-runner -n argocd >/dev/null 2>&1; then