@@ -223,6 +223,21 @@ Read the JSON summary and the Testbox line. Useful fields:
|
223 | 223 | - Actions run URL/id from the Testbox output |
224 | 224 | - `exitCode` |
225 | 225 | |
| 226 | +Use provider-backed cache volumes only for rebuildable caches, not secrets or |
| 227 | +checkout state. On Blacksmith, Crabbox forwards them as sticky disks: |
| 228 | + |
| 229 | +```sh |
| 230 | +node scripts/crabbox-wrapper.mjs run \ |
| 231 | + --provider blacksmith-testbox \ |
| 232 | + --cache-volume pnpm-store=openclaw-node24-pnpm-lock:/tmp/openclaw-pnpm-store \ |
| 233 | + --timing-json \ |
| 234 | + -- \ |
| 235 | + corepack pnpm check:changed |
| 236 | +``` |
| 237 | + |
| 238 | +The selected provider must advertise cache-volume support. If not, omit |
| 239 | +`--cache-volume` and rely on kept-lease caches. |
| 240 | + |
226 | 241 | `blacksmith testbox list` may hide hydrating or ready boxes. Use: |
227 | 242 | |
228 | 243 | ```sh |
@@ -590,7 +605,8 @@ Crabbox Blacksmith backend delegates setup to:
|
590 | 605 | |
591 | 606 | The hydration workflow owns checkout, Node/pnpm setup, dependency install, |
592 | 607 | secrets, ready marker, and keepalive. Crabbox owns dispatch, sync, SSH command |
593 | | -execution, timing, logs/results, and cleanup. |
| 608 | +execution, timing, logs/results, cleanup, and cache-volume requests. Blacksmith |
| 609 | +implements cache volumes as sticky disks. |
594 | 610 | |
595 | 611 | Minimal Blacksmith-backed Crabbox run, from repo root: |
596 | 612 | |
@@ -685,6 +701,7 @@ crabbox events <run_id> --json
|
685 | 701 | crabbox logs <run_id> |
686 | 702 | crabbox results <run_id> |
687 | 703 | crabbox cache stats --id <id-or-slug> |
| 704 | +crabbox cache volumes |
688 | 705 | crabbox ssh --id <id-or-slug> |
689 | 706 | blacksmith testbox list |
690 | 707 | ``` |
|
