ContextQMD
Back to Microservices Demo

Online Boutique quickstart

docs/cloudshell-tutorial.md

3-demo-concise4.8 KB
Original Source

Online Boutique quickstart

This tutorial shows you how to deploy Online Boutique to a Kubernetes cluster.

You'll be able to run Online Boutique on:

Let's get started!

Kubernetes cluster setup

Set up a Kubernetes cluster using the instructions below for either minikube or GKE.

Minikube instructions

Minikube creates a local Kubernetes cluster on Cloud Shell.

  1. Click <walkthrough-editor-spotlight spotlightId="minikube-status-bar">minikube</walkthrough-editor-spotlight> on the status bar located at the bottom of the editor window.

  2. The command palette will prompt you to choose which minikube cluster to control. Select minikube and, in the next prompt, click Start if the cluster has not already been started.

  3. If prompted, authorize Cloud Shell to make a GCP API call with your credentials.

It may take a few minutes for minikube to finish starting.

Once minikube has started, you're ready to move on to the next step.

GKE instructions

In order to create a GKE cluster, you'll need to create a Google Cloud project or use an existing project.

  1. Access the command palette by going to View > Find Command.

  2. Run the command "Cloud Code: Create GKE cluster".

  3. Select your GCP project.

  4. Apply the following configurations in the GKE wizard:

  • Zone: us-central1-b
  • Cluster name: onlineboutique
  • Node count: 4
  • Machine type: e2-standard-2
  1. Click Create Cluster. Once your cluster has been created successfully, you can move on to the next step.

Run on Kubernetes

Now you can run Online Boutique on your Kubernetes cluster!

  1. Launch the <walkthrough-editor-spotlight spotlightId="cloud-code-status-bar">Cloud Code menu</walkthrough-editor-spotlight> from the status bar and select <walkthrough-editor-spotlight spotlightId="cloud-code-run-on-k8s">Run on Kubernetes</walkthrough-editor-spotlight>.

  2. If prompted to select a Skaffold Profile, select [default].

  3. Select Yes to confirm your current context.

  4. If you're using a GKE cluster, you'll need to confirm your container image registry.

  5. If prompted, authorize Cloud Shell to make a GCP API call with your credentials.

Cloud Code uses configurations defined in <walkthrough-editor-open-file filePath="skaffold.yaml">skaffold.yaml</walkthrough-editor-open-file> to build and deploy the app. It may take a few minutes for the deploy to complete.

  1. Once the app is running, the local URLs will be displayed in the <walkthrough-editor-spotlight spotlightId="output">Output</walkthrough-editor-spotlight> terminal.

  2. To access your Online Boutique frontend service, click on the <walkthrough-spotlight-pointer spotlightId="devshell-web-preview-button" target="cloudshell">Web Preview button</walkthrough-spotlight-pointer> in the upper right of the editor window.

  3. Select Change Port and enter '4503' as the port, then click Change and Preview. Your app will open in a new window.

Stop the app

To stop running the app:

  1. Go to the <walkthrough-editor-spotlight spotlightId="activity-bar-debug">Debug view</walkthrough-editor-spotlight>

  2. Click the Stop icon.

  3. Select Yes to clean up deployed resources.

You can start, stop, and debug apps from the Debug view.

Clean up

If you've deployed your app to a GKE cluster in your Google Cloud project, you'll want to delete the cluster to avoid incurring charges.

  1. Navigate to the <walkthrough-editor-spotlight spotlightId="activity-bar-cloud-k8s">Cloud Code - Kubernetes view</walkthrough-editor-spotlight> in the Activity bar.

  2. Under the <walkthrough-editor-spotlight spotlightId="cloud-code-gke-explorer">Google Kubernetes Engine Explorer tab</walkthrough-editor-spotlight>, right-click on your cluster and select Delete Cluster.

Conclusion

<walkthrough-conclusion-trophy></walkthrough-conclusion-trophy>

Congratulations! You've successfully deployed Online Boutique using Cloud Shell.

<walkthrough-inline-feedback></walkthrough-inline-feedback>

What's next?

Try other deployment options for Online Boutique:

  • Istio/Cloud Service Mesh: <walkthrough-editor-open-file filePath="./kustomize/components/service-mesh-istio/README.md">See these instructions</walkthrough-editor-open-file>.

Learn more about the Cloud Shell IDE environment and the Cloud Code extension.