Publish the jess Image

.github/workflows/publishJessImage.yml

Source: .github/workflows/publishJessImage.yml · reusable workflow

Publish the jess image: the Linux jess and every platform's jess as a packing runtime, on the libraries it links against and nothing else.

Intended for: jess's own release, as a job after its rustGlobalBuild build job; pipelines that run jess pin the result by digest.

Release behavior#

Takes the github-release-jess-* archives the calling run staged, lays them out with prepare-context.sh, builds FROM scratch with the libraries ldd lists from CentOS Stream 9 (glibc 2.34), pushes ghcr.io/dreamweave-mp/jess tagged with the version and the commit, and runs what it pushed. Nothing is downloaded and then trusted.

Artifacts and effects#

  • ghcr.io/dreamweave-mp/jess: and :sha-
  • The pushed digest as an output and in the job summary

Assumptions and permissions#

  • The caller grants packages: write and calls it after the job that staged the archives, in the same run.
  • The image is a step image (uses: docker://...@sha256:...): it has no shell, git, node or cosign, so it can't be a container: job, and signing stays on the runner.
  • The runtimes are named for their archives under /opt/jess/runtimes (JESS_RUNTIMES): jess-Linux-X64, jess-Windows-X64.exe, jess-macOS-ARM64, ...

Failure modes#

  • No jess-Linux-X64.zip among the archives: the build job didn't stage Linux, or the pattern no longer matches its artifact names.
  • The image's own jess --version fails while building: the Linux jess needs a library ldd didn't list.

Example#

In jess's release.yaml: a job with needs: build that uses DreamWeave-MP/StroggForge/.github/workflows/publishJessImage.yml@ with version: the tag.

Inputs#

NameTypeRequiredDefaultDescription
versionstringtrue—The jess version the calling release publishes, which tags the image.

Outputs#

NameTypeRequiredDefaultDescription
digest——${{ jobs.publish.outputs.digest }}The pushed image's digest, sha256:..., to pin it by.

Permissions#

Top-level: {"contents":"read"}. Undeclared means inherited from the caller, not "none needed".

Job dependency graph#

Edges are YAML needs; conditional jobs may not run. Conditions are listed below.

workflow-publishJessImage relationship diagram. Its textual ledger or workflow contract is on this page or linked below.
workflow publishJessImage · Mermaid source · Full-size SVG
Read diagram source
flowchart TD
  n_publish["publish"]

Jobs#

JobNeedsRunner / delegateContainer / strategyCondition
publishubuntu-latest / —— / ——

Steps#

publish#

StepAction / commandCondition
Checkout StroggForgeactions/checkout@v6—
Download the release's archivesactions/download-artifact@v8—
Lay out the build contextbash .stroggforge/scripts/jess-image/prepare-context.sh .jess-image/archives .jess-image/context—
Log in to GHCRdocker/login-action@v3—
Generate Image Tags{ echo 'tags<<EOF' echo "$IMAGE_NAME:$VERSION" echo "$IMAGE_NAME:sha-${SHA::12}" echo 'EOF' } >> "$GITHUB_OUTPUT"—
Build and Push Imagedocker/build-push-action@v6—
Run what was pusheddocker run --rm "$IMAGE_NAME@$DIGEST" --version docker run --rm "$IMAGE_NAME@$DIGEST" workspace pack --help > /dev/null echo "Pin it: $IMAGE_NAME@$DIGEST" >> "$GITHUB_STEP_SUMMARY"—