Skip to content

Publish the container image on Docker Hub as alignair/alignair - #14

Merged
MuteJester merged 3 commits into
mainfrom
chore/dockerhub-primary-registry
Oct 19, 2026
Merged

MuteJester merged 3 commits into
mainfrom
chore/dockerhub-primary-registry

Conversation

@MuteJester

@MuteJester MuteJester commented Oct 19, 2026 •

Copy link
Copy Markdown
Owner

Summary

  • Release workflow: the container image is built once and smoke-tested, then pushed to Docker Hub (alignair/alignair, primary) and GHCR (ghcr.io/mutejester/alignair, mirror).
    • :<version> goes to both registries first. :latest moves only after that, and never for pre-release versions.
    • Docker Hub login happens before the build, so base-image pulls are authenticated.
    • It uses the DOCKERHUB_TOKEN secret, which is set, and vars.DOCKERHUB_USERNAME, which defaults to alignair.
    • The job still runs before the immutable PyPI step.
  • Docs: the README, examples/README.md and the docs site now show docker pull alignair/alignair. GHCR is noted as a mirror for clusters that hit Docker Hub's anonymous pull limit.
  • Workflow wrappers (bug fixes):
    • They used thomask90/alignair:latest, the legacy TensorFlow image, which has no alignair predict command. They are now pinned to alignair/alignair:3.0.0.
    • The image's ENTRYPOINT is alignair, and Nextflow doesn't override entrypoints by default, so every task ran alignair /bin/bash … and failed. The Nextflow docker profile now sets --entrypoint "" -u $(id -u):$(id -g).
    • Galaxy needs a job-config override and has container networking off. Both are documented in workflows/README.md.
    • The out-of-date "unpublished image/model" text is removed.
  • Test: tests/alignair/test_container_pins.py checks that every pinned alignair/alignair / GHCR tag in the docs and wrappers matches pyproject's version.

alignair/alignair:3.0.0 and :latest are already on Docker Hub, pushed from the GHCR 3.0.0 image. They are a plain linux/amd64 manifest, like GHCR, so Apple Silicon machines pull and emulate them rather than failing on a manifest list. The image ID (config sha256:ff7aa97f…) is the same on both registries. The compressed-layer digests differ because Docker re-compresses layers on push.

Verification

  • Simulated the Nextflow task launch against alignair/alignair:3.0.0.
    • Without the override: alignair: error: argument command: invalid choice: '/bin/bash'.
    • With the new runOptions: the task runs, and its output is owned by the host user.
  • npm ci && npm run build in website/ passes.
  • pytest tests/alignair/test_container_pins.py tests/alignair/test_conda_recipe.py tests/alignair/cli/test_docs_cli_sync.py: 33 passed.
  • actionlint on release.yml finds nothing new. Its existing findings (the macos-15-intel label, info-level shellcheck notes) are on lines this PR doesn't touch.

Not in this PR

  • Multi-arch image: the image is amd64-only on both registries.
  • Docker Hub token scope: the token is a repository secret. It is not scoped to a protected environment the way the PyPI step is.
  • Re-running the containers job: this rebuilds the image and can overwrite an already-pushed :<version> with a different digest.

The PyPI README updates at the next release. The GitHub README and the docs site update on merge.

…r) and GHCR

Build the image once, smoke it, then push :<version> and :latest to Docker Hub as the
primary name and to ghcr.io/mutejester/alignair as a mirror. Docker Hub login uses the
DOCKERHUB_TOKEN repository secret. The job runs before the immutable PyPI step, as before.
README, examples and docs site now pull alignair/alignair, with ghcr.io/mutejester/alignair
noted as an identical mirror for clusters that hit Docker Hub's anonymous pull limit.

The Galaxy, Nextflow and Snakemake wrappers pointed at thomask90/alignair:latest, the legacy
TensorFlow image, which has no `alignair predict` command; pin them to alignair/alignair:3.0.0.
Drop the stale 'no published model/container' prerequisites from workflows/README.md.
…ge push

Release workflow:
- log in to Docker Hub before the build so base-image pulls are authenticated
- push :<version> to both registries before moving :latest, so a failed push never leaves
  :latest ahead of PyPI; pre-release versions never move :latest
- take the Docker Hub username from vars.DOCKERHUB_USERNAME (default: alignair)

Wrappers:
- the image's ENTRYPOINT is `alignair` and Nextflow does not override entrypoints by default,
  so every task ran `alignair /bin/bash ...` and failed; the docker profile now clears the
  entrypoint and runs as the host user
- document the Galaxy job-config override and its disabled networking
- remove the remaining 'unpublished image/model' text; recommend a local model for containers

Add a test that every pinned alignair/alignair and GHCR tag matches pyproject's version.
@MuteJester
MuteJester merged commit 7114eb9 into main Oct 19, 2026
11 checks passed
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