Add agent commands

README.md

@@ -6,6 +6,23 @@ A developer environment for pulp based off of the [Pulp OCI Images](https://gith
 
 A detailed guide on setting up the development environment is available [here](docs/dev/tutorials/quickstart.md).
 
+## Lean multi-agent environments
+
+For parallel agents that each need an isolated live Pulp API (own DB, volumes, and source
+worktrees) with lower resource use, see the [agent environments guide](docs/dev/guides/agent-envs.md)
+and the `lean` profile (`oci-env profile docs lean`).
+
+```bash
+oci-env agent create pr-123 --plugins pulpcore
+oci-env agent up pr-123
+oci-env agent test pr-123 -p pulpcore -- -k test_crud_repos
+oci-env agent destroy pr-123
+
+# Or reuse a Cursor / other AI tool worktree for plugins under test:
+oci-env agent create pr-123 \
+  --plugins pulpcore=~/.cursor/worktrees/pulpcore/my-wt
+```
+
 ## Multiple environments
 
 oci-env supports running multiple environments simultaneously. To do this, simply create a new .env file such as:

base/container_scripts/run_functional_tests.sh

@@ -42,4 +42,14 @@ EOF
 check_pytest
 check_client
 
-sudo -u pulp -E pytest -r sx --rootdir=/var/lib/pulp --color=yes --pyargs "${PROJECT}.tests.functional" "${@:2}"
+API_URL="${API_PROTOCOL:-http}://${API_HOST:-localhost}:${API_PORT:-5001}"
+echo "Running functional tests for ${PROJECT} against live API ${API_URL}"
+echo "Auth: ${DJANGO_SUPERUSER_USERNAME:-admin} (password from DJANGO_SUPERUSER_PASSWORD)"
+
+sudo -u pulp -E \
+    API_PROTOCOL="${API_PROTOCOL:-http}" \
+    API_HOST="${API_HOST:-localhost}" \
+    API_PORT="${API_PORT:-5001}" \
+    DJANGO_SUPERUSER_USERNAME="${DJANGO_SUPERUSER_USERNAME:-admin}" \
+    DJANGO_SUPERUSER_PASSWORD="${DJANGO_SUPERUSER_PASSWORD:-password}" \
+    pytest -r sx --rootdir=/var/lib/pulp --color=yes --pyargs "${PROJECT}.tests.functional" "${@:2}"