Conceptly
← All Concepts
πŸͺ

Container Registry

buildA platform for storing and distributing container images

A container registry is the central storage and distribution point for container images. It plays a role similar to a source code host, except the artifact is a built image rather than source files. Teams push images after build and pull them wherever they need to run.

β–ΆArchitecture Diagram

πŸ”— Relationship

Dashed line animations indicate the flow direction of data or requests

Why do you need it?

Building an image on one machine does not automatically make it deployable elsewhere. Copying tar files around by hand does not scale once versions accumulate, multiple servers consume them, and rollback matters. Without a central place to store and tag images, container portability breaks down at the delivery stage.

Why did this approach emerge?

Once containers became a team-scale delivery unit, keeping images on the machine that built them was no longer enough. CI/CD only works cleanly when build outputs are pushed to a shared place and each environment can pull the same tagged artifact. As access control, regional replication, and security scanning requirements grew, the registry became more than storage. It became the infrastructure layer between build and execution.

How does it work inside?

The basic registry structure is a repository plus tags or digests. When you push, Docker uploads only the layers that are not already present. When you pull, it downloads only the missing layers. That layer-aware behavior is what keeps storage and transfer efficient across many related images.

Boundaries & Distinctions

A registry and a source code repository both manage versions, but they manage different things. Source control stores changing text and history. A registry stores already-built image artifacts. Public and private registries also differ meaningfully: public storage is convenient for open distribution, while private storage better fits internal services and access control needs.

When should you use it?

In CI/CD, the registry is the handoff point between build and deploy. Pipelines build images, tag them, and push them. Deployment systems then pull those tags into staging or production. In operations, tag strategy matters more than many teams expect: relying only on `latest` hides which code is really running, while semantic versions or commit-based tags preserve traceability.

Image deliveryVersion managementCI/CD integrationTeam collaboration