StageSet vs Argo Rollouts see history edit this page

Talks about: , , , and

Argo Rollouts and StageSet are easy to mention in the same breath because both roll things out gradually, but they operate at different layers and are complementary rather than competing.

What Argo Rollouts does

Argo Rollouts replaces a Deployment with a Rollout that shifts traffic to a new version progressively — canary or blue-green — pausing at weighted steps and promoting based on metric analysis (Prometheus queries, web/Job providers). Its unit of work is a single workload’s version transition and the traffic in front of it.

What StageSet does

StageSet orchestrates a whole release as an ordered list of stages, each built from a Flux ExternalArtifact — CRDs before the operator that needs them, a migration before the app, config before the workload — gating each stage on health and running typed actions between them. It does not shift traffic or run metric analysis; its unit of work is the multi-component release and the order things apply in.

Argo RolloutsStageSet
Unit of workone workload’s version + its traffica multi-stage release of artifacts
Mechanismweighted traffic shifting + metric analysisordered apply with readiness gates + actions
Promotion driveranalysis metrics (Prometheus, web, Job)stage readiness (kstatus, CEL) and actions
Pruning / inventoryno (owns the Rollout’s pods)yes (ApplySet inventory, per-stage prune)
GitOps reconcilevia Argo CD / a GitOps toolnative (Flux controller)

They compose

A realistic setup uses both: StageSet rolls out the release in order, and a workload inside one stage is itself an Argo Rollout doing a canary. StageSet gets the supporting pieces (CRDs, config, migrations) in place and healthy; Argo Rollouts handles the fine-grained traffic progression for that one service.

Integrating them

Both directions are supported:

The full, worked examples for both are in the progressive-delivery tutorial. Where the gate’s HTTP-status contract is a native fit for Flagger, the readiness gauge and JSON endpoint make Argo Rollouts a first-class consumer too.