You are viewing docs for an older version of Linkerd. View the latest docs.
  • GitHub
  • Slack
  • Linkerd Forum

Traffic Split (canaries, blue/green deploys)

Linkerd’s traffic split functionality allows you to dynamically shift arbitrary portions of traffic destined for a Kubernetes service to a different destination service. This feature can be used to implement sophisticated rollout strategies such as canary deployments and blue/green deployments, for example, by slowly easing traffic off of an older version of a service and onto a newer version.

Note

This feature will eventually be supplanted by the newer dynamic request routing capabilities, which does not require the SMI extension.

Note

TrafficSplits cannot be used with headless services. Linkerd reads service discovery information based off the target IP address, and if that happens to be a pod IP address then it cannot tell which service the pod belongs to.

Linkerd exposes this functionality via the Service Mesh Interface (SMI) TrafficSplit API. To use this feature, you create a Kubernetes resource as described in the TrafficSplit spec, and Linkerd takes care of the rest. You can see step by step documentation on our Getting started with Linkerd SMI extension page.

By combining traffic splitting with Linkerd’s metrics, it is possible to accomplish even more powerful deployment techniques that automatically take into account the success rate and latency of old and new versions. See the Flagger project for one example of this.

Check out some examples of what you can do with traffic splitting: