Skip to content
open source Kubernetes-native API gateway for microservices built on the Envoy Proxy
Python Go Shell Makefile JavaScript HTML Dockerfile
Branch: master
Clone or download

Latest commit

Latest commit 8e5d3b0 May 29, 2020

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.ci Undo ToC tweaks for 1.5 May 28, 2020
.github Add a note to the PR template about build changes. Apr 10, 2020
api Add PreviewURLSpec to the Host CRD's protobuf and run "make generate" May 24, 2020
build-aux-local Migrate Envoy from 1.13.0 to Datawire/Envoy 1.14.1 which is based on … May 6, 2020
build-aux quay.io -> docker.io in the rest of the docs May 22, 2020
builder pinning rollup versions May 24, 2020
cmd Merge branch 'master' into story/ez-service-preview May 25, 2020
cxx Merge commit '23da160033dbdaaaa379a3d49034fed7031147ee' into from-oss May 20, 2020
demo Finish doc changes for dropping demo.getambassador.io. Mar 27, 2019
deployments/statsd-sink Code reorganization Oct 4, 2019
docker Have the Envoy base image be useful for debugging Feb 21, 2020
docs Undo ToC tweaks for 1.5 May 28, 2020
internal/pkg Merge commit '05bc35a288bcd87857af84e0b210429322bf193e' into flynn/de… May 27, 2020
k8s fix dockerfile shim Oct 25, 2019
pkg Be explicit about dockerio/ for images May 27, 2020
python Merge pull request #1420 from datawire/story/regex_rewrite_nits May 27, 2020
releng Switch to using docker login with just the domain part of the registry May 21, 2020
scripts Be explicit about dockerio/ for images May 27, 2020
teleproxy-old Integrate teleproxy.git in to the build Oct 15, 2019
test/attic Be explicit about dockerio/ for images May 27, 2020
tools/sandbox quay.io -> docker.io in the rest of the docs May 22, 2020
.dockerignore Move all of the Envoy stuff to /cxx/ Oct 11, 2019
.editorconfig Removed trailing blank lines Dec 23, 2019
.gitignore added .golangci.yml to .gitignore for now Apr 15, 2020
.nvmrc Add Netlify Jul 19, 2017
.travis.yml Update Travis to publish 1.5 docs changes. May 28, 2020
BUILDING.md Added DEVELOPER.md and populated it with an updated version of the co… Feb 29, 2020
CHANGELOG.md Update for v1.5.0 May 28, 2020
DEVELOPING.md Merge commit '6fcd9152a6a456348065ded17c531195838a8263' into flynn/de… May 19, 2020
LICENSE Add LICENSE and update .gitignore May 5, 2017
Makefile Remove ambassdador-docs subtree commands Mar 18, 2020
Makefile.old Merge branch 'lukeshu/merge-prep2' into lukeshu/final4 Oct 17, 2019
README.md First chunk of changes off of quay.io back to DockerHub May 19, 2020
RELEASING.md Next tranche of DockerHub changes -- this is about testing before fli… May 20, 2020
SUPPORT.md add SUPPORT file Mar 8, 2019
go.mod Merge commit '6fcd9152a6a456348065ded17c531195838a8263' into flynn/de… May 19, 2020
go.sum go mod vendor May 21, 2020
kconf.b64 Test kubernaut Mar 26, 2019
post-compile.sh Add support for additional installers in builder and prod image Mar 6, 2020
pytest.ini Have 'make pytest' run pytest in the right place to find pytest.ini. … Oct 17, 2019
templates rm docs/yaml && mv templates docs/yaml && ln -s docs/yaml/ templates Mar 18, 2019
watt.json Integrate teleproxy.git in to the build Oct 15, 2019

README.md

Ambassador Build Status Docker Repository Docker Pulls Join Slack

==========

Ambassador API Gateway is an open-source Kubernetes-native API Gateway + Layer 7 load balancer + Kubernetes Ingress built on Envoy Proxy. The Ambassador Edge Stack is a complete superset of the OSS Ambassador API Gateway that offers additional functionality. Ambassador is designed to easily expose, secure, and manage traffic to your Kubernetes microservices of any type. Ambassador was built around the ideas of self-service (enabling GitOps-style management) and comprehensiveness (so it works with your situations and technology solutions).

The Ambassador API Gateway enables its users to:

See the full list of features here. Learn Why the Ambassador Edge Stack?

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 just three steps. Follow the instructions here: https://www.getambassador.io/docs/latest/tutorials/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.

For other common questions, view this FAQ page.

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/.

You can’t perform that action at this time.