Linkerd works by installing ultralight proxies into each pod of a service. These proxies become part of a data plane which reports telemetry data to, and receives signals from, a control plane. This means that using Linkerd doesn't require any code changes, and can even be installed live on a running service.
To interact with Linkerd, you first install the control plane and then add the data plane proxies to your service. Once installed, you can interact with Linkerd using:
The Linkerd dashboard.
Grafana dashboards configured for you, out of the box.
From Prometheus itself.
In this scenario, we’ll walk you through how to install the Linkerd onto a Kubernetes cluster and deploy a sample gRPC application to show off what Linkerd can do for your services.
Getting started with Linkerd
Step 1 - Install
Let's get started by installing the CLI:
curl https://run.linkerd.io/install | sh
linkerd to your path with:
Use the CLI to verify that your cluster is compatible with Linkerd by running:
linkerd check --pre
After everything passes, it is time to install the control plane:
linkerd install | kubectl apply -f -
linkerd install generates a list of Kubernetes resources. Run it standalone
if you would like to understand what is going on. By piping the output of
linkerd install into
kubectl, the Linkerd control plane resources will be
added to your cluster and start running immediately.
It may take a minute or two for your Kubernetes cluster to pull the Linkerd images and start all the components. While that’s happening, we can validate that everything’s happening correctly by running:
If you're interested in what components were installed, you can run:
kubectl -n linkerd get deploy
With Linkerd installed onto the cluster, the next step will be to explore a little and see what is happening.