a32860b0d9
Some checks failed
CI Docker Mining Proof / Linux agent hashrate proof (push) Has been cancelled
Dashboard ambient layer, comrade presence, Mission Deck and War Room, Emberwake supply chain, spread/docs publishing, fleet policy and modules API, CI docker mining, and refreshed USB pack.
99 lines
4.1 KiB
Markdown
99 lines
4.1 KiB
Markdown
# Docker Linux E2E
|
|
|
|
Isolated bridge network for validating the **Linux agent** against a real control server without installing the agent on the host.
|
|
|
|
## Topology
|
|
|
|
```
|
|
┌──────────────── docker network: e2e-internal (no host egress) ────────────────┐
|
|
│ agent container ──WS──► server container :8989 │
|
|
└──────────────────────────────────────────────────────────────────────────────┘
|
|
│
|
|
server also on `default`
|
|
▼
|
|
Stratum pool (internet)
|
|
```
|
|
|
|
- **Agent** — only on `e2e-internal` (`internal: true`). Cannot reach the internet; mines via C2 jobs from the server.
|
|
- **Server** — on `e2e-internal` + default bridge so it can reach upstream Stratum and expose `18989` to the host dashboard.
|
|
|
|
## Prerequisites
|
|
|
|
- Docker Engine 24+ with `docker compose`
|
|
- ~2 GB free disk for golang build images
|
|
|
|
RandomX uses the pure-Go `go-randomx` module — **no CGO or librandomx** required in the agent image.
|
|
|
|
## Quick start
|
|
|
|
From repo root:
|
|
|
|
```bash
|
|
docker compose -f docker/docker-compose.yml up --build
|
|
```
|
|
|
|
Watch server logs for `[WS] Agent auth` and `[Pool]` job lines. Watch agent logs:
|
|
|
|
```bash
|
|
docker compose -f docker/docker-compose.yml logs agent
|
|
```
|
|
|
|
## Verify hashrate
|
|
|
|
1. **Dashboard** — open `http://127.0.0.1:18989`, login `testuser` / `testpass`, check Fleet Roster for `docker-e2e-linux`.
|
|
2. **Stats fields** — node card should show `hashrate_15s`, `hashrate_1m`, `hashrate_15m`, and share counters after ~30s.
|
|
3. **Server logs** — `docker compose -f docker/docker-compose.yml logs -f server` — look for agent stats WS messages and share submissions if enabled.
|
|
4. **Agent log** — `docker compose -f docker/docker-compose.yml exec agent cat /tmp/miner.log` (if present).
|
|
|
|
## CI mining proof (automated)
|
|
|
|
Every push can prove the Linux agent connects and reports **hashrate > 0** without manual dashboard checks.
|
|
|
|
```bash
|
|
# Linux / macOS / GitHub Actions
|
|
scripts/ci-docker-mining.sh
|
|
|
|
# Windows (Docker Desktop)
|
|
.\scripts\ci-docker-mining.ps1
|
|
```
|
|
|
|
The script:
|
|
|
|
1. `docker compose -f docker/docker-compose.yml up --build -d`
|
|
2. Waits up to **3 minutes** for `GET /api/v1/health` + agent online
|
|
3. Asserts via `GET /api/v1/agents` (Basic auth) **or** `GET /api/v1/dashboard/stats` — online agent with `hashrate_15s|1m|15m > 0`
|
|
4. Tears down compose (`down --rmi local -v`)
|
|
|
|
GitHub Actions: `.github/workflows/ci-docker-mining.yml` (ubuntu-latest; Docker preinstalled).
|
|
|
|
## Teardown
|
|
|
|
```bash
|
|
docker compose -f docker/docker-compose.yml down --rmi local -v
|
|
```
|
|
|
|
## Fixed test credentials
|
|
|
|
| Item | Value |
|
|
|------|-------|
|
|
| Fleet secret | `e2e-docker-fleet-secret-fixed001` |
|
|
| Dashboard user | `testuser` / `testpass` |
|
|
| Host port | `18989` → server `8989` |
|
|
| Test XMR wallet | `85JfUA9uyBZ2Kzv4ctoURyUYoYgpEu5QjQ8xSdiapFX8TpBHXkHwHQhBkxUxmoFKU85NH4dnSRBbiL8wSvcVmRqg4Wc9Trm` |
|
|
|
|
The wallet is baked into `docker/data/config.json` (server pool login) and `docker/agent-builtin.go` (agent fallback). It is a **public test address** for E2E only — not for production mining.
|
|
|
|
## Troubleshooting
|
|
|
|
| Symptom | Check |
|
|
|---------|-------|
|
|
| Agent exits immediately | `logs agent` — wallet/server URL baked in `docker/agent-builtin.go` |
|
|
| Auth rejected | `fleet_secret` must match in `docker/data/config.json` and `docker/agent-builtin.go` |
|
|
| Hashrate 0 forever | Server pool connectivity — server needs default-network egress |
|
|
| CI proof times out | `docker compose logs agent server`; allow 3 min after `up -d`; pool may be slow |
|
|
| Idle mode never mines | Use `mining_mode: always` in docker builtin (default here) |
|
|
|
|
## Host server alternative
|
|
|
|
To point the agent container at a server on the host instead of the `server` service, change `ServerURL` in `docker/agent-builtin.go` to `http://host.docker.internal:8989` (Docker Desktop) and run only the agent service.
|