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.
Luke Shumaker 65459e4125
Merge pull request #2242 from datawire/flynn/dev/2211
2 days ago
.github Turn on the Stale bot 7 months ago
api Update Host proto for new fields. Update Makefile to hack around problems with protoc invocation for Python; update generated files. 2 weeks ago
build-aux (apro) docker.mk: Fix the APro build having stale .stamp files laying around 3 months ago
build-aux-local docs.mk: Update to no longer reference the 'early-access' branch 4 days ago
builder Address PR comments. Thanks for the catches! 2 days ago
cmd Unbreak the Windows build of edgectl 2 days ago
cxx Tidy up `make generate` 2 weeks ago
demo Finish doc changes for dropping demo.getambassador.io. 10 months ago
deployments/statsd-sink Code reorganization 3 months ago
docker upgrading envoy, this time with extra edgeyness 1 month ago
docs Switch to -ea.N and -rc.N 2 days ago
internal/pkg move teleproxy source code from teleproxy subdirectory and rename imports 3 months ago
k8s fix dockerfile shim 3 months ago
pkg Update Host proto for new fields. Update Makefile to hack around problems with protoc invocation for Python; update generated files. 2 weeks ago
python Address PR comments. Thanks for the catches! 2 days ago
releng Switch to -ea.N and -rc.N 2 days ago
scripts/devloop-helpers First tranche of test updates. This XFails the XFPRedirectTest and the TCPMappingsTest for the moment. 2 weeks ago
teleproxy-old mv teleproxy teleproxy-old # and clean up 3 months ago
test/attic Move test/services/*/ → docker/test-*/ # for clarity 3 months ago
tools/sandbox Makefile: Clean up `protoc` rules, get it generating Envoy .pb.go files again 2 months ago
.dockerignore Move all of the Envoy stuff to /cxx/ 3 months ago
.editorconfig Removed trailing blank lines 1 month ago
.gitignore Makefile: Clean up `protoc` rules, get it generating Envoy .pb.go files again 2 months ago
.nvmrc Add Netlify 2 years ago
.travis.yml CI: Drop the Edge-stack-update stuff 1 week ago
BUILDING.md Add GCLOUD_CONFIG to run pytest 1 month ago
CHANGELOG.md CHANGELOG: Update GA release date 1 week ago
LICENSE Add LICENSE and update .gitignore 2 years ago
Makefile Move `make generate` and friends from Makefile to build-aux-local/generate.mk 2 weeks ago
Makefile.old Merge branch 'lukeshu/merge-prep2' into lukeshu/final4 3 months ago
README.md Update Filter Plugin docs 2 weeks ago
RELEASING.md Address PR comments. Thanks for the catches! 2 days ago
SUPPORT.md add SUPPORT file 10 months ago
go.mod Merge branch 'master' into shared/edgy 2 months ago
go.sum upgrading envoy, this time with extra edgeyness 1 month ago
kconf.b64 Test kubernaut 10 months ago
pytest.ini Have 'make pytest' run pytest in the right place to find pytest.ini. Use pytest.ini to restrict pytest to just our tests. Show the list of failures and xfailures at the end. 3 months ago
templates rm docs/yaml && mv templates docs/yaml && ln -s docs/yaml/ templates 10 months ago
watt.json conitnue 10 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.