docs(infra): add build-once-load-many (artifact Space) to fleet README

The daily-use section listed up/sim/down/train but not the new artifact
verbs. Add the publish -> sync fetch flow + dist:models, pointing at
cloud-dx-do.md for the full table.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
Natalie 2026-06-28 06:26:21 -04:00
parent a1b15743dc
commit 79db241cef

View file

@ -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/<stamp>/` (disjoint seed numbers per
worker via `SEED_OFFSET`, so no collisions). RL sweeps: `./run dist:train <steps>`.
**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/<sha>/{.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):