b8434d60d4
Closes #1170. This branch adds a `-o wide` (or `--output wide`) flag to the Tap CLI. Passing this flag adds `src_res` and `dst_res` elements to the Tap output, as described in #1170. These use the metadata labels in the tap event to describe what Kubernetes resource the source and destination peers belong to, based on what resource type is being tapped, and fall back to pods if either peer is not a member of the specified resource type. In addition, when the resource type is not `namespace`, `src_ns` and `dst_ns` elements are added, which show what namespaces the the source and destination peers are in. For peers which are not in the Kubernetes cluster, none of these labels are displayed. The source metadata added in #1434 is used to populate the `src_res` and `src_ns` fields. Also, this branch includes some refactoring to how tap output is formatted. Signed-off-by: Eliza Weisman <eliza@buoyant.io> |
||
|---|---|---|
| .github | ||
| bin | ||
| cli | ||
| controller | ||
| doc | ||
| grafana | ||
| pkg | ||
| proto | ||
| proxy-init | ||
| test | ||
| testutil | ||
| web | ||
| .dockerignore | ||
| .editorconfig | ||
| .gcp.json.enc | ||
| .gitattributes | ||
| .gitignore | ||
| .travis.yml | ||
| BUILD.md | ||
| CHANGES.md | ||
| CONTRIBUTING.md | ||
| DCO | ||
| Dockerfile-base | ||
| Dockerfile-go-deps | ||
| Dockerfile-proxy | ||
| GOVERNANCE.md | ||
| Gopkg.lock | ||
| Gopkg.toml | ||
| LICENSE | ||
| MAINTAINERS.md | ||
| README.md | ||
| TEST.md | ||
README.md
🎈 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
- Users mailing list: Linkerd2 user discussion mailing list.
- Developers mailing list: Linkerd2 development discussion mailing list.
- Announcements mailing list: Linkerd2 announcements only (low volume).
- Follow @linkerd on Twitter.
- Join the #linkerd2 channel on the Linkerd Slack.
Documentation
View Linkerd2 docs for more a more comprehensive guide to getting started, or use the instructions below.
Getting started with Linkerd2
-
Install the Linkerd2 CLI with
curl https://run.linkerd.io/install | sh. -
Add
$HOME/.linkerd2/binto yourPATH. -
Install Linkerd2 into your Kubernetes cluster with
linkerd install | kubectl apply -f -. -
Verify that the installation succeeded with
linkerd check. -
Explore the Linkerd2 controller dashboard with
linkerd dashboard. -
Optionally, install a demo application to run with Linkerd2.
-
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.
- linkerd2-proxy -- High-performance data plane, injected as a sidecar with every service.
- linkerd2-proxy-api -- gRPC API bindings for the proxy.
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.