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 efbd0ac8d6
Merge pull request #1638 from datawire/lukeshu/better-envoy-make
5 days ago
.github Turn on the Stale bot 3 weeks ago
ambassador Remove old pointless debug statement. 6 days ago
build-aux Merge commit '50469dc58c' into lukeshu/cleanup-entrypoint 3 weeks ago
demo Finish doc changes for dropping demo.getambassador.io. 3 months ago
docs Ambassador 0.72.0 release 1 week ago
flynn-devloop-stuff Don't require AMBASSADOR_ENABLE_ENDPOINTS, but support AMBASSADOR_DISABLE_ENDPOINTS. 2 months ago
go/apis/envoy Run `make go/apis/envoy && go build ./go/...` 1 month ago
kat Show command output when commands fail. 6 days ago
multi move multi to top level of repo 8 months ago
releng Turn on more debugging for this branch. 1 week ago
statsd-sink Specify that statsd-exporter should use port 8125 rather than the default (9125) 3 weeks ago
test-services The stats-test-service is about to be used; commit it as a test service that we use. 1 week ago
unused-e2e The stats-test-service is about to be used; commit it as a test service that we use. 1 week ago
.dockerignore Makefile: Incorporate Envoy build in to 'docker-update-base' 1 month ago
.gitignore Makefile: Improve Envoy workflow 6 days ago
.nvmrc Add Netlify 1 year ago
.travis.yml Move release logic into a separate script 1 month ago
BUILDING.md Makefile: Improve Envoy workflow 6 days ago
CHANGELOG.md formatting fix 1 week ago
Dockerfile Include grab-snapshots.py in the Ambassador image. 2 months ago
Dockerfile.ambassador Update Ambassador base images to include bash -- and don't rebuild things like Envoy unless the version has been bumped. 3 weeks ago
Dockerfile.cached Enable the C YAML parser. 3 months ago
Dockerfile.envoy Makefile: Incorporate Envoy build in to 'docker-update-base' 1 month ago
LICENSE Add LICENSE and update .gitignore 2 years ago
Makefile Makefile: fix regression in `make go/apis/envoy` 5 days ago
README.md update README 2 months ago
RELEASING.md BUILDING.md: Add instructions for updating Envoy 1 month ago
SUPPORT.md add SUPPORT file 3 months ago
VERSION-template.py Revamp version stuff Yet Again, make the AmbScout class function, and let the CLI use it. 8 months ago
dev-requirements.txt "make mypy" will DTRT (and do it with the mypy daemon so subsequent runs are fast) 7 months ago
go.mod Run `make go/apis/envoy && go build ./go/...` 1 month ago
go.sum Run `make go/apis/envoy && go build ./go/...` 1 month ago
kconf.b64 Test kubernaut 3 months ago
kubernaut-config.json.enc install encrypted kubernaut token 1 year ago
log.txt Makefile: Improve Envoy workflow 6 days ago
pytest.ini Regression test for running Ambassador in Docker 3 weeks ago
templates rm docs/yaml && mv templates docs/yaml && ln -s docs/yaml/ templates 3 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.