Skip to content

Match engine image to CLI version#124

Merged
mikehorgan-dell merged 2 commits into
mainfrom
fix/spt-image-versioning
May 30, 2026
Merged

Match engine image to CLI version#124
mikehorgan-dell merged 2 commits into
mainfrom
fix/spt-image-versioning

Conversation

@mikehorgan-dell
Copy link
Copy Markdown
Member

@mikehorgan-dell mikehorgan-dell commented May 30, 2026

Summary

  • resolve the default engine image from the CLI build version instead of Docker's implicit latest tag
  • stamp local CLI builds as dev builds so they use the local-only spt_dev engine image
  • add --spt-image / SPT_IMAGE override support and shared dev-image skip-pull handling
  • fail clearly when local dev images are missing instead of trying to pull them
  • update docs for version-matched release images and dev-image workflow

The CLI now launches an engine image whose tag is derived from the CLI's
own version instead of Docker's implicit :latest, so a vX.Y.Z CLI runs the
vX.Y.Z engine and does not silently drift when a new release is published.

- buildinfo.IsRelease() distinguishes clean release builds from dev builds;
  the Makefile dev-marks local/non-tag builds (<ver>-dev+<sha>) and the
  release workflow passes VERSION explicitly so release binaries stay clean.
- constants.EffectiveSptImage() resolves $SPT_IMAGE > :v<version> (release)
  > :spt_dev (dev); there is no fallback to :latest, so a missing release
  tag fails loudly rather than running a different engine version.
- Dev images (spt_dev) auto-skip the registry pull across the command,
  preflight, and TUI paths, with a helpful "make docker-local" error when
  the image is absent.
- Add --spt-image flag (precedence: flag > SPT_IMAGE env > version default).
- Tests for the new behavior + README "Engine image selection" section.
@mikehorgan-dell mikehorgan-dell merged commit 63ac478 into main May 30, 2026
6 checks passed
@mikehorgan-dell mikehorgan-dell deleted the fix/spt-image-versioning branch May 30, 2026 18:33
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.

2 participants