keryx media pull¶
Description¶
Hydrate a workspace's media from the object store at the versions
media.lock pins (spec 0039, R-STO-2/7).
A fresh git clone carries the authored state and media.lock, but no media —
media pull fetches every manifest entry that is missing locally, at its
pinned object version, and verifies each download against the manifest's
sha256. This is what makes an unattended CI job self-sufficient: clone, pull,
then render or post. It is also the restore path — check out any older commit
and pull to get that commit's exact media, byte-for-byte.
Files already present and matching cost nothing. A file that has been modified
locally is kept (and reported) — pull never silently discards working-copy
edits; pass --force to restore the pinned versions over them.
Usage¶
| Flag | |
|---|---|
-w, --workspace |
The reel workspace slug (required). |
--force |
Overwrite locally-modified media with the pinned versions. |
Run keryx media pull --help for the authoritative, always-current flag set.
Output¶
media pull: my-post — 8 fetched, 3 up to date
media pull: my-post — 0 fetched, 10 up to date, 1 modified locally (kept — use --force to restore the pinned versions)
With --output json, the standard envelope carries
{fetched, fetched_bytes, up_to_date, skipped_modified}.
See also¶
keryx media— the storage model and configuration.keryx media push— the upload side.- How-to: set up the media object store — bucket setup, local auth, GitLab CI OIDC.