Mirror of an open source Kubernetes-native API gateway for microservices built on the Envoy Proxy https://www.getambassador.io
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Flynn 7afb14b997
Merge branch 'stable'
16 hours ago
.github/ISSUE_TEMPLATE update issues template 9 months ago
ambassador adding support for grpc http 1 bridge 4 days ago
docs remove reference to override 1 day ago
end-to-end Add KAT test for routing based on a header added by extauth. We expect this to fail CI due to #1226. 6 days ago
k8s Revert listener-port changes related to running as non-root. We'll 8 months ago
kat removed vendor 1 week ago
multi move multi to top level of repo 4 months ago
releng Allow environment to override the KAT request timeout, and lengthen it for running in CI. 4 weeks ago
statsd-sink update stats docs 1 week ago
templates Merge pull request #1239 from datawire/stable 1 day ago
.dockerignore move multi to top level of repo 4 months ago
.gitignore added documentation for enabling tls support with helm 1 month ago
.nvmrc Add Netlify 1 year ago
.travis.yml Drop "sudo: false" per migration notice from Travis 3 months ago
BUILDING.md Type hinting docs + turn on --ignore-missing-imports for `make mypy` 3 months ago
CHANGELOG.md clean up CHANGELOG breaking news section 2 days ago
Dockerfile Dockerfile comments. 2 weeks ago
Dockerfile.ambassador Dockerfile comments. 2 weeks ago
Dockerfile.cached Dockerfile comments. 2 weeks ago
LICENSE Add LICENSE and update .gitignore 1 year ago
Makefile Ditch vestigial Helm stuff from the Makefile. 5 days ago
README.md updated for 0.50 2 weeks ago
RELEASING.md update with blog post workflow 4 months ago
VERSION-template.py Revamp version stuff Yet Again, make the AmbScout class function, and let the CLI use it. 4 months ago
dev-requirements.txt "make mypy" will DTRT (and do it with the mypy daemon so subsequent runs are fast) 3 months ago
kubernaut-config.json.enc install encrypted kubernaut token 9 months ago
pytest.ini Remove the -s option. 5 months ago

README.md

Ambassador Build Status Docker Repository Join Slack

Ambassador is an open source Kubernetes-native API Gateway built on Envoy, designed for microservices. Ambassador essentially serves as an Envoy ingress controller, but with many more features.

Key features include:

Architecture

Ambassador deploys the Envoy Proxy for L7 traffic management. Configuration of Ambassador is via Kubernetes annotations. Ambassador relies on Kubernetes for scaling and resilience. For more on Ambassador’s architecture and motivation, read this blog post.

Getting Started

You can get Ambassador up and running in less than a minute by running it locally with Docker. Follow the instructions here: https://www.getambassador.io#get-started.

For production usage, Ambassador runs in Kubernetes. For a Kubernetes deployment, follow the instructions at https://www.getambassador.io/user-guide/getting-started.

If you are looking for a Kubernetes ingress controller, Ambassador provides a superset of the functionality of a typical ingress controller. (It does the traditional routing, and layers on a raft of configuration options.) This blog post covers Kubernetes ingress.

You can also use Helm to install Ambassador. For more information, see the instructions in the Helm installation documentation.

Community

Ambassador is an open source project, and welcomes any and all contributors. To get started:

If you’re interested in contributing, here are some ways:

If you need commercial support or additional features, check out Ambassador Pro.