Ultralight, security-first service mesh for Kubernetes. Main repo for Linkerd 2.x.
Go to file
Brian Smith 377391cda9
Fix build on Linux. (#1372)
Without this change the Linux build fails. Apparently
commit 554ffe6a46 added the use of a
bash-specific feature.

Signed-off-by: Brian Smith <brian@briansmith.org>
2018-07-27 07:06:35 -10:00
.github Adopt Linkerd's governance (#1301) 2018-07-10 15:06:59 -07:00
bin Fix build on Linux. (#1372) 2018-07-27 07:06:35 -10:00
cli Send glog logs to stderr by default (#1367) 2018-07-25 12:59:24 -07:00
controller Don't relink web & controller executables when version changes. (#1338) 2018-07-26 16:20:36 -10:00
doc Update prometheus labels to match k8s resource names (#1355) 2018-07-23 15:45:05 -07:00
grafana Update prometheus labels to match k8s resource names (#1355) 2018-07-23 15:45:05 -07:00
pkg Don't relink web & controller executables when version changes. (#1338) 2018-07-26 16:20:36 -10:00
proto Rename CLI from conduit to linkerd (#1312) 2018-07-12 17:14:07 -07:00
proxy-init Enable Tap from the Web UI (#1356) 2018-07-24 14:23:42 -04:00
test Rename `ca-bundle-distributor` to `ca`. (#1340) 2018-07-17 14:10:40 -10:00
testutil Rename CLI from conduit to linkerd (#1312) 2018-07-12 17:14:07 -07:00
web Don't relink web & controller executables when version changes. (#1338) 2018-07-26 16:20:36 -10:00
.dockerignore Allow docker-build-proxy to override the proxy version (#1324) 2018-07-26 10:10:49 -07:00
.editorconfig Add protobuf files to .editorconfig (#1042) 2018-05-30 15:09:38 -07:00
.gcp.json.enc Add docker builds and integration tests to CI (#1303) 2018-07-11 14:01:42 -07:00
.gitattributes proxy: Update `rand` to 0.5.1 (#1125) 2018-06-14 15:09:58 -07:00
.gitignore Link to Grafana from Conduit Dashboard (#678) 2018-04-06 10:56:42 -07:00
.travis.yml Build version tags in CI (#1365) 2018-07-25 12:32:42 -07:00
BUILD.md Update top-level docs to reflect repo rename (#1333) 2018-07-17 13:42:25 -07:00
CHANGES.md Update CHANGES.md for the v18.7.2 release (#1362) 2018-07-24 13:26:59 -07:00
CONTRIBUTING.md Update docs to reference Linkerd (#1331) 2018-07-17 15:29:46 -07:00
DCO Add contributing doc and DCO file (#88) 2017-12-22 14:54:27 -08:00
Dockerfile-base Rename CLI from conduit to linkerd (#1312) 2018-07-12 17:14:07 -07:00
Dockerfile-go-deps Stop using `installsuffix` when building Go code. (#1327) 2018-07-16 13:48:50 -10:00
Dockerfile-proxy Allow docker-build-proxy to override the proxy version (#1324) 2018-07-26 10:10:49 -07:00
GOVERNANCE.md Adopt Linkerd's governance (#1301) 2018-07-10 15:06:59 -07:00
Gopkg.lock Enable Tap from the Web UI (#1356) 2018-07-24 14:23:42 -04:00
Gopkg.toml Enable Tap from the Web UI (#1356) 2018-07-24 14:23:42 -04:00
LICENSE Introducing Conduit, the ultralight service mesh 2017-12-05 00:24:55 +00:00
MAINTAINERS.md Adopt Linkerd's governance (#1301) 2018-07-10 15:06:59 -07:00
README.md Update README for the v18.7.1 linkerd2 release (#1348) 2018-07-23 11:19:05 -07:00
TEST.md Revert "Add note to TEST.md about kubectl version." 2018-07-25 12:33:06 -10:00

README.md

Linkerd2

Build Status GitHub license Slack Status

🎈 Welcome to Linkerd2! 👋

Note: this project is currently in the middle of a migration from the old name (Conduit) to the new name (Linkerd2). While this transition is ongoing, there will be references to Conduit that don't make a lot of sense. Not to worry, we're working on it! For more information, check out the announcement.

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 more a more comprehensive guide to getting started, or view the full Linkerd2 roadmap.

Getting started with Linkerd2

  1. Install the Linkerd2 CLI with curl https://run.conduit.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.