From 79db241cefacb8e38d50380389805207a2896980 Mon Sep 17 00:00:00 2001 From: Natalie Date: Sun, 28 Jun 2026 06:26:21 -0400 Subject: [PATCH] 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 --- infra/terraform/test-fleet/README.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) 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):