Skip to content

spear-image: get/update lifecycle verbs for base and project - #14

Merged
daniel-rossier merged 1 commit into
mainfrom
spear-image-get-update
Nov 16, 2026
Merged

daniel-rossier merged 1 commit into
mainfrom
spear-image-get-update

Conversation

@daniel-rossier

Copy link
Copy Markdown
Contributor

Two option-free lifecycle verbs over spear-image build, so neither a maintainer nor a colleague has to remember where a tiered image lives or which flags built it. Everything comes from client/local.conf.

  • get <base|project> — fetch a tier's image: the registry (SPEAR_REGISTRY_IMAGE) first, else a shared tarball directory (SPEAR_SHARE_DIR, spear-<tier>-<version>.tar.zst). Idempotent; an image already present is left alone.
  • update <base|project> — rebuild from local.conf, refresh that tarball, and try to push. Rebuild only: re-indexing a corpus stays a separate, deliberate step. update base builds the harness first if missing; update project requires the base.

Two new local.conf settings say where images travel: SPEAR_REGISTRY_IMAGE (full repo path) and SPEAR_SHARE_DIR (shared tarball dir, default the tree's parent).

Documented in docker/README.md (colleague-facing), the container chapter, and local.conf.example.

`get <base|project>` fetches a tier's image without the caller knowing
where it lives -- the registry (SPEAR_REGISTRY_IMAGE) first, else a
shared tarball directory (SPEAR_SHARE_DIR, spear-<tier>-<version>.tar.zst).
`update <base|project>` rebuilds from local.conf, refreshes that tarball
and tries to push; re-indexing stays a separate, deliberate step. Both
are option-free -- client/local.conf holds every setting.

Document the two verbs and the two new settings in docker/README.md,
the container chapter and local.conf.example.
@daniel-rossier
daniel-rossier merged commit 33aa2ff into main Nov 16, 2026
1 check passed
@daniel-rossier
daniel-rossier deleted the spear-image-get-update branch November 16, 2026 14:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant