Skip to main content

Managing full deployments in Dagster+

Full deployments are standalone environments, allowing you to operate independent instances of Dagster with separately managed permissions.

When a Dagster+ organization is created, a single deployment named prod will also be created. To create additional full deployments, you must sign up for a Pro plan.

Each full deployment can have one or multiple code locations.

Full deployments vs branch deployments

In Dagster+, there are two types of deployments:

  • Branch deployments, which are temporary deployments built for testing purposes. We recommend using branch deployments to test your changes, even if you're able to create additional deployments. Branch deployments are available for all Dagster+ users, regardless of plan.
  • Full deployments, which are persistent, fully-featured deployments intended to perform actions on a recurring basis.

This guide focuses on full deployments, hereafter referred to as deployments.

Viewing and switching deployments​

In Dagster+, you can view and switch between deployments using the deployment switcher:

The deployment switcher in Dagster+

To view all deployments, click View all deployments.

Creating deployments​

note

Organization Admin permissions are required to create deployments. Additionally, note that creating multiple deployments requires a Pro plan.

To create a deployment:

  1. Sign in to your Dagster+ account.
  2. Access the Deployments page using one of the following options:
    • Click the deployment switcher > View all deployments.
    • Click your user icon > Organization Settings > Deployments.
  3. Click the + New deployment button.
  4. In the modal that displays, fill in the following:
    • Name - Enter a name for the deployment.
    • Initial deployment permissions - Select the permissions you want to use to create the deployment:
      • Empty permissions - Creates the deployment with an empty set of permissions. Note: Only Organization Admins will be able to manage the deployment until other uses are granted Admin or Editor permissions.
      • Copy from - Creates the deployment using permissions duplicated from an existing deployment.
  5. When finished, click Create deployment.

Deleting deployments​

note

Organization Admin permissions are required to delete deployments. Additionally, note that deleting a deployment also deletes all its associated data, including code locations, jobs, schedules, and sensors.

To delete a deployment:

  1. Sign in to your Dagster+ account.
  2. Access the Deployments page using one of the following options:
    • Click the deployment switcher > View all deployments.
    • Click the deployment switcher, then the gear icon next to the deployment.
    • Click your user icon > Organization Settings > Deployments.
  3. Click the Delete button next to the deployment you want to delete.
  4. When prompted, confirm the deletion.

Configuring deployment settings​

note

Editor permissions are required to modify deployment settings.

Deployment settings can be configured in the Dagster+ interface or using the dagster-cloud CLI. Refer to the deployment settings reference for more info about individual settings.

To configure deployment settings in the Dagster+ UI:

  1. Sign in to your Dagster+ account.

  2. Access the Deployments page using one of the following:

    • Click the deployment switcher > View all deployments.
    • Click the deployment switcher, then the gear icon next to the deployment.
    • Click your user icon > Organization Settings > Deployments.

  3. Click the Settings button next to the deployment you want to configure.

  4. In the window that displays, configure settings for the deployment.

  5. When finished, click Save deployment settings.