diff --git a/infra/terraform/test-fleet/README.md b/infra/terraform/test-fleet/README.md index 4e3097db..146c4ed9 100644 --- a/infra/terraform/test-fleet/README.md +++ b/infra/terraform/test-fleet/README.md @@ -51,6 +51,20 @@ Run it anytime — before you even have a DO account. It uses a **mocked** provi Results land merged under `.local/iter//` (disjoint seed numbers per worker via `SEED_OFFSET`, so no collisions). RL sweeps: `./run dist:train `. +**Build once, load many** — instead of N workers each recompiling the gdext, +publish the linux `.so`+wasm once and let the others fetch it (keyed by git sha, +via the `magicciv-artifacts` DO Space): + +```sh +./run dist:up 3 +./run dist:publish # one worker builds + uploads builds//{.so,wasm} +./run dist:sync # all workers fetch the prebuilt .so (no recompile) +./run dist:models ls # share RL .onnx via the same Space (push/pull/ls) +``` + +`dist:sync` falls back to building when there's no published artifact for the +sha (or no Spaces creds). Full verb table + gotchas: `cloud-dx-do.md`. + ## Cost Pure pay-as-you-go, billed hourly only while `workers > 0` (⚠️ approximate — confirm in the DO console):