Skip to main content
Definition Website Computer and Technology

Canary Deployment

Subject: Computer and Technology noun /kəˈnɛr.i dɪˈplɔɪ.mənt/ 1 definition

  1. Definition (noun)

    Entry #249 · Updated

    A Canary Deployment is a progressive delivery strategy that routes a small, controlled share of production traffic to a new software version while the established stable release continues serving the majority. Named after the coal-mining practice of using canaries to detect toxic gases early, it limits the blast radius of regressions by evaluating real-world telemetry—such as error rates, tail latency, and resource usage—on the canary cohort before incrementally expanding the rollout or triggering a fast rollback.

    Common Forms

    • Percentage-Based Traffic Splitting: Shifts an incrementally increasing share of live requests (for example, 1%, 10%, and 50%) to canary instances through a load balancer, API gateway, or service mesh.

    • Cohort-Targeted Routing: Exposes the new release exclusively to deterministic user segments—such as internal staff, beta opt-in accounts, or a single region—matched via HTTP headers, cookies, or tenant identifiers.

    • Manual-Gate Progression: Advances traffic through predefined stages that pause between increments so engineers can review dashboards and logs before approving wider exposure.

    • Automated Canary Analysis: Continuously compares real-time metrics from the canary against a simultaneous baseline control group using statistical thresholds to automate promotion or rollback.

    Example

    Before deploying checkout service v2.4.1 across all 40 Kubernetes pods, a release pipeline configures its ingress gateway to direct 5% of production traffic to two canary pods while 38 baseline pods continue running v2.4.0. Within ten minutes, telemetry reveals an elevated HTTP 502 error rate on the canary cohort, prompting the controller to drain traffic back to v2.4.0 and avert a full-fleet outage.