liveBook · Manning

Promotion gap

As explained in Kargo in Action

A promotion gap is a lack of reliable control, traceability, and evidence connecting a validated artifact to the version running in production.

A promotion gap is the lack of reliable control and evidence connecting a validated artifact to the version running in production. If teams must reconstruct answers from chat logs or multiple systems, they may not know what is deployed, who approved it, or what was validated. section 1.1.1

Test for the gap by asking whether you can quickly establish:

  • Whether production runs the exact artifact that passed pre-production validation. section 1.1.1
  • Who approved the production version, whether duties were separated, and whether a direct-to-production bypass could be prevented. section 1.1.1
  • The artifact’s lineage from commit through image and environments, including evidence for an audit. section 1.1.1

Without a record of changes moving between environments, teams trace image tags by hand and may give stale status updates. A Friday hotfix can carry unreviewed changes accumulated in pre-production. Rollback is also uncertain when mutable tags do not identify a known-good previous state or what it was validated against. A promotion record makes change location, timing, and prior state visible; audit evidence follows from that record. section 1.1.2

How Kargo in Action covers it

How deep it goes
Uses diagnostic questions to expose operational and audit consequences, without detailing how to implement promotion controls.
Examples
Uses a five-question auditability test, a Friday hotfix carrying accumulated changes, and rollback through mutable image tags.
What you can do after
Diagnose whether teams can verify production artifact identity, approvals, lineage, deployment safeguards, and rollback state.
How it connects
Connects CI/CD with pre-production validation, separation of duties, artifact lineage, compliance audits, and rollback.

Related concepts

This explainer was generated by Manning's knowledge graph from the text of Kargo in Action. The section links point to the parts of the book it draws on.