How-to guides

These guides are designed to help users quickly accomplish common tasks. The guides assume a certain level of understanding of Emissary. Many of these guides are contributed by third parties; we welcome contributions via Pull Request at https://github.com/emissary-ingress/emissary.

Integrating with Service Mesh. Emissary natively integrates with many service meshes.
Distributed tracing. Emissary natively supports a number of distributed tracing systems to enable developers to visualize request flow in microservice and service-oriented architectures.
- Datadog
- Zipkin
Monitoring. Emissary integrates with a number of different monitoring/metrics providers.
- Prometheus
Developing Custom Filters
Frameworks and Protocols. Emissary supports a wide range of protocols and cloud-native frameworks.
Security. Emissary supports a number of strategies for securing Kubernetes services.
- Protecting the Diagnostics Interface
- HTTPS and TLS termination
- Certificate Manager can be used to automatically obtain and renew TLS certificates; Ambassador Edge Stack natively integrates this functionality.
- Client Certificate Validation
- Basic Authentication is a tutorial on how to use the external authentication API to code your own authentication service.
- Basic Rate Limiting

Active Health Checking

Basic Authentication

Basic Rate Limiting

Client certificate validation

Configuring Emissary Communications

Consul integration

Developing custom filters for routing

Distributed Tracing

Distributed Tracing with Datadog

Distributed Tracing with OpenTelemetry and Lightstep

Distributed tracing with Zipkin

ExternalDNS

gRPC

HTTP/3 support for Azure Kubernetes Service (AKS)

How to configure HTTP/3 support for Azure Kubernetes Service (AKS). This guide shows how to setup the LoadBalancer service for AKS to support both TCP and UDP communications.

HTTP/3 support for Google Kubernetes Engine (GKE)

How to configure HTTP/3 support for Google Kubernetes Engine (GKE). This guide shows how to setup the LoadBalancer service for GKE to support both TCP and UDP communications.

HTTP/3 with Amazon Elastic Kubernetes Service (EKS)

How to configure HTTP/3 support for Amazon Elastic Kubernetes Service (EKS). This guide shows how to setup the LoadBalancer service for EKS to support both TCP and UDP communications.

Istio

Knative

Linkerd 2

A guide to using Linkerd 2 Auto-Inject to mesh a service and using Emissary to dynamically route requests to that service.

Mapping resource

Emissary uses the Mapping resource to map a resource, like a URL prefix, to a Kubernetes service or web service.