contour

Contour is a Kubernetes ingress controller for Lyft's Envoy proxy.

Github stars Tracking Chart

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.
  • 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.

Overview

Name With Ownerprojectcontour/contour
Primary LanguageGo
Program languageGo (Language Count: 8)
Platform
License:Apache License 2.0
Release Count134
Last Release Namev1.29.0 (Posted on 2024-05-07 14:05:13)
First Release Namev0.1.0 (Posted on 2017-10-31 18:31:37)
Created At2017-10-26 20:35:22
Pushed At2024-05-13 16:44:25
Last Commit At
Stargazers Count3.6k
Watchers Count76
Fork Count665
Commits Count4.7k
Has Issues Enabled
Issues Count2239
Issue Open Count210
Pull Requests Count3698
Pull Requests Open Count11
Pull Requests Close Count441
Has Wiki Enabled
Is Archived
Is Fork
Is Locked
Is Mirror
Is Private
To the top