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 66c1c54f0e Revamp version stuff Yet Again, make the AmbScout class function, and let the CLI use it. 1 year ago
.github/ISSUE_TEMPLATE update issues template 1 year ago
ambassador Revamp version stuff Yet Again, make the AmbScout class function, and let the CLI use it. 1 year ago
docs adding correct protocol for upstream service 1 year ago
end-to-end Merge branch 'master' into shared/dev/tgr606 1 year ago
helm/ambassador Bump Helm chart version to 0.40.0. 1 year ago
k8s Revert listener-port changes related to running as non-root. We'll 1 year ago
releng Support EA builds. Right now this is for branches labelled "tt" (a test label); shortly we'll flip to "ea" for the real EA builds. 1 year ago
scripts Drop default statsd container 1 year ago
statsd-sink Remove custom statsd-prom container 1 year ago
templates Merge pull request #746 from bcatcho/statsd-prometheus-mapping 1 year ago
.gitignore Ignore some test files, ditch some needless test output. 1 year ago
.nvmrc Add Netlify 2 years ago
.travis.yml OMG, Travis, seriously? 1 year ago
BUILDING.md Merge pull request #746 from bcatcho/statsd-prometheus-mapping 1 year ago
CHANGELOG.md minor changelog fixes for 0.40 1 year ago
LICENSE Add LICENSE and update .gitignore 2 years ago
Makefile Hackery to behave with Python 3.7. 1 year ago
README.md update helm link 1 year ago
RELEASING.md update with blog post workflow 1 year ago
VERSION-template.py Revamp version stuff Yet Again, make the AmbScout class function, and let the CLI use it. 1 year ago
dev-requirements.txt Cleaned up and simplified tests; enabled/added ambassador_id tests. 1 year ago
kubernaut-config.json.enc install encrypted kubernaut token 1 year ago
pytest.ini Remove the -s option. 1 year ago
stats_walkthrough.txt Update with Graphite URLs and info 2 years 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: