The Guestbook sample demonstrates how to deploy a Kubernetes application with a front end service and a back end service using the Cloud Code extension for Cloud Shell. When you run the application, Cloud Code uses skaffold under the hood to build an image and deploy the project's Kubernetes manifests. To learn more about Kubernetes, explore the Kubernetes overview.

• What's in this sample
• Getting Started
  1. Run the app locally with minikube
  2. Run the app remotely with Google Kubernetes Engine
     • Set up a GKE cluster
     • Deploy app to GKE
• Next steps
• Sign up for User Research

• skaffold.yaml - A schema file that defines skaffold configurations (skaffold.yaml reference)

• kubernetes-manifests/ - Contains Kubernetes YAML files for the Guestbook services and deployments, including:

  • guestbook-frontend.deployment.yaml - deploys a pod with the frontend container image
  • guestbook-frontend.service.yaml - creates a load balancer and exposes the frontend service on an external IP in the cluster
  • guestbook-backend.deployment.yaml - deploys a pod with the backend container image
  • guestbook-backend.service.yaml - exposes the backend service on an internal IP in the cluster
  • guestbook-mongodb.deployment.yaml - deploys a pod containing a MongoDB instance
  • guestbook-mongodb.service.yaml - exposes the MongoDB service on an internal IP in the cluster

1. To run your application, click on the Cloud Code status bar and select ‘Run on Kubernetes’.
   

2. Select ‘Run locally using minikube’ when prompted. Cloud Code runs your app in a local minikube cluster.
   

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

4. View the build progress in the OUTPUT window. Once the build has finished, click on the front end service's URL in the OUTPUT window to view your live application.
   

5. To stop the application, click the stop icon in the Debug Explorer.
   

1. From the command palette, run "Create GKE cluster".
   

2. Follow the steps to configure your cluster and click "Create Cluster". Once your cluster has been created, it will be displayed in the Google Kubernetes Engine Explorer.
   

3. Your new cluster will be set as the active cluster by default. To switch clusters, right click on a different cluster in the GKE Explorer and select “Set as Active Cluster”.
   

1. Click on the Cloud Code status bar and select ‘Run on Kubernetes’.

2. If prompted, confirm the current context and image registry.
   

3. View the build’s progress in the OUTPUT window. Once the build has finished, you can visit your deployed app by clicking the URL in the OUTPUT window.
   

• Install Cloud Code on your local VS Code or IntelliJ IDE
• Try debugging your app using Cloud Code
• Navigate the Kubernetes Engine Explorer
• Learn how to edit YAML files to deploy your Kubernetes app
• Configure an existing app to run on Cloud Code
• Enable Cloud APIs and client libraries
• Manage secrets with Secret Manager

For more Cloud Code tutorials and resources, check out Awesome Cloud Code!

We want to hear your feedback!

The Cloud Code team is inviting our user community to sign-up to participate in Google User Experience Research.

If you’re invited to join a study, you may try out a new product or tell us what you think about the products you use every day. At this time, Google is only sending invitations for upcoming remote studies. Once a study is complete, you’ll receive a token of thanks for your participation such as a gift card or some Google swag.

Sign up using this link and answer a few questions about yourself, as this will help our research team match you to studies that are a great fit.