Skip to main content

Create a workspace using the AWS Quickstart (Recommended)

note

The AWS Quick Start for workspace deployment is only available for pay-as-you-go accounts.

This article explains how to create a Databricks workspace using the AWS Quick Start (CloudFormation template). Using the AWS Quick Start is the recommended approach for creating workspaces because it creates and configures the AWS resources for you.

If you want to manually create your workspace resources, see Manually create a workspace (existing Databricks accounts) or Create a workspace using the Account API. You can also use Terraform to automate workspace creation. See Create Databricks workspaces using Terraform.

Requirements​

To complete the instructions in this article, you need the following:

  • The account admin role in your Databricks account.
  • Permissions in your AWS account to provision IAM roles and S3 buckets.
  • An available VPC and NAT gateway in your AWS account in the workspace's region. You can view your available quotas and request increases using the AWS Service Quotas console.
  • Your AWS account must have the STS endpoint activated for us-west-2. For details, see the AWS documentation.

Use AWS Quickstart to create a Databricks workspace​

Use the following instructions to create a workspace with AWS Quick Start.

  1. In your account console, click the Workspaces tab.

  2. Click the Create workspace dropdown and select Quickstart (recommended).

  3. On the Let's set up your workspace page, enter the following:

    • A user-friendly Workspace name.
    • The AWS region you want to host your Databricks workspace in (typically, choose the region closest to your primary work location).

  4. Click Start quickstart to take you to the AWS Quick Start form, which opens in a new tab.

  5. On the Quick Start form, which is labeled Quick create stack:

    1. Select the I acknowledge that AWS CloudFormation might create IAM resources with custom names option.

    All other fields are prepopulated. You can rename these resources if you want, but you must adhere to the strict AWS naming rules for each resource or your deployment will fail.

  6. Click Create stack to open the databricks-workspace-stack page, where you can see the workspace being created.

    While the workspace is being created, databricks-workspace-stack status shows as CREATE_IN_PROGRESS.

    Databricks workspace stack in progress

    When the workspace creation is complete, the status shows as CREATE_COMPLETE.

    Databricks workspace stack create complete

    If there are any issues, workspace creation automatically rolls back. Go to the Events tab for details. You can consult the Databricks Community forums for common errors and solutions.

  7. When the databricks-workspace-stack status shows as CREATE_COMPLETE, return to the Workspaces dashboard in the Databricks account console to view your new workspace.

    note

    You will also receive an email from noreply@databricks.com that includes a link to your new workspace.

  8. Click Open next to the new workspace to launch your workspace.

  9. Select your primary use case then click Finish.

note

If you subscribed to Databricks through AWS Marketplace, Databricks usage takes 24 hours to appear in the AWS Billing & Cloud Management dashboard. Usage appears in the Databricks account console after one hour. To analyze usage, view the Usage dashboard in the account console.

Last updated on