A delivery audit trail makes each advancement of an artifact verifiable. Kargo persists each Promotion as a queryable Kubernetes resource, rather than leaving teams to reconstruct advancement from scripts or tribal knowledge. section 1.0 section 3.2.4
A Promotion records:
- The Stage and Freight being advanced. section 3.2.4
- Its phase, timestamps, and freight collection, which show what was promoted, when, and how long it took. section 3.2.4
- The results of promotion-template steps, including command output and errors. section 3.2.4
Verify an advancement
After a Promotion completes, inspect its status to confirm the outcome and timing and identify the Freight. If it failed, kubectl describe promotion <name> shows which step failed and what it produced. section 3.2.4
Listing 3.5 The same Promotion after it has run to completion
apiVersion: kargo.akuity.io/v1alpha1
kind: Promotion
metadata:
name: dev-x7g2k # #1
namespace: demo
spec:
stage: dev
freight: 7b2f9a8e3c1d5f4a6b8e9c0d2f1a5b7c
status:
phase: Succeeded # #2
startTime: "2026-05-25T14:22:01Z" # #3
finishTime: "2026-05-25T14:22:28Z"
freightCollection: # #4
freight:
demo-app:
name: 7b2f9a8e3c1d5f4a6b8e9c0d2f1a5b7c
A completed Promotion manifest shows the recorded phase, timestamps, and Freight collection. section 3.2.4




