liveBook · Manning

Promotion workflow

As explained in Kargo in Action

An automated sequence of steps that governs advancing an artifact between deployment environments.

A promotion workflow controls when a tested artifact may advance from pre-production to production. A successful test alone may not be enough: Checkout added a two-hour soak to catch problems that emerge only under longer-running traffic. section 2.2

A production gate can check that:

  • The latest completed pre-production test suite passed. section 2.2
  • The version has remained in pre-production for at least two hours without replacement. section 2.2
  • An eligible version triggers a pull request for a teammate to approve and merge. section 2.2
Figure 2.1 Checkout’s promotion layer after the test gate, the soak, and the scheduled trigger. Every five minutes a GitHub Actions workflow asks Argo CD what pre-prod is running and for how long, checks the latest completed run of the pre-prod test suite, and, if the version is eligible, opens a pull request that a teammate approves and merges. The numbered labels are explained in the text.
Checkout’s scheduled promotion workflow asking Argo CD and the test suite before opening a pull request to production

The diagram traces the scheduled checks from Argo CD and the test suite to a pull request requiring teammate approval. section 2.2

How Kargo in Action covers it

How deep it goes
Details test-result and soak checks plus scheduled eligibility scanning, without supplying the workflow script.
Examples
Uses Checkout’s pre-production test suite, two-hour soak, and scheduled pull-request promotion as concrete examples.
What you can do after
Evaluate production readiness by checking completed pre-production tests and uninterrupted two-hour residence before advancement.
How it connects
Connects deployment, CI testing, soak testing, GitHub Actions, Argo CD, and pull-request approval.

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.