This guide illustrates how to use Amalgam8 for version and content-based routing using two demo applications. The guide is divided into two parts:

  1. Setup. This section provides step-by-step instructions on how to get the Amalgam8 control plane and the CLI installed and configured for different container runtimes locally (Docker, Kubernetes) as well as on PaaS environments like IBM Bluemix, Google Cloud Platform, etc.

  2. Example Apps: Two example applications are provided to illustrate various features of Amalgam8.

    1. Helloworld. A simple application with one microservice. We will use this example app to illustrate how Amalgam8 provides version-based routing with weighted load balancing between two different versions of the same microservice.

    2. Bookinfo. A polyglot application with 4 microservices written using Python, Ruby and Java. We will use this app to illustrate several features of Amalgam8 such as content-based routing across different microservice versions, internal release for QA testing, systematic resilience testing, and gradual release of new version using weighted load balancing.