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 0d9b961097
Merge pull request #1772 from datawire/flynn/dev/schema-tweak
1 day ago
.github Turn on the Stale bot 2 months ago
ambassador Update schemas to support the generation count, since we need it for Knative. 2 days ago
build-aux build-aux: Add var.mk 1 month ago
demo Finish doc changes for dropping demo.getambassador.io. 5 months ago
docs Make Knative great again 2 days ago
flynn-devloop-stuff Don't require AMBASSADOR_ENABLE_ENDPOINTS, but support AMBASSADOR_DISABLE_ENDPOINTS. 4 months ago
go/apis/envoy Bump ENVOY_COMMIT to include security patches 2 weeks ago
kat Short delay after all the requirements are done, checking for a race. 2 days ago
multi move multi to top level of repo 10 months ago
releng Save logs for all kat phases. Push a tarball of artifacts to S3 on test failure, rather than trying to dump them all to stdout. 2 days ago
statsd-sink Specify that statsd-exporter should use port 8125 rather than the default (9125) 2 months ago
test-services The stats-test-service is about to be used; commit it as a test service that we use. 2 months ago
unused-e2e The stats-test-service is about to be used; commit it as a test service that we use. 2 months ago
.dockerignore Support correctly updating the status of Knative clusteringresses, since Knative 0.8.0 requires this and 0.7.1 wants it (Knative ingresses aren't quite working yet) 2 days ago
.editorconfig Add a .editorconfig file with indentation settings 2 weeks ago
.gitignore Revert "Revert "Makefile base/cache image creation clean-up (part 2)"" 3 weeks ago
.nvmrc Add Netlify 2 years ago
.travis.yml Makefile, Travis et al.: Rethink credentials management 2 weeks ago
BUILDING.md Revert "Revert "Makefile base/cache image creation clean-up (part 2)"" 3 weeks ago
CHANGELOG.md Ambassador 0.75.0 release 1 week ago
Dockerfile Support correctly updating the status of Knative clusteringresses, since Knative 0.8.0 requires this and 0.7.1 wants it (Knative ingresses aren't quite working yet) 2 days ago
Dockerfile.base-envoy Dockerfile.base-envoy: Pin to Alpine 3.9 2 weeks ago
Dockerfile.base-go Revert "Revert "Makefile base/cache image creation clean-up (part 2)"" 3 weeks ago
Dockerfile.base-py Revert "Revert "Makefile base/cache image creation clean-up (part 2)"" 3 weeks ago
LICENSE Add LICENSE and update .gitignore 2 years ago
Makefile Merge pull request #1768 from datawire/lukeshu/ci-no-compile-envoy 2 days ago
README.md update w new features 1 month ago
RELEASING.md Tweaks to RELEASING 2 weeks ago
SUPPORT.md add SUPPORT file 5 months ago
VERSION-template.py Revamp version stuff Yet Again, make the AmbScout class function, and let the CLI use it. 10 months ago
dev-requirements.txt Giving up on asyncio -- use pexpect instead. FFS. 1 month ago
go.mod Switch to kat-client 1.4.4 to fix GRPC-web decode bug. 1 month ago
go.sum Switch to kat-client 1.4.4 to fix GRPC-web decode bug. 1 month ago
kconf.b64 Test kubernaut 5 months ago
log.txt Makefile: Improve Envoy workflow 2 months ago
pytest.ini Regression test for running Ambassador in Docker 2 months ago
templates rm docs/yaml && mv templates docs/yaml && ln -s docs/yaml/ templates 5 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.