Skip to main content

Deploying to both Serverless and Hybrid code locations

Deploy both Dagster+ Serverless and Hybrid code locations from a single repository using agent queues and separate CI/CD workflows.

Serverless code locations require no additional deployment configuration. Hybrid code locations need a build.yaml to configure Docker image builds, and agent_queue set in pyproject.toml to route to the correct agent.

Prerequisites​

  • A repository containing the code for both Serverless and Hybrid code locations
  • An agent configured to serve the Hybrid queue. For details, see Routing requests to specific agents.
note

Agent queues are a Dagster+ Pro feature.

Step 1: Configure the Hybrid code location​

Add a build.yaml to the directory containing the Hybrid code location. The Hybrid location uses Docker images and routes to a dedicated agent queue.

The registry field specifies where the Docker image is stored.

build.yaml
registry: ghcr.io/my-org/my-repo/hybrid-location

Configure agent_queue and other project settings in pyproject.toml:

pyproject.toml
[tool.dg.project]
root_module = "hybrid_location"
agent_queue = "hybrid-queue"

For the full specification of all deployment configuration files, see the deployment configuration reference.

Full working example​

A complete example is available in the Dagster repository.