linkerd2

module
v18.8.4+incompatible Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Aug 30, 2018 License: Apache-2.0

README

Linkerd2

Build Status GitHub license Slack Status

🎈 Welcome to Linkerd2! 👋

Linkerd2 is an ultralight service mesh, designed to make modern applications safe and sane by transparently adding service discovery, load balancing, failure handling, instrumentation, and routing to all inter-service communication.

Linkerd2 (pronouned "linker-DEE-two") acts as a transparent HTTP/gRPC/thrift/tcp/etc proxy, and can be deployed alongside existing applications regardless of what language they're written in. It works with many common protocols and utilizes Kubernetes as a backend for service discovery.

It is separated into two major components: the control plane and the data plane. The control plane interacts with the service discovery backend, orchestrates the data plane and is written in Go. The data plane runs alongside existing applications, provides the proxy that manages traffic itself and is written in Rust.

Currently, Linkerd2 is capable of proxying all TCP traffic, including WebSockets and HTTP tunneling, along with reporting top-line metrics (success rates, latencies, etc) for all HTTP, HTTP/2, and gRPC traffic.

Linkerd is hosted by the Cloud Native Computing Foundation (CNCF).

Get involved

Documentation

View Linkerd2 docs for a more comprehensive guide to getting started, or use the instructions below.

The doc source code is available in the website repo.

Getting started with Linkerd2

  1. Install the Linkerd2 CLI with curl https://run.linkerd.io/install | sh.

  2. Add $HOME/.linkerd2/bin to your PATH.

  3. Install Linkerd2 into your Kubernetes cluster with linkerd install | kubectl apply -f -.

  4. Verify that the installation succeeded with linkerd check.

  5. Explore the Linkerd2 controller dashboard with linkerd dashboard.

  6. Optionally, install a demo application to run with Linkerd2.

  7. Add your own service to the Linkerd2 mesh!

Working in this repo

BUILD.md includes general information on how to work in this repo.

We ❤ pull requests! See CONTRIBUTING.md for info on contributing changes.

Dependencies

There are some projects used by Linkerd2 that are not part of this repo.

Code of conduct

This project is for everyone. We ask that our users and contributors take a few minutes to review our code of conduct.

License

Copyright 2018, Linkerd Authors. All rights reserved.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use these files except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Directories

Path Synopsis
cli
cmd
controller
ca
gen/common/healthcheck
Package healthcheck is a generated protocol buffer package.
Package healthcheck is a generated protocol buffer package.
gen/controller/tap
Package tap is a generated protocol buffer package.
Package tap is a generated protocol buffer package.
gen/public
Package public is a generated protocol buffer package.
Package public is a generated protocol buffer package.
k8s
tap
pkg
k8s
cmd
Package testutil provides helpers for running the linkerd integration tests.
Package testutil provides helpers for running the linkerd integration tests.
web
srv

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL