---
layout: landing
title: Ambassador
permalink: /
---

<header class="hero">
  <div class="logo">
  <img src="{{site.baseurl}}/images/logo.png" style="width: 200px;">
  <h3>Ambassador</h3>
  <h4>API Gateway for Microservices</h4>
  </div>
</header>

<div class="container">
  <center><a class="button primary" href="/user-guide/getting-started.html"><span style="font-size: 200%;">Get started</span></a></center>
  <br><br>
</div>

<div class="container">
  <h5>
    <ul class="fa-ul">
      <li><i class="fa-li fa fa-cogs"></i><strong>Designed for microservices</strong> Built on the <a href="https://lyft.github.io/envoy/">Lyft Envoy L7 proxy</a>, Ambassador gives you advanced load balancing features (e.g., global rate limiting), first class HTTP/2 support, and robust TLS support.</li>
      <li><i class="fa-li fa fa-fighter-jet"></i><strong>Self-service</strong> Use a REST API to dynamically add/remove/configure services, instead of editing the Envoy configuration by hand.</li>
      <li><i class="fa-li fa fa-tachometer"></i><strong>Integrated monitoring</strong> Automatically collect statistics and send the data to your metrics system of choice.</li>
      <li><i class="fa-li fa fa-user-secret"></i><strong>Authentication</strong> Authenticate all requests before they are proxied to your back-end services using one of Ambassador's authentication plug-ins.</li>
    </ul></h5>
</div>

<div class="container">
  <header class="section-header">
  <h5><center><strong>It's easy to get started:</strong></center></h5>
  </header>
  <div class="row">
    <div class="one-half column">
      1. <strong>Add your API to Ambassador.</strong>
         <a href="/user-guide/getting-started.html">Install Ambassador on Kubernetes</a>, and add a new API mapping using the REST API. In this example, Ambassador creates a <a href="user-guide/mappings.html">mapping</a> called <code>user_map</code> that will route external requests from <code>/user/</code> to the <code>usersvc</code> running in Kubernetes.</li>
      </div>
      <div class="one-half column">
<pre><code>curl -XPOST -H "Content-Type: application/json" \
     -d '{ "prefix": "/user/", "service": "usersvc" }' \
     http://localhost:8888/ambassador/mapping/user_map</code></pre>
      </div>
  <div class="row">
    <div class="one-half column">
      2. <strong>Access your service.</strong> Make a request to Ambassador, and have it route the request directly to the usersvc service.
    </div>
    <div class="one-half column">
      <pre><code>curl http://localhost:8000/user/</code></pre>
    </div>
  </div>

</div>


<div class="container">
  <p style="text-align: center;">Ambassador is sponsored by Project Blackbird, helping you <a href="https://www.datawire.io">deploy microservices on Kubernetes in AWS</a> <img src="{{site.baseurl}}/images/blackbird.png" style="width: 4em; vertical-align: middle; align: right;"></p>
</div>