To follow step-by-step guidance for this task directly in the Google Cloud console, click 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.
- 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.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Cloud Workstations API.
-
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:
-
Cloud Workstations are hosted on VMs booted from Compute Engine's preconfigured public
Container-Optimized OS (COS)
images. If the
constraints/compute.trustedimageProjects
organization policy constraint is enforced, you must set image access constraints to allow users to create boot disks fromprojects/cos-cloud
or all public images. -
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:
In the console, navigate to the Cloud Workstations > Cluster management page.
From the workstations Cluster management page, click add_boxCreate.
In the Name field, enter a name for your workstation cluster.
Select the Region that is closest to you.
Optional: To create your workstations inside a VPC, expand the Network settings section and select your custom network.
In the Network field, enter the name for your network—for example,
test-network
.In the Subnetwork field, enter the name for your subnetwork—for example,
test-subnetwork
.In the Gateway type section, select Public gateway or Private gateway.
To make your workstations accessible from public networks, select Public gateway.
If you require data residency for data in transit, select Private 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
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:
- In the Google Cloud console, go to Cloud Workstations > Clusters.
- Select the checkbox beside the cluster that you want to delete.
- Click themore_vertMore options menu and select Delete to delete the selected workstation cluster.
What's next
Learn more about configuring options in your workstation configuration.
Use the Cloud Workstations base editor.