Examples of how to configure and run linkerd
Go Java Shell Scala Python Protocol Buffer HTML
Latest commit 0d66947 Feb 16, 2017 @siggy siggy committed on GitHub Merge pull request #100 from BuoyantIO/siggy/marathon-groups
adding marathon group example and doc notes


linkerd examples

🎈 Welcome to linkerd-examples! 👋

This repo contains subdirectories with various examples for how to use linkerd and namerd. Each of the subdirectories is described below.

Getting started

Provides guides for getting linkerd up and running in multiple different environments, including local development, docker-compose, DC/OS, and Kubernetes. More information:

Add steps demo

Provides a self-contained docker-compose environment that can be used to test linkerd's performance. More information:


Provides common configurations for deploying linkerd and namerd to DC/OS. More information:


Contains files and scripts for building custom Docker images that are used in some of the examples in this repo.

Failure accrual demo

Provides a self-contained docker-compose environment that can be used to test various failure accrual settings. More information:

Gob's microservice

Defines an example microservice application that uses linkerd and namerd to do staging, canary, and blue-green deploy.


Contains a linkerd configuration file that demonstrates how to make requests through linkerd using the http_proxy environment variable. More information:

A Service Mesh for Kubernetes

Defines a sample hellow world app and multiple configs for deploying the app to Kubernetes in various configurations, in support for Buoyant's "A Service Mesh for Kubernetes" series of blog posts. More information:


Contains sample code for building linkerd plugins. More information:


Go script that is used to generate traffic to Gob's microservice.