Artifacts & Registries

Build once, promote many. Immutable outputs, digests versus tags, registries, retention, and why rebuilding per environment quietly destroys your evidence.

What an Artifact Is

The immutable, stored, addressable output of a build — the unit that gets tested, promoted, deployed and rolled back.

Q · What exactly is the thing that gets deployed, and why does it have to exist before the deploy starts?
Build Once, Deploy Many

One artifact is built, then promoted unchanged through every environment, and environment differences arrive as configuration rather than as a rebuild.

Q · If staging and production need different settings, why not just build a separate artifact for each?
Artifact Registries

The store artifacts live in between build and deploy — and a piece of production infrastructure on the critical path of every scale-up.

Q · Where do artifacts live between being built and being run, and what does that store owe you when it is 3am?
Tags Versus Digests

A tag is a mutable human reference; a digest is content identity. Deploying by digest is what makes a rollout reproducible.

Q · What is the difference between deploying `app:2.3.1` and deploying `app@sha256:9f3e...`, and when does that difference become an incident?
Semantic Versioning, and Where It Stops Applying

A version number is a compatibility promise to consumers who upgrade on their own schedule — and for a continuously deployed internal service there are none, so a build number is the honest answer.

Q · What does a version number promise, who is it a promise to, and what should an internal service use instead?
Artifact Retention

Which artifacts you can delete, why "keep the last N" deletes the one you needed, and why retention policy is part of the rollback plan.

Q · Which stored artifacts are safe to delete, and what breaks the first time you delete the wrong one?
Promotion

Moving one artifact forward through environments by changing what is claimed about it, never by changing its bytes.

Q · What is actually changing when an artifact is "promoted", and how do you tell a real promotion from a rebuild wearing its name?