Skip to content

Commit 8ad4048

Browse files
authored
docs(evm-wallet-experiment): update docker compose documentation (#932)
Follow-up for #930 notes recent changes to how logs are exported from the docker-compose setup. <!-- CURSOR_SUMMARY --> --- > [!NOTE] > **Low Risk** > Low risk: documentation-only updates describing log bind-mount behavior and where to find generated log/test artifacts. > > **Overview** > Updates the Docker Compose docs to reflect the newer logging setup: `/logs` is now a host bind-mount to `packages/evm-wallet-experiment/logs/` (while `ocap-run` remains a named volume), and containers tee stdout/stderr into per-service log files. > > Adds debugging notes showing how to read those host-side log files and where `test:e2e:docker` writes structured results (`logs/test-results.json`). > > <sup>Reviewed by [Cursor Bugbot](https://cursor.com/bugbot) for commit 36d233b. Bugbot is set up for automated code reviews on this repo. Configure [here](https://www.cursor.com/dashboard/bugbot).</sup> <!-- /CURSOR_SUMMARY -->
1 parent d829dbc commit 8ad4048

1 file changed

Lines changed: 14 additions & 4 deletions

File tree

packages/evm-wallet-experiment/docs/docker.md

Lines changed: 14 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -66,10 +66,12 @@ Interactive mode activates one profile at a time. E2E test mode (`docker:up`) ac
6666

6767
### Volumes
6868

69-
| Volume | Mount point | Contents |
70-
| ----------- | ----------- | ---------------------------------------------------------------------------------------- |
71-
| `ocap-run` | `/run/ocap` | Kernel databases, daemon sockets, contract addresses, delegation context, OpenClaw state |
72-
| `ocap-logs` | `/logs` | Container log output; persists across restarts |
69+
| Volume / path | Mount point | Contents |
70+
| --------------------------------------------------- | ----------- | -------------------------------------------------------------------------------------------------------- |
71+
| `ocap-run` (named volume) | `/run/ocap` | Kernel databases, daemon sockets, contract addresses, delegation context, OpenClaw state |
72+
| `packages/evm-wallet-experiment/logs/` (bind-mount) | `/logs` | Per-service log files (`<service-name>.log`); persists across restarts and readable directly on the host |
73+
74+
The `logs/` directory is created automatically by `docker:up` and `docker:interactive:up` via the `docker:ensure-logs` script. Each container's entrypoint tees its stdout/stderr to `/logs/<service-name>.log`.
7375

7476
---
7577

@@ -123,12 +125,20 @@ The test suite covers: wallet setup on both kernels, delegation creation and tra
123125
# Tail logs from all running services
124126
yarn workspace @ocap/evm-wallet-experiment docker:logs
125127

128+
# Read a per-service log file directly on the host (no docker cp needed)
129+
cat packages/evm-wallet-experiment/logs/kernel-home-bundler-7702.log
130+
131+
# Inspect structured test results after a docker e2e run
132+
cat packages/evm-wallet-experiment/logs/test-results.json
133+
126134
# Check container health
127135
docker compose -f packages/evm-wallet-experiment/docker/docker-compose.yml --profile 7702 ps
128136
```
129137

130138
Kernel containers write a readiness JSON file to `/run/ocap/<service>-ready.json` when the daemon is up. The host-side setup scripts poll this before proceeding.
131139

140+
After `test:e2e:docker` completes, structured pass/fail results are written to `packages/evm-wallet-experiment/logs/test-results.json` by the Vitest JSON reporter.
141+
132142
---
133143

134144
## Troubleshooting

0 commit comments

Comments
 (0)