2 min • read

Service Preview has been replaced by Telepresence, these docs will remain as a historical reference. Learn more about Telepresence or go to the quick start guide.

Introduction to Service Preview

One of the challenges in adopting Kubernetes and microservices is the development and testing workflow. Creating and maintaining a full development environment with many microservices and their dependencies is complex and hard.

Service Preview, based on Telepresence, enables different developers to run different virtual versions of the same microservice. These virtual versions are deployed on your CI system or local development infrastructure, enabling fast development and testing workflows.

Getting started

To get started, follow the installation instructions, and try the tutorial.

Service Preview runs on Mac OS X, Linux, and Windows via WSL2.

Service Preview Components


There are three main components to Service Preview:

  1. The Traffic Agent, which controls routing to the microservice. The Traffic Agent is deployed as a sidecar on the same pod as your microservice (behind the scenes, it's a special configuration of the basic Ambassador Edge Stack image). The Traffic Agent sidecar can be manually configured or automatically injected by the Ambassador Injector in any pod with a specific annotation.

  2. The Traffic Manager, which manages the different instances of the Traffic Agent, and is deployed in the cluster.

  3. The Edge Control local client, which runs in your local environment (Linux or Mac OS X). The client is the command line interface to the Traffic Manager.

See the Service Preview reference for more information on how these components work.