This is not the latest version of Linkerd!

This documentation is for Linkerd 1.x, an older version with some significant differences. You may want to see the Linkerd 2.x (current) documentation instead.

Deployment

There are two common deployment models for Linkerd: per-host, and as a sidecar process.

Per-host

In the per-host deployment model, one Linkerd instance is deployed per host (whether physical or virtual), and all application service instances on that host route traffic through this instance.

This model is useful for deployments that are primarily host-based. Each service instance on the host can address its corresponding Linkerd instance at a fixed location (typically, localhost:4140), obviating the need for any significant client-side logic.

Since this model requires high concurrency of Linkerd instances, a larger resource profile is usually appropriate. In this model, the loss of an individual Linkerd instance is equivalent to losing the host itself.

Sidecar

In the sidecar deployment model, one Linkerd instance is deployed per instance of every application service. This model is useful for deployments that are primarily instance- or container-based, as opposed to host-based. For example, with a Kubernetes deployment, a Linkerd container can be deployed as part of the Kubernetes “pod”, and the service instance can address the Linkerd instance as if it were on the same host, i.e. by connecting to localhost:4140.

Since this sidecar approach requires many instances of Linkerd, a smaller resource profile is usually appropriate. In this model, the loss of an individual Linkerd instance is equivalent to losing the corresponding service instance.

There are three configurations for how the application service and Linkerd can talk to each other: service-to-linker, linker-to-service, and linker-to-linker.

service-to-linker

In the service-to-Linkerd configuration, each service instance routes calls through its corresponding Linkerd instance. Each Linkerd will serve in a location known to the matching service instance and will route traffic to remote services.

linker-to-service

In the Linkerd-to-service configuration, application service instances do not serve traffic directly. Instead, the sidecar Linkerd should be registered in service discovery so that incoming traffic is served by Linkerd, which then routes it to the matching service instance. While this configuration misses out on all of the client-side benefits of Linkerd, it does give you server metrics for the application service such as request counts and latency histograms.

linker-to-linker

The Linkerd-to-Linkerd configuration is a combination of the above two configurations and gives you the best of both worlds. The sidecar Linkerd should be registered in service discovery so that incoming traffic is served by the Linkerd, which then routes it to the matching service instance. Then the service instance routes outgoing calls back through Linkerd. This typically requires setting up two routers in the Linkerd config: one for incoming traffic and one for outgoing traffic.