Skip to main content

Managing full deployments

Full deployments are independent deployment instances with separately managed permissions within your Dagster deployment.

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.

Viewing and switching full deployments​

In Dagster+, you can view and switch between full deployments using the deployment switcher. To view all deployments, click View all deployments.

The deployment switcher in Dagster+

Creating full deployments​

Prerequisites

To create full deployments, you need a Pro plan and Organization Admin permissions.

To create a full 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 new deployment modal, enter the following:
    • Name - Enter a name for the full deployment.
    • Initial deployment permissions - Select the permissions you want to use to create the full deployment:
      • Empty permissions - Creates the full deployment with an empty set of permissions. Note: Only Organization Admins will be able to manage the full deployment until other uses are granted Admin or Editor permissions.
      • Copy from - Creates the full deployment using permissions duplicated from an existing full deployment.
  5. When finished, click Create deployment.

Deleting full 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 full 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 full deployment.
    • Click your user icon > Organization Settings > Deployments.
  3. Click the Delete button next to the full deployment you want to delete.
  4. When prompted, confirm the deletion.

Configuring full deployment settings​

note

Editor permissions are required to modify full deployment settings.

Full deployment settings can be configured in the Dagster+ interface or using the dagster-cloud CLI. For more information about individual settings, see the full deployment settings reference.

To configure full 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 full deployment.
    • Click your user icon > Organization Settings > Deployments.

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

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

  5. When finished, click Save deployment settings.