Deployments are standalone environments, allowing you to operate independent instances of Dagster with separately managed permissions.
When a Dagster Cloud organization is created, a single deployment named prod will also be created. To create additional deployments, an Enterprise plan is required.
Concerned about testing environments? 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 Cloud users, regardless of plan.
Access the Deployments page using one of the following options:
Click the deployment switcher > View all deployments.
Click your user icon > Cloud Settings > Deployments.
Click the + New deployment button.
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.
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:
Sign in to your Dagster Cloud account.
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 > Cloud Settings > Deployments.
Click the Delete button next to the deployment you want to delete.
Deployment settings can be configured in the Dagster Cloud 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 Cloud UI:
Sign in to your Dagster Cloud account.
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 > Cloud Settings > Deployments.
Click the Settings button next to the deployment you want to configure.
In the window that displays, configure settings for the deployment.
When finished, click Save deployment settings.
Note:dagster-cloud 0.13.14 or later must be installed to run the CLI. Agent and/or job code doesn't need to be upgraded.
Create a file with the settings you'd like to configure. For example:
This will replace all of your configured settings. Any that are not specified will resort to their default values. You also use the CLI to read your current settings, including the default values: