Skip to content

Canary Release

Key idea:

Canary release (canary deployment) — pattern of gradual rollout: 1-5% of users get the new version, monitoring compares error rates, latency. If metrics good → ramp up to 100%. If bad → rollback. Unlike blue-green (100%/0% swap), canary gives progressive risk mitigation. Tooling: Argo Rollouts, Flagger, Istio weighted routing.

Below: details, example, related terms, FAQ.

Try it now — free →

Details

  • Start: 1% traffic → new version, 99% → old
  • Monitor: error rate, p99 latency, custom metrics vs old
  • Auto-rollback: if thresholds violated (configurable)
  • Ramp: 1% → 5% → 25% → 50% → 100% over 30-60 min
  • Rollback instant: switch 0% traffic to new (no downtime)

Example

# Kubernetes Argo Rollouts
spec:
  strategy:
    canary:
      steps:
      - setWeight: 1
      - pause: {duration: 5m}
      - setWeight: 25
      - analysis: {successRate: '>=99.9'}
      - setWeight: 100

Related Terms

Learn more

Frequently Asked Questions

Canary vs blue-green?

Blue-green: instant 100% cut. Canary: gradual %. Canary safer for unknown-risk changes, blue-green faster for confident releases.

For stateful services?

Harder — DB migrations + schema compat need to support both versions. Or canary non-critical path (backend feature, not DB migration).

What metrics to monitor?

Error rate (HTTP 5xx), p50/p99 latency, custom business (orders/min, conversion). Compare canary vs control cohort.