Version 1.7

Deploying the Online Boutique sample application on Anthos Service Mesh

This guide explains how to install the Online Boutique sample application to demonstrate Anthos Service Mesh.

Prerequisites

This guide assumes that you have:

Downloading and deploying the sample

  1. Download the sample using kpt:

    kpt pkg get \
    https://github.com/GoogleCloudPlatform/microservices-demo.git/release \
    online-boutique
    
  2. Create a namespace for the application:

    kubectl create namespace demo
    
  3. Enable automatic sidecar injection (auto-injection). Use the following command to locate the label on the istiod service, which contains the revision label value to use in later steps.

    kubectl -n istio-system get pods -l app=istiod --show-labels
    

    The output looks similar to the following:

    NAME                                READY   STATUS    RESTARTS   AGE   LABELS
    istiod-asm-173-6-5788d57586-bljj4   1/1     Running   0          23h   app=istiod,istio.io/rev=asm-173-6,istio=istiod,pod-template-hash=5788d57586
    istiod-asm-173-6-5788d57586-vsklm   1/1     Running   1          23h   app=istiod,istio.io/rev=asm-173-6,istio=istiod,pod-template-hash=5788d57586
    

    In the output, under the LABELS column, note the value of the istiod revision label, which follows the prefix istio.io/rev=. In this example, the value is asm-173-6.

  4. Apply the revision label to the namespace. In the following command, REVISION is the value of the istiod revision label that you noted in the previous step.

    kubectl label namespace demo istio-injection- istio.io/rev=REVISION --overwrite
    

    You can ignore the message "istio-injection not found" in the output. That means that the namespace didn't previously have the istio-injection label, which you should expect in new installations of Anthos Service Mesh or new deployments. Because auto-injection fails if a namespace has both the istio-injection and the revision label, all kubectl label commands in the Anthos Service Mesh documentation include removing the istio-injection label.

  5. Deploy the sample to the cluster:

    kubectl apply -n demo -f online-boutique
    
  6. Find the external IP address of your application:

    kubectl get service frontend-external -n demo
    
  7. Visit the application on your browser to confirm installation:

    http://EXTERNAL_IP/
    

For GKE on Google Cloud, you can explore the Anthos Service Mesh observability features in the Cloud Console. Note that it can take up to 10 minutes for the topology graph to display the services in your mesh.

When you're finished exploring, remove the Online Boutique sample:

kubectl delete namespaces demo