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 ad9c90500f
Makefile needs to docker-login for releases. RELEASING.md needs to say push-docs, not docs-push.
18 hours ago
.github Update .github/pull_request_template.md to reflect the subtree workflow 1 month ago
ambassador Tweak a comment, plus check diag errors where we can. 22 hours ago
demo Finish doc changes for dropping demo.getambassador.io. 1 month ago
docs Ambassador 0.60.1 release 19 hours ago
flynn-devloop-stuff Don't require AMBASSADOR_ENABLE_ENDPOINTS, but support AMBASSADOR_DISABLE_ENDPOINTS. 1 week ago
kat Sigh. Turn config snapshots completely off in CI. 22 hours ago
multi move multi to top level of repo 6 months ago
releng Allow keeping the Kubernaut cluster around for debugging, and dump all pods, not just default namespace. 1 day ago
statsd-sink update stats docs 2 months ago
unused-e2e Github's security scanner is complaining. Most of these aren't really relevant but let's fix 'em anyway. 2 weeks ago
.dockerignore SNAPSHOT: first cut at using watt instead of kubewatch. Kubernetes-only right now, and very ugly/brute-force-ish. 4 weeks ago
.gitignore add watt to gitignore 1 week ago
.nvmrc Add Netlify 1 year ago
.travis.yml Allow keeping the Kubernaut cluster around for debugging, and dump all pods, not just default namespace. 1 day ago
BUILDING.md add docs on dump 2 weeks ago
CHANGELOG.md Ambassador 0.60.1 release 19 hours ago
Dockerfile Include grab-snapshots.py in the Ambassador image. 1 day ago
Dockerfile.ambassador Bump kubewatch version 1 month ago
Dockerfile.cached Enable the C YAML parser. 1 month ago
LICENSE Add LICENSE and update .gitignore 2 years ago
Makefile Makefile needs to docker-login for releases. RELEASING.md needs to say push-docs, not docs-push. 18 hours ago
README.md update README 2 days ago
RELEASING.md Makefile needs to docker-login for releases. RELEASING.md needs to say push-docs, not docs-push. 18 hours ago
SUPPORT.md add SUPPORT file 1 month ago
VERSION-template.py Revamp version stuff Yet Again, make the AmbScout class function, and let the CLI use it. 6 months ago
dev-requirements.txt "make mypy" will DTRT (and do it with the mypy daemon so subsequent runs are fast) 5 months ago
kconf.b64 Test kubernaut 1 month ago
kubernaut-config.json.enc install encrypted kubernaut token 1 year ago
pytest.ini Remove the -s option. 7 months ago
templates rm docs/yaml && mv templates docs/yaml && ln -s docs/yaml/ templates 1 month 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.