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.
Shubham bddf9bd2f1
Merge pull request #1962 from datawire/rel/0.84.1
11 hours ago
.github Turn on the Stale bot 4 months ago
api make docker-update-base 1 week ago
build-aux (apro) docker.mk: Fix the APro build having stale .stamp files laying around 2 days ago
build-aux-local release.mk: Don't update AWS until the Docker image is pushed 1 day ago
builder Fix permissions of /ambassador to allow running as non-root without overriding AMBASSADOR_CONFIG_BASE_DIR. Thanks to @dmayle for the catch! 14 hours ago
cmd fixup! k8sregistryctl 5 days ago
cxx envoy.mk: Set ENVOY_COMPILATION_MODE=opt by default 2 days ago
demo Finish doc changes for dropping demo.getambassador.io. 6 months ago
deployments/statsd-sink Code reorganization 2 weeks ago
docker Move test/services/*/ → docker/test-*/ # for clarity 3 days ago
docs Ambassador 0.84.1 release 12 hours ago
internal/pkg move teleproxy source code from teleproxy subdirectory and rename imports 1 week ago
k8s initial import of new build machinery, tests pass locally, but CI still needs to be updated 1 week ago
pkg Merge branch 'lukeshu/merge-prep2' into lukeshu/final4 2 days ago
python Update test_docker.py to test the case of non-root without overriding AMBASSADOR_CONFIG_BASE_DIR 13 hours ago
releng Fix travis-script.sh 2 days ago
scripts/devloop-helpers Code reorganization 2 weeks ago
teleproxy-old mv teleproxy teleproxy-old # and clean up 5 days ago
test/attic Pin to zipkin :2.17 instead of :latest 3 days ago
tools/sandbox Pin to zipkin :2.17 instead of :latest 3 days ago
.dockerignore Move all of the Envoy stuff to /cxx/ 1 week ago
.editorconfig Add a .editorconfig file with indentation settings 2 months ago
.gitignore .gitignore: Ignore the `update-aws` files 1 day ago
.nvmrc Add Netlify 2 years ago
.travis.yml Merge branch 'lukeshu/merge-prep2' into lukeshu/final4 2 days ago
BUILDING.md Merge branch 'lukeshu/merge-prep2' into lukeshu/final4 2 days ago
CHANGELOG.md Ambassador 0.84.1 release 12 hours ago
LICENSE Add LICENSE and update .gitignore 2 years ago
Makefile Avoid doing a docker-rebuild in `make release{,-ea,-rc}` 1 day ago
Makefile.old Merge branch 'lukeshu/merge-prep2' into lukeshu/final4 2 days ago
README.md update w new features 3 months ago
RELEASING.md Update RELEASING.md to use a pull-request-based process, rather than just committing to master. 13 hours ago
SUPPORT.md add SUPPORT file 7 months ago
go.mod Merge branch 'lukeshu/merge-prep2' into lukeshu/final4 2 days ago
go.sum Integrate teleproxy.git in to the build 4 days ago
kconf.b64 Test kubernaut 6 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. 2 days ago
templates rm docs/yaml && mv templates docs/yaml && ln -s docs/yaml/ templates 7 months ago
watt.json conitnue 7 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.