Skip to content
Contour is a Kubernetes ingress controller using Lyft's Envoy proxy.
Go CSS HTML JavaScript Ruby Makefile Other
Branch: master
Clone or download
jpeach Add an option to emit bootstrap config to stdout.
Add bootstrap subcommand support emissing the bootstrap JSON to
standard output by specifying the output file as `-`. The required
invocation to use this then becomes:

```
$ contour bootstrap -- -
```

The `--` is required so that the single `-` isn't interpreted as
an invalid flag.

Signed-off-by: James Peach <jpeach@vmware.com>
Latest commit 5f0cb11 Oct 11, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github .github: remove environment section from feature request template Oct 17, 2019
_integration all: rename heptio-contour namespace projectcontour Sep 17, 2019
apis Add automatic rendering of CRD YAMLs Oct 18, 2019
cmd/contour Add an option to emit bootstrap config to stdout. Oct 20, 2019
design doc: improve shell command formatting in the guides Oct 17, 2019
docs site: move the remainder of /docs to /site Oct 18, 2019
examples Add automatic rendering of CRD YAMLs Oct 18, 2019
hack all: rename projectcontour.io v1alpha1 to v1 Oct 1, 2019
internal internal/dag: improve TLS secrets validation Oct 18, 2019
site site: move the remainder of /docs to /site Oct 18, 2019
.dockerignore Dockerfile: update to Go 1.13.3 Oct 18, 2019
.gitignore Dockerfile: upgrade to Go 1.13 Sep 5, 2019
.travis.yml Dockerfile: upgrade to Go 1.13 Sep 5, 2019
.yamllint Edited to comply with yamllint Oct 1, 2019
CODE_OF_CONDUCT.md All: remove Heptio branding Feb 4, 2019
CONTRIBUTING.md all: github.com/heptio -> github.com/projectcontour Sep 15, 2019
Dockerfile Dockerfile: update to Go 1.13.3 Oct 18, 2019
FAQ.md All: remove Heptio branding Feb 4, 2019
LICENSE Add LICENSE Oct 31, 2017
Makefile Add automatic rendering of CRD YAMLs Oct 18, 2019
README.md Update documentation to include httpproxy in deploy readme Oct 18, 2019
contour.png Add new contour logo Feb 25, 2019
go.mod Add automatic rendering of CRD YAMLs Oct 18, 2019
go.sum Add automatic rendering of CRD YAMLs Oct 18, 2019
netlify.toml make requested PR changes Jul 1, 2019
tools.go Add automatic rendering of CRD YAMLs Oct 18, 2019

README.md

Contour Build Status Go Report Card GitHub release License

Contour is fun at parties!

Overview

Contour is an Ingress controller for Kubernetes that works by deploying the Envoy proxy as a reverse proxy and load balancer. Contour supports dynamic configuration updates out of the box while maintaining a lightweight profile.

Contour also introduces a new ingress API (HTTPProxy) which is implemented via a Custom Resource Definition (CRD). Its goal is to expand upon the functionality of the Ingress API to allow for a richer user experience as well as solve shortcomings in the original design.

Prerequisites

Contour is tested with Kubernetes clusters running version 1.10 and later, but should work with earlier versions where Custom Resource Definitions are supported (Kubernetes 1.7+).

RBAC must be enabled on your cluster.

Get started

Getting started with Contour is as simple as one command. See the Getting Started document.

Troubleshooting

If you encounter issues, review the troubleshooting docs, file an issue, or talk to us on the #contour channel on the Kubernetes Slack server.

Contributing

Thanks for taking the time to join our community and start contributing!

  • Please familiarize yourself with the Code of Conduct before contributing.
  • See CONTRIBUTING.md for information about setting up your environment, the workflow that we expect, and instructions on the developer certificate of origin that we require.
  • Check out the [open issues][3].
  • Join our Kubernetes Slack channel: #contour
  • Join the Contour Community Meetings, every third Tuesday at 6PM ET / 3PM PT / Wednesday at 8AM Australian Eastern Time.
    • Meeting notes can be found here.
    • Meetings are recorded and can be found here.

Changelog

See the list of releases to find out about feature changes.

You can’t perform that action at this time.