GitOps Flow · ecom-demo

developer → gitlab → kargo → argo cd → dev · staging · prod

What to expect if you adopt this stack

01

Git is the only lever you pull

You never kubectl apply. Every change to the cluster is a commit on ecom-demo-deployment. If it isn't in git, it isn't running.

02

Three lanes, three speeds

Dev auto-updates on every SHA. Staging gates on a semver VERSION bump. Prod waits for a human to click "Promote" in Kargo.

03

Prod runs what staging approved — bit for bit

Kargo promotes by image digest, not by tag. No re-build, no re-tag, no "works on staging but broke in prod from a re-pushed tag".

04

Everything is audited by default

Every promotion is a Kargo Promotion CR and a git commit on the deployment repo. Rollback is git revert.

05

Two eventual-consistency loops

Kargo → git (commits desired state). Argo CD → cluster (applies desired state). Failures in one don't corrupt the other.

06

The UI is for humans, not automation

Kargo's web UI is where humans approve prod rollouts. Everything else — dev & staging — is a side effect of git push.