> For the complete documentation index, see [llms.txt](https://v2.dataos.info/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://v2.dataos.info/operate/data-developer/deploy-and-promote.md).

# Deploy and promote across environments

The operational path from a dev Tenant to production.

Deploying is one thing; promoting a product from experimentation to production reliably is the operational discipline around it. How you promote depends on how your Operator sliced Tenants (see [Tenants and blueprints](https://v2.dataos.info/operate/dataos-operator/design-tenants.md)).

## How the deploy works

The mechanics live in Build. You generate a `deploy.yaml`, apply it, and verify the product is live. This page assumes that and focuses on the promotion path. For the deploy steps themselves, see [Git & deploy](https://v2.dataos.info/build/productize/git-and-deploy) in the Build guide.

## Promote with environment Tenants

The common blueprint separates environments into their own Tenants (`dev`, `stg`, `prod`). Promotion is then a controlled progression of the *same* project across Tenants:

1. **Build and validate in dev.** Plan and run locally, then deploy to the dev Tenant. Confirm runs, quality checks, and the served APIs behave.
2. **Promote to staging** by deploying the same Git ref to the staging Tenant, pointed at staging data sources and Compute. Validate against production-like data and access.
3. **Promote to production** by deploying the same ref to the prod Tenant. Production is the source of truth; nothing reaches it that did not pass staging.

What changes between environments is configuration, not code: the Tenant, the Depots and Compute it points at, and the Secrets that hold data source credentials, all resolved per Tenant. Keep the project identical and let the environment supply the connections.

## Operating practices

* **One source of truth.** Promote a specific, tagged Git ref forward; do not edit directly in a higher environment.
* **Same project, different config.** Parameterize connections so the same code runs in each Tenant; never fork per environment.
* **Promote on green.** A product moves up only when its plan, tests, and quality checks pass in the environment below.
* **Coordinate breaking changes.** A schema or grain change that reaches production affects consumers; sequence it with the guidance in [Monitor Data Product](https://v2.dataos.info/operate/data-developer/monitor-data-product.md).
* **Update in place.** To ship a change to a deployed Data Product, re-apply it with `--re-run` instead of deleting and redeploying, which takes its API down for consumers. See [Update a deployed Data Product](https://v2.dataos.info/references/resources/vulcan/deployment#step-6-update-a-deployed-data-product).
* **Record what is where.** Track which ref is deployed in each Tenant so you can reason about and roll back a release.

Once deployed, the job becomes keeping it healthy: [Monitor Data Product](https://v2.dataos.info/operate/data-developer/monitor-data-product.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://v2.dataos.info/operate/data-developer/deploy-and-promote.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
