This demo expects a running kubernetes environment with helm installed. To setup it fast and easily (non-production), the following commands can be used:

minikube start --kubernetes-version=v1.14.2 -p ambassador
kubectl apply -f 01_rbac_helm.yaml
helm init

In this example, we're using minikube. You can check kubernetes official docs, for more details on how to install it.

The following steps install Ambassador using the official helm charts:

kubectl create namespace ambassador
helm upgrade --install --namespace=ambassador --values=02_ambassador_values.yaml ambassador stable/ambassador

To check ambassador deployment status, you can check for the resources status:

kubectl get all -n ambassador

The following command will map ambassador admin ui for your computer:

kubectl port-forward -n ambassador svc/ambassador-admins 8877

The interface is accessible now here and it's used mainly for debugging purposes.

We're going to deploy a simple-service and its mappings for ambassador:

kubectl apply -f 03_deploy_v1.yaml
kubectl apply -f 04_mapping_v1.yaml

Again, in the admin ui address is possible to see Ambassador created mapping resources.

In order to access the simple-service trough Ambassador it's necessary to map its service to our computer as well. The following command it's just necessary because this demo it's not running on a cloud environment. On a cloud environment we'd be accessing it trough a Cloud Load Balancer solution.

kubectl port-forward svc/ambassador -n ambassador 8000:80

Test the access to simple-service with a simple http request: curl https://localhost:8000/simple-service/v1/

Now, we're going to create a new version of the same service and its mappings:

kubectl apply -f 05_deploy_v2.yaml
kubectl apply -f 06_mapping_v2.yaml

Again, in the admin ui address is possible to see Ambassador created mapping resources. Test the access to simple-service v2 with a simple http request: curl https://localhost:8000/simple-service/v2/

This example, try to represent a simple and manually Canary Release:

kubectl apply -f 07_mapping_weight.yaml

The admin ui will present to mappings with its defined weights. We can test it making multiple http requests to the mapped endpoint:

for i in {1..20}; do curl https://localhost:8000/simple-service/; echo; done

Let's edit the file 07_mapping_weight.yaml changing the mapping weights. This action could be performed since the team is confident with the change, increasing the percentage of clients accessing it. After it, apply this changes running kubectl apply -f 07_mapping_weight.yaml again.

Then check if the applied configs are reflected on the admin ui. Once again, it's possible to check the configuration running multiple requests to the service:

for i in {1..20}; do curl https://localhost:8000/simple-service/; echo; done

As a final example, it's possible to route traffic based on the request's headers. Apply the following mapping example:

kubectl apply -f 08_mapping_header.yaml

Check if the mapping is on the admin ui and modify your http request to include the header defined on 08_mapping_header.yaml:

for i in {1..20}; do curl -H "am-i-a-test: true" https://localhost:8000/simple-service/; echo; done

Refer to the Ambassador official documentation for more features and details using Ambassador.

minikube delete -p ambassador