README

conduit

Build Status GitHub license Slack Status

🎈 Welcome to Conduit! 👋

Conduit is an ultralight service mesh for Kubernetes. It features a minimalist control plane written in Go, and a native proxy data plane written in Rust that boasts the performance of C without the heartbleed.

Conduit is alpha. It is capable of proxying all TCP traffic, including websockets and HTTP tunneling, and reporting top-line metrics (success rates, latencies, etc) for all HTTP, HTTP/2, and gRPC traffic.

Get involved

Documentation

View Conduit docs for more a more comprehensive guide to getting started, or view the full Conduit roadmap.

Getting started with Conduit

  1. Install the Conduit CLI with curl https://run.conduit.io/install | sh .

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

  3. Install Conduit into your Kubernetes cluster with: conduit install | kubectl apply -f -.

  4. Verify that the installation succeeded with conduit check.

  5. Explore the Conduit controller with conduit dashboard.

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

  7. Add your own service to the Conduit mesh!

Working in this repo

BUILD.md includes general information on how to work in 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

Conduit is copyright 2018 Buoyant, Inc. 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.

Expand ▾ Collapse ▴

Directories

Path Synopsis
cli
cmd
controller
ca
gen/common
Package common is a generated protocol buffer package.
Package common is a generated protocol buffer package.
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/proxy/destination
Package destination is a generated protocol buffer package.
Package destination is a generated protocol buffer package.
gen/proxy/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 conduit integration tests.
Package testutil provides helpers for running the conduit integration tests.
web
srv