Create a workstation cluster

Learn how to get started creating a workstation cluster with Cloud Workstations.

---

To follow step-by-step guidance for this task directly in the Google Cloud console, click Guide me:

Guide me

---

Before you begin

Before you begin using Cloud Workstations, be sure that you have the required permissions and that you complete these required setup steps. You can skip this section if you've already completed this setup.

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

5. Make sure that billing is enabled for your Google Cloud project.

6. Enable the Cloud Workstations API.

   Enable the API

7. Make sure that you have a Cloud Workstations Admin IAM role on the project so that you can create workstation configurations. To check your IAM roles in the Google Cloud console, go to the IAM page:

   Go to IAM

8. If the constraints/compute.trustedimageProjects organization policy constraint is enforced, you must add the project that the image comes from to the allowlist.
   • Without nested virtualization, you must grant your project permission to use Compute Engine VM images from the cos-cloud project.
   • With nested virtualization, you must grant your project permission to use Compute Engine VM images from the ubuntu-os-gke-cloud project.

   For more information, see Set image access constraints.

9. Optional: Enable the Container File System API to allow faster workstation startup.

   Enable the Container File System API

   For more information, see Reduce workstation startup time with Image streaming.

Create your workstation cluster

Workstation clusters define a group of workstations in a particular region, manage workstations during their lifecycle, and provide configurable network connectivity.

Workstation clusters aren't related to Google Kubernetes Engine (GKE) clusters.

To create a workstation cluster, follow these steps:

1. In the console, navigate to the Cloud Workstations > Cluster management page.

   Go to Cluster management

2. From the workstations Cluster management page, click add_boxCreate.

3. In the Name field, enter a name for your workstation cluster.

4. Select the Region that is closest to you.

5. Optional: To create your workstations inside a VPC, expand the Network settings section and select your custom network.

   1. In the Network field, enter the name for your network—for example, test-network.

   2. In the Subnetwork field, enter the name for your subnetwork—for example, test-subnetwork.

   3. In the Gateway type section, select Public gateway or Private gateway.

      • To make your workstations accessible from public networks, select Public gateway.

      • To allow ingress and egress to the workstations service from inside the selected network, select Private gateway. For more information about creating a private clusters, see Configure VPC Service Controls and private clusters

6. Click Create, which begins the cluster creation process.

Workstation cluster creation can take up to 20 minutes, but in most cases is only needed once.

Clean up

To delete a workstation cluster from the Google Cloud console:

1. In the Google Cloud console, go to Cloud Workstations > Clusters.
2. Select the checkbox beside the cluster that you want to delete.
3. Click themore_vertMore options menu and select Delete to delete the selected workstation cluster.

For more about deleting workstations, workstation configurations, and Google Cloud projects, see Delete resources.

What's next

• Learn more about configuring options in your workstation configuration.

• Use the Cloud Workstations base editor.