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 18fa4203e1
Merge branch 'stable'
1 day ago
.github/ISSUE_TEMPLATE update issues template 7 months ago
ambassador Change env var to AMBASSADOR_CONFIG_BASE_DIR and add docs. 3 weeks ago
docs Add Daniel Rate Limiting docs 1 week ago
end-to-end Bump ambassador-envoy version to fix #647. Also port in Makefile changes, etc., for minimal test improvements to (hopefully) pass tests. 1 month ago
helm/ambassador Bump committed version in Chart.yaml. 2 weeks ago
k8s Revert listener-port changes related to running as non-root. We'll 5 months ago
releng disable tests for now since 0.50 changes all this anyway 2 weeks ago
scripts Drop default statsd container 4 months ago
statsd-sink Remove custom statsd-prom container 3 months ago
templates final tweaks for rate limiting 1 week ago
.gitignore Integrated kat tests into `make test` and added `make shell`, and `make clean-test` targets. 3 months ago
.nvmrc Add Netlify 1 year ago
.travis.yml [skip ci] set branch: stable for publish website 2 months ago
BUILDING.md Merge pull request #746 from bcatcho/statsd-prometheus-mapping 2 months ago
CHANGELOG.md Update CHANGELOG and index for 0.40.2. 3 weeks ago
LICENSE Add LICENSE and update .gitignore 1 year ago
Makefile Bump ambassador-envoy version to fix #647. Also port in Makefile changes, etc., for minimal test improvements to (hopefully) pass tests. 1 month ago
README.md update helm link 3 months ago
RELEASING.md update with blog post workflow 2 months ago
VERSION-template.py Apache License headers on Python, shell scripts and HTML 5 months ago
dev-requirements.txt Basic kat integration. 3 months ago
kubernaut-config.json.enc install encrypted kubernaut token 7 months ago
pytest.ini Remove the -s option. 3 months ago
stats_walkthrough.txt Update with Graphite URLs and info 1 year ago

README.md

Ambassador Build Status Docker Repository

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: