Running a Kubernetes app

This page shows you how to get started quickly with Cloud Code.

You'll set up a new Kubernetes application using a starter 'Hello World' template, create a cluster, run your app on this cluster, debug your running code, view logs from your live application, and connect a terminal to your running container.

Creating a new Hello World app with Cloud Code

Before you begin

If you'd like to use Google Cloud, you'll need to create or select a Google Cloud project and enable billing on your project.

Installing Cloud Code

  1. Install Visual Studio Code on your machine, if you haven't already.

  2. For all Cloud platforms, install the Docker client (authenticated with your Docker registry) on the PATH of your machine (its installation folder should be visible under a directory in your PATH).

    • To check if you already have Docker installed, run docker -v.
    • If you're using Windows Home, see Install Docker Desktop on Windows Home.
    • If you're using WSL but cannot install Docker for Desktop, use minikube instead for local development with Cloud Code.

    Cloud Code automatically installs kubectl, Skaffold, and Cloud SDK.

  3. Install Cloud Code using one of the following options:

    • Open VS Code and install Cloud Code.
    • Open Visual Studio Code on your machine. Using the Extensions view Extension icon in VS Code (its square icon should be available on the left side taskbar), search for and then click the Cloud Code extension and then click Install.

    After the installation is complete, you'll see the Cloud Code Welcome page and a collection of built-in templates under Starter Apps, which you can use to quickly set up a new application.

    Cloud Code Welcome page

    Additionally, the Cloud Code status bar, stocked with common Cloud Code actions, is now available within the VS Code Status Bar.

    Cloud Code status bar

Creating an application

  1. From the command palette (Cmd/Ctrl+Shift+P), run Cloud Code: New Application, choose Kubernetes Application, and then choose a Hello World app in the language you prefer.

    For example, choosing Node.js: Hello World creates a starter Node.js Hello World app.

  2. Save the new application.

    A notification confirms that your application has been created and a new window with your application opens.

Creating a GKE cluster

To create a Standard Google Kubernetes Engine (GKE) cluster, follow these steps:

  1. To open the Google Kubernetes Engine explorer , click the Cloud Code - Kubernetes Kubernetes Explorer icon, icon in the VS Code Activity bar on the left.
  2. If you haven't already logged in, to authenticate with the Cloud SDK, click Click here to log in to Google Cloud SDK.
  3. To create a new GKE cluster, in the header of the GKE explorer, click + (available on mouseover).
  4. Ensure you're creating your cluster in your default project.

  5. Fill out fields in the Create Cluster wizard and then click Create Cluster.

    In this example, Project ID is set using the default Project ID button, zone is set as us-central1-a, and cluster name is defined as my-first-cluster.

    Cluster creation takes a couple of minutes. After your cluster is created, it's listed in the GKE Explorer view Kubernetes Explorer icon.

    Creating a new cluster with the GKE explorer

Running your app

Running a dry-run of your configuration

If you'd like to check the validity of your app's configuration:

  1. Open the config file you want to validate in your IDE (for the Hello World app, config files are located under the kubernetes-manifests folder).

  2. Use Cloud Code: Dry-run current config for server-side validation or Cloud Code: Dry-run current config for client-side validation from the Command Palette (accessible from the Manage menu Manage icon).

    This runs kubectl apply -f dry-run=server (or kubectl apply -f dry-run=client, for the Client option) and displays successful validation (or an error message, if your config file isn't valid) as a toast notification.

    Dry-run commands listed from the command palette and Dry-run current config for server-side validation selected

Running and viewing your app

Now that you're all set up, you can run your application and view it live. Cloud Code watches your filesystem for changes so that you can edit and rerun your app in near real time.

To run your application, follow these steps:

  1. Use the Cloud Code status bar and select Run on Kubernetes.
  2. Confirm whether to use the current cluster context or switch to a different one.

  3. If prompted, choose an image registry to push the images to.

    An output window appears where you can track the progress of your running application. You'll also see a live stream of the logs from the running pods in the terminal output.

  4. After your application is running on Kubernetes, the output window displays an IP address. To use this linked IP address to access your application, press Ctrl/Cmd + click.

    Running the Hello World app

Troubleshooting tips

If you're using a pre-existing cluster, to get cluster credentials and add your cluster to kubectl, run the following command:

 gcloud container clusters get-credentials ${CLUSTER} --zone=${ZONE}

Alternatively, you can set your cluster as active and get cluster credentials using the GKE Explorer as follows:

  1. Navigate to the GKE Explorer (as a panel accessible in the Kubernetes explorer under the Cloud Code view Kubernetes Explorer icon).
  2. Right-click your cluster and then click Set as Active Cluster.

Debugging your app

To debug your application, follow these steps:

  1. Use the Cloud Code status bar and then select Debug on Kubernetes.

  2. If prompted, confirm whether to use the current cluster context or switch to a preferred one.

    Cloud Code uses the cloudcode.kubernetes configurations in your .vscode/launch.json file to run your application and attach a debugger session to it.

    Cloud Code then builds your containers, pushes them to the registry, applies Kubernetes configurations to the cluster, and returns the IP address that you can use to browse your live application.

  3. Before your debugger session is attached, you're prompted to confirm or enter the directory in the remote container where the program to debug is found or press ESC to skip debugging the container.

  4. To add a breakpoint to line #9, open src/app.js and then click in the editor margin.

    Red filled circles signify active breakpoints, while gray hollow circles signify disabled breakpoints. For finer breakpoint control, you can use the Breakpoints section in VS Code's Debug view.

    Breakpoints section in the left hand panel of Debug View that allows adding, removing, and disabling breakpoints

    When you send a new request to your application, the debugger pauses at the first active breakpoint.

    In the following sample, under Local in the Variables section, note that the value of res._contentLength; for Hello, world! is 13.

    App paused at breakpoint and variables and call stack sections populated with values in scope

  5. Edit the string being sent in line #8 to Hello, goodbye! and then restart the Debug on Kubernetes action.

    After the app is rebuilt and redeployed, note the updated value of res._contentLength.

    App paused at breakpoint with updated values

Viewing logs

In addition to seeing a live stream of the logs from running pods in the terminal output from your running application, you can also view logs with the Log Viewer that comes with Cloud Code.

To view logs, follow these steps:

  1. Launch the Log Viewer by typing Cloud Code: View Logs using the Command Palette (accessible with Ctrl/Cmd+Shift+P or through the Manage menu marked with a gear icon Manage icon).

  2. Search for the running app, in this case nodejs-hello-world, to view logs from using the deployment field in the Log Viewer search box.

    Viewing logs by setting the deployment field within the Log Viewer search box to 'nodejs-hello-world'.

Bonus: Opening a terminal in your container

To open a terminal in your container, follow these instructions:

  1. Navigate to the Kubernetes Explorer.
  2. Select the cluster and, from the underlying Pods section, the pod you'd like to connect to.
  3. Under your specified pod, expand your Containers section.

  4. Right-click the container in which you'd like to open a terminal and then click Get Terminal.

    This launches a terminal; you now have access to a shell inside the running container!

    Opening a terminal for the specified pod

Cleaning up

After you terminate your application, all Kubernetes resources deployed during the run are deleted automatically.

To avoid incurring charges to your account for other resources used in this quickstart, be sure to delete the cluster and project you created.

If you're using Google Cloud and would like to delete just your cluster, you can do so by:

  • In the Kubernetes explorer under the Cloud Code view Kubernetes Explorer icon, right-click the cluster you'd like to delete from the Google Kubernetes Engine Explorer pane and then click Delete cluster.

To delete your project (and associated resources, including any clusters):

  1. Go to the Projects page in the Cloud Console:

    Go to the Projects page

  2. Select the project you created for this quickstart and then click the trash can icon next to it to delete it.

    This shuts down the project and schedules it for deletion.

What's next