Build cache
The platform provides a remote build cache so builds reuse artifacts across
machines and CI instead of rebuilding from scratch. It is configured for you by
putnami cloud setup.
Setup writes .putnami/cache.json, which points at the cache and records a token
source (never a raw bearer), so the file is safe to commit. Builds then read
and write the shared cache automatically.
putnami cloud token --for cache mints a short-lived, workspace-scoped bearer
with only cache.read and cache.write. The CLI prints the bearer only; it does
not persist the token in the cache configuration.
Manage it
| Want to… | Do this |
|---|---|
| Show the cache config and identity | putnami cloud cache |
| Disable the cache (keep the file) | putnami cloud cache disable |
| Remove the cache config | putnami cloud cache disable --remove |
| Re-provision during setup | putnami cloud setup --cache |
| Skip provisioning during setup | putnami cloud setup --no-cache |
| Mint a cache bearer for a script | putnami cloud token --for cache |
The cache negotiate mode (--cache-mode: minimal, toplevel, or full) is
set at setup time.
Planned pages
| Page | Status |
|---|---|
| How the remote cache works | Planned |
| Cache modes (minimal / toplevel / full) | Planned |
| Using the cache in CI | Planned |
| Disabling & troubleshooting | Planned |