Files

tegwick 8e0465865a Finish SAND-WP-0002: remote smoke, podman-compose, HTTP stub

- T10 smoke passed on CoulombCore (sand-boxer self-deploy, sandbox 4e542c51)
- Add e2e smoke compose, scripts/smoke-compose-e2e.sh, make smoke-remote
- Support SANDBOXER_COMPOSE_CMD for podman-compose hosts
- FastAPI v0 stub at sandboxer.api.app; migration gaps doc
- Mark workplan finished (all 10 tasks done)

2026-06-23 16:52:29 +02:00

2.4 KiB

Raw Permalink Blame History

Runbook: profile.compose-e2e

Provision a compose-based e2e sandbox via ext.compose-ssh (e2e-framework lineage).

Prerequisites

Workstation

uv, ssh, rsync
sand-boxer installed: make setup

Remote host (CoulombCore or sandboxer01)

SSH access (SANDBOXER_HOST or --host)
Compose runtime: docker compose or podman-compose (CoulombCore uses podman)
Sufficient disk for images

export SANDBOXER_HOST=coulombcore          # or 92.205.130.254
export SANDBOXER_COMPOSE_CMD=podman-compose  # CoulombCore; omit on docker hosts
# Omit SANDBOXER_SSH_USER to use ~/.ssh/config (CoulombCore: tegwick + id_ops)

Automated smoke (SAND-WP-0002-T10)

./scripts/smoke-compose-e2e.sh

Uses sand-boxer e2e/docker-compose.smoke.yml (nginx:alpine) — create → ps → destroy → verify cleanup.

Create

Target repo must contain e2e/e2e.yml (for compose file path) or a docker-compose*.yml at repo root.

sandboxer create \
  --profile profile.compose-e2e \
  --input repo=/path/to/repo \
  --actor adm \
  --project sand-boxer

Confirm state: ready and note reachability.ssh, reachability.remote_dir, and reachability.compose_project.

Manual readiness check

sand-boxer confirms compose services are running (not HTTP health — that is wise-validator's job):

ssh $SANDBOXER_SSH_USER@$SANDBOXER_HOST \
  'docker compose -p <compose_project> -f <remote_dir>/<compose_file> ps'

Destroy

sandboxer destroy <sandbox_id>

Verify cleanup:

ssh $SANDBOXER_SSH_USER@$SANDBOXER_HOST 'docker compose ls'
ssh $SANDBOXER_SSH_USER@$SANDBOXER_HOST 'ls /tmp/sandboxer/'

Compatibility with legacy `make e2e`

Interim callers in the-custodian should migrate to sand-boxer for provision/teardown only. Test execution remains in wise-validator (SAND-WP-0003).

Legacy	sand-boxer
`make e2e REPO=foo` (full pipeline)	`sandboxer create` + wise-validator run
rsync + compose up	`ext.compose-ssh` provision
compose down + dir removal	`sandboxer destroy`

Troubleshooting

Provision fails — no compose file

Ensure repo has e2e/e2e.yml with compose_file or a root docker-compose*.yml.

Leftover compose projects

ssh $SANDBOXER_HOST 'docker compose -p sbx-e2e-<id> down -v; rm -rf /tmp/sandboxer/<id>'

Skip State Hub events (local debug)

export SANDBOXER_NO_STATE_HUB=1

2.4 KiB Raw Permalink Blame History