Glossary

Canary deployment

A canary deployment releases a new version to a small share of production traffic first, increasing that share only if measured health stays within threshold.

Short answer

What is canary deployment?

A canary deployment releases a new version to a small share of production traffic first, increasing that share only if measured health stays within threshold.

Explained two ways

Plain and technical

In plain terms

Rather than switching everyone to a new version at once, you send a small slice of real traffic to it and watch. If it behaves, more traffic follows. If it does not, only the slice was affected.

Technically

A canary requires traffic splitting, either through weighted routing or replica-count proportioning, and an automated gate evaluating success rate, latency percentiles and error signals. The gate should compare the canary against the concurrent stable version rather than against an absolute threshold, so a degraded shared dependency does not block a good release.

Example

What it looks like in practice

A new version receives 5% of traffic. Its p99 latency is compared with the stable version over the same window. It stays within threshold, so the share advances to 25%, then 50%, then 100%.
Keep going

More definitions

See these concepts in a running system

A 30-minute walkthrough against your own infrastructure rather than a slide about the theory.