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 14230ec4a7
Merge pull request #2517 from datawire/pr/v1.3.2
16 hours ago
.ci Fix submodule directory location 2 weeks ago
.github Update PR template 2 weeks ago
api Get rid of bogus `json:",inline"` tags 1 week ago
build-aux (apro) docker.mk: Fix the APro build having stale .stamp files laying around 5 months ago
build-aux-local Merge pull request #2486 from datawire/pr/v1.3.1 1 week ago
builder Use the official KIND 1.18 image Wait for the /check_ready URL of Ambassador 3 days ago
cmd Merge pull request #2517 from datawire/pr/v1.3.2 16 hours ago
cxx Bump BASE_ENVOY_RELVER 1 month ago
demo Finish doc changes for dropping demo.getambassador.io. 1 year ago
deployments/statsd-sink Code reorganization 6 months ago
docker Have the Envoy base image be useful for debugging 1 month ago
docs Merge pull request #2470 from datawire/shared/ingressv1 20 hours ago
internal/pkg Move locking into update loop to avoid blocking DNS 2 weeks ago
k8s fix dockerfile shim 5 months ago
pkg Get rid of bogus `json:",inline"` tags 1 week ago
python Merge pull request #2470 from datawire/shared/ingressv1 20 hours ago
releng Run the Ingress conformance tests in Travis 1 week ago
scripts/devloop-helpers Have a "make pytest-gold" target to update the gold files 1 month ago
teleproxy-old mv teleproxy teleproxy-old # and clean up 5 months ago
test/attic Move test/services/*/ → docker/test-*/ # for clarity 5 months ago
tools/sandbox Makefile: Clean up `protoc` rules, get it generating Envoy .pb.go files again 5 months ago
.dockerignore Move all of the Envoy stuff to /cxx/ 5 months ago
.editorconfig Removed trailing blank lines 3 months ago
.gitignore build-system: Let me re-generate just a subset of the protobuf stuff 1 week ago
.nvmrc Add Netlify 2 years ago
.travis.yml Comment trigger for CI 2 weeks ago
BUILDING.md Added DEVELOPER.md and populated it with an updated version of the content from BUILDING.md 1 month ago
CHANGELOG.md Merge pull request #2517 from datawire/pr/v1.3.2 16 hours ago
DEVELOPING.md Added DEVELOPER.md and populated it with an updated version of the content from BUILDING.md 1 month ago
LICENSE Add LICENSE and update .gitignore 2 years ago
Makefile Remove ambassdador-docs subtree commands 2 weeks ago
Makefile.old Merge branch 'lukeshu/merge-prep2' into lukeshu/final4 5 months ago
README.md Added DEVELOPER.md and populated it with an updated version of the content from BUILDING.md 1 month ago
RELEASING.md Address PR comments. Thanks for the catches! 2 months ago
SUPPORT.md add SUPPORT file 1 year ago
go.mod removed chalk from required modules 2 days ago
go.sum go.sum - removed chalk refs 2 days ago
kconf.b64 Test kubernaut 1 year ago
post-compile.sh Add support for additional installers in builder and prod image 3 weeks 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. 5 months ago
templates rm docs/yaml && mv templates docs/yaml && ln -s docs/yaml/ templates 1 year ago
watt.json conitnue 1 year 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 serves as an Envoy-based 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:

The Ambassador Edge Stack is a superset of the Ambassador API Gateway that provides additional functionality including OAuth/OpenID Connect, advanced rate limiting, Swagger/OpenAPI support, integrated ACME support for automatic TLS certificate management, and a UI. For more information, visit https://www.getambassador.io/editions/.