You are viewing an outdated version of the documentation.

This documentation is for an older version (1.4.7) of Dagster. You can view the version of this page from our latest release below.

Getting started with Dagster Cloud#

Welcome to Dagster Cloud!

In this guide, we'll give you everything you need to get up and running with Dagster Cloud, including:

  • Creating your Dagster Cloud account
  • Selecting a deployment type
  • Deploying your code
  • Setting up CI/CD
  • Setting up environment variables and secrets

Let's get started!

Step 1: Create a Dagster Cloud account and organization#

If you don't already have a Dagster Cloud account, sign up for one before continuing.

You'll also be asked to create a Dagster Cloud organization. When your organization is created, a single deployment, named prod, will also be created. Refer to the Managing deployments guide for more information about deployments in Dagster Cloud.

Step 2: Select a deployment type#

In this step, you'll select the type of deployment you want to use: Serverless or Hybrid.

TypeHow it worksMay be a good fit if...
ServerlessIn a Serverless deployment, Dagster manages the infrastructure needed to run Dagster jobs. This means you don't need to spin up or manage any infrastructure. Refer to the Serverless deployment documentation for more info.
  • You want to try Dagster Cloud without a lot of time investment
  • You don't want to focus on infrastructure management
  • Your Dagster jobs aren't computationally expensive or memory intensive
HybridIn a Hybrid deployment, your Dagster code is executed in your infrastructure. The agent runs in your infrastructure, executes your code, and streams metadata about code execution and assets and jobs (for visualization) over HTTPS back to Dagster Cloud. Refer to the Hybrid deployment documentation for more info.

Dagster Cloud supports a variety of agents, each with its own prerequisites for setup. Refer to the Agent documentation for more info.

Select the deployment type you want to use and proceed to the next step. Note: If you find your deployment type isn't right for you, it can be changed at any time.

Step 3: Deploy your code#

Now that you've selected a deployment type, the next step is to tell Dagster Cloud the location of your Dagster code. In addition to this, you'll set up Continuous Integration (CI) and Continuous Deployment (CD). Once completed, Branch Deployments and continuous code location deployments will be enabled for your Dagster project.

The steps for accomplishing this vary depending on the deployment type you selected in the previous step:

Click the tab for your deployment type - Serverless or Hybrid - to view what's next.

Step 4: Set up environment variables and secrets#

Congrats! At this point, your Dagster Cloud deployment should be up and running. To ensure the external services you use in your Dagster project work correctly, start setting up your environment variables. Using environment variables, you can securely pass in sensitive info like passwords, API tokens, etc.

Next steps#

From here, you can: