liveBook · Manning

Release repository

As explained in Learn Docker in a Month of Lunches, Second Edition

A release repository is a container image repository that stores images approved for deployment to production.

A release repository stores container images that have passed the required quality gates and are approved for production deployment. Images first move through a staging repository, where unit-tested builds undergo end-to-end tests; production then deploys the exact tested images from the release repository. section 16.2 section 16.3

Promote images through the pipeline without rebuilding them:

  • Build and tag images in the staging repository, recording build numbers and audit labels. section 16.2
  • Run smoke or end-to-end tests on the supported platforms and wait for the quality gates to pass. section 16.3
  • Pull the staging images, apply release repository tags, and push them without rebuilding from source. section 16.3
  • Deploy production from the release repository, optionally applying security scanning or image-signing policies there. section 16.3

Promoting a tested image

Release workflows use the staging Compose file to pull the tested images and the release Compose file to push them under release references. Enable the workflows, commit, and push: mv ../.github/workflows.ignore/package-release*.yaml ../.github/workflows/; git add --all; git commit -m 'Add release workflows'; git push. The workflow then tags the staging images and publishes them to the release repository.

How Learn Docker in a Month of Lunches, Second Edition covers it

How deep it goes
Explains the staging-to-release promotion workflow and why images must be retagged rather than rebuilt.
Examples
Uses multi-platform smoke tests, release workflow commands, Compose files, image tags, and GitHub package storage.
What it assumes
Assumes basic container images, Docker Compose, image repositories, and CI/CD workflows while demonstrating promotion from staging.
What you can do after
Apply via Docker Compose and GitHub Actions to promote tested images into production-ready storage.
How it connects
Connects container image repositories with staging repositories, Docker Compose, GitHub Actions, end-to-end testing, security scanning, and image signing.

Related concepts

This explainer was generated by Manning's knowledge graph from the text of Learn Docker in a Month of Lunches, Second Edition. The section links point to the parts of the book it draws on.