Problem
- Currently, no Docker images are built or uploaded to a container registry.
- The organization does not yet have a container registry; all images are built locally every time
docker compose is run.
- This slows down developer workflows and prevents sharing/reuse of images across projects.
Proposal
- Establish a GitHub Container Registry (GHCR) namespace at the organization scope (
ghcr.io/<org>/<image>:<tag>).
- Implement a GitHub Actions workflow to build and publish Docker images for both amd64 and arm64 architectures.
- Use semantic versioning (
vX.Y.Z) for tagging images to ensure consistency and traceability.
- Ensure images are published to the organization scope so they can be reused across multiple repositories.
Benefits
- 🚀 Faster developer workflows — no need to rebuild images locally for every
docker compose.
- 🛡️ Consistency — semantic version tags ensure predictable deployments.
- 🔄 Reusability — organization-scoped images can be shared across multiple repos.
- 📦 Foundation for future automation — registry enables CI/CD pipelines and caching.
Acceptance Criteria
Additional Notes
This workflow should leverage Docker Buildx and GitHub Actions caching to optimize build performance. Initial setup will require enabling GitHub Packages/Container Registry for the organization.
Problem
docker composeis run.Proposal
ghcr.io/<org>/<image>:<tag>).vX.Y.Z) for tagging images to ensure consistency and traceability.Benefits
docker compose.Acceptance Criteria
ghcr.io/<org>/<image>:<tag>.Additional Notes
This workflow should leverage Docker Buildx and GitHub Actions caching to optimize build performance. Initial setup will require enabling GitHub Packages/Container Registry for the organization.