Skip to content

feat: publish container image to Docker Hub for discoverability#102

Merged
SebTardif merged 2 commits into
mainfrom
feat/dockerhub-publish
May 27, 2026
Merged

feat: publish container image to Docker Hub for discoverability#102
SebTardif merged 2 commits into
mainfrom
feat/dockerhub-publish

Conversation

@SebTardif

Copy link
Copy Markdown
Contributor

Summary

Adds Docker Hub as a second push target in the release workflow for discoverability. GHCR remains the primary registry for all documentation, Helm chart defaults, and install manifests.

Changes

File Change
.github/workflows/release.yaml Docker Hub login, image tags, cosign signing, README sync job
docker/README.md New Docker Hub-specific README (shorter, pull-focused)
README.md Docker Hub pulls badge
docs/getting-started/installation.md "Also available on Docker Hub" note
docs/contributing/releasing.md Docker Hub section in release process

What stays the same

  • Helm chart image.repository stays ghcr.io/attune-io/attune
  • All install docs default to GHCR
  • config/manager/kustomization.yaml stays GHCR
  • dist/install.yaml stays GHCR

Prerequisites before next release

Two repo secrets must be configured:

  • DOCKERHUB_USERNAME: Docker Hub username or bot account for attuneio org
  • DOCKERHUB_TOKEN: Docker Hub access token (read/write scope)

Verification

After the first tagged release with this workflow:

  1. docker pull attuneio/attune:vX.Y.Z works
  2. cosign verify passes for both GHCR and Docker Hub
  3. Docker Hub repo page shows the README from docker/README.md

Closes #12

Add Docker Hub as a second push target in the release workflow.
GHCR remains the primary registry for all docs, Helm defaults,
and install manifests (no rate limits on public packages).

Changes:
- Add Docker Hub login and image tags to release workflow
- Sign Docker Hub image with cosign (same keyless flow)
- Add dockerhub-readme job to sync docker/README.md on release
- Create docker/README.md with Docker Hub-specific content
- Add Docker Hub pulls badge to README.md
- Add Docker Hub availability note to installation docs
- Document Docker Hub in the release process

Requires DOCKERHUB_USERNAME and DOCKERHUB_TOKEN secrets to be
configured before the next release.

Closes #12

Signed-off-by: Sebastien Tardif <sebtardif@ncf.ca>
@github-actions github-actions Bot added area/ci CI/CD workflows area/docs Documentation size/m 50-249 lines changed labels May 27, 2026
Docker Hub rate-limits and blocks automated link checks, causing
false 404s in CI. The Docker Hub repo URL is validated by pull
tests after each release instead.

Signed-off-by: Sebastien Tardif <sebtardif@ncf.ca>
@SebTardif SebTardif merged commit 9f8ffd5 into main May 27, 2026
29 checks passed
@SebTardif SebTardif deleted the feat/dockerhub-publish branch May 27, 2026 20:10
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/ci CI/CD workflows area/docs Documentation size/m 50-249 lines changed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Publish container image to Docker Hub for discoverability

1 participant