Skip to content

linkerd/linkerd-examples

Repository files navigation

linkerd

GitHub license Circle CI

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.

All examples and documents in this repo refer to Linkerd 1.x unless explicitly called out as a Linkerd2 example. For more information on getting started with Linkerd2, head over to the Linkerd2 Getting Started Guide.

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:

Consul

Provides a self-contained docker-compose environment which shows how to use consul as a service discovery back-end with linkerd.

DC/OS

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

Docker

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

Amazon ECS

Provides common configurations for deploying linkerd to Amazon ECS. More information:

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.

http_proxy

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

influxdb

Sets up a demo environment that configures a linkerd-viz-like dashboard using linkerd, Telegraf, InfluxDB, and Grafana. Provides helpful configuration files and dashboards for all components.

A Service Mesh for Kubernetes

Defines a sample hello 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:

lifecycle

Production testing Linkerd2's discovery & caching.

linkerd-tcp

Sets up a demo environment that uses linkerd to route HTTP traffic and linkerd-tcp to route Redis traffic. Provides helpful configuration files and dashboards for all components.

Mesos + Marathon

Demonstrates running linkerd and a sample hello world app on Mesos and Marathon, without DC/OS.

Perf baseline

Demonstrates baseline performance metrics for the Linkerd2 Proxy.

Plugins

Contains sample code for building linkerd plugins. More information:

Testing

docker run -v `pwd`:/root/linkerd-examples --entrypoint=/root/linkerd-examples/.circleci/ci.sh buoyantio/linkerd:1.4.6