Skip to main content

Rollback and promote

Every deployment keeps its own immutable preview URL. Switching production between ready deployments is instant: nothing is rebuilt.

tc rollback​

Switches production back to the previous ready deployment, or to a given one.

tc rollback [--project NAME] [--to ID] [--json]
FlagDescription
--to IDThe deployment to serve. Default: the previous ready deployment.

Output

Rolled back expenses: d9a1b7 → d8f3a2
Live: https://expenses.apps.contoso.com

JSON: the project (name, status, url, productionDeploymentId, liveDeploymentId, latestDeployment, lifecycle, createdAt) plus previousDeploymentId and switched (whether the Edge already serves the new deployment).

Errors: NO_ROLLBACK_TARGET (no earlier ready deployment); DEPLOYMENT_NOT_FOUND; NOT_READY; PROJECT_NOT_ACTIVE; READ_ONLY.

tc promote​

Makes a ready deployment (for example a --preview deploy) serve production.

tc promote ID [--project NAME] [--json]
ArgumentDescription
IDThe deployment id (from tc status)

Output

Promoted d9a1b7 → https://expenses.apps.contoso.com

JSON: the same shape as tc rollback.

Errors: Usage: tc promote <deployment-id> without an id; DEPLOYMENT_NOT_FOUND; NOT_READY (the deployment must be ready); PROJECT_NOT_ACTIVE; READ_ONLY.

Was this page helpful?