Skip to main content

GCP — Manual Workspace Creation

You'll create a Databricks workspace on GCP in ~10 min.

Prereqs: GCP project, Databricks account console

What you'll build​

A Databricks workspace deployed into your GCP project using the Databricks account console. The wizard handles service accounts, GCS storage, and workspace configuration.

Prerequisites​

  • A GCP project with Owner permissions.
  • A Databricks account with account-admin privileges.
  • Know which GCP project the workspace belongs to (e.g., dev workspace in the dev project).

Steps​

1. Create the development workspace​

Follow the video tutorial below. When deploying, select the correct GCP project for the target environment.

warning

Deploy each workspace into the matching GCP project. A dev workspace in a production project creates confusion and makes cleanup harder.

2. Repeat for staging and production​

Run through the same process for each additional workspace, selecting the corresponding GCP project each time.

Verify​

  1. Log in to the Databricks account console.
  2. Navigate to Workspaces and confirm the new workspace shows a Running status.
  3. Click the workspace URL to open it and verify you can reach the landing page.

Troubleshoot​

Workspace stuck in provisioning

Check the GCP console for any API enablement issues. The Databricks workspace requires several GCP APIs (Compute Engine, Cloud Storage, IAM) to be enabled on the project.

Permission errors during creation

Verify the authenticated account has Owner permissions on the target GCP project. Viewer or Editor roles are not sufficient for initial workspace creation.

Next​