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@
Inputs#
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
version | string | true | — | The jess version the calling release publishes, which tags the image. |
Outputs#
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
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.
Read diagram source
flowchart TD
n_publish["publish"]
Jobs#
| Job | Needs | Runner / delegate | Container / strategy | Condition |
|---|---|---|---|---|
publish | ubuntu-latest / — | — / — | — |
Steps#
publish#
| Step | Action / command | Condition |
|---|---|---|
| Checkout StroggForge | actions/checkout@v6 | — |
| Download the release's archives | actions/download-artifact@v8 | — |
| Lay out the build context | bash .stroggforge/scripts/jess-image/prepare-context.sh .jess-image/archives .jess-image/context | — |
| Log in to GHCR | docker/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 Image | docker/build-push-action@v6 | — |
| Run what was pushed | docker 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" | — |