Promoting deployments
Assign a Ready Production deployment to your production domains.
Promotion changes which deployment receives production traffic.
Promotion is not the same as creating or rebuilding a deployment. Instant promote reuses an existing Ready Production deployment.
You need an Owner or Admin role. Members can view deployments but cannot promote.
If the project is paused or the workspace is suspended, promotion is blocked.
Production deployment and current deployment
A Production deployment is built with Production configuration.
The current deployment is the Production deployment currently serving the project's production domains.
A Production deployment can be Ready without being Current. That state is Staged.
Automatic production assignment
When Auto-assign production domains is on (the default):
- Easel creates a Production deployment
- The deployment builds independently
- Existing production traffic continues using the current deployment
- The new deployment reaches Ready
- Easel updates production routing to the new deployment
- The previous deployment remains in deployment history
If the new deployment fails, production traffic remains on the current deployment.
Promote a staged Production deployment
When auto-assign is off, Production builds finish as Staged: status Ready, not Current.
Promote also restores a chronologically newer former Current after Instant Rollback.
- Open the staged (or newer) Production deployment
- Open the deployment actions menu and choose Promote
- Confirm
Production domains move to this deployment with no rebuild. If the project was rolled back, promoting also turns auto-assign back on.
Promote a Preview deployment
Preview and Production deployments may use different environment variables, build settings, and secrets. Easel does not route production traffic directly to a Preview artifact.
Promoting a Preview deployment:
- Creates a new Production deployment from the same source commit
- Builds with current Production environment variables
- Reuses the source deployment's project settings snapshot when available
Steps:
- Open a Ready Preview deployment
- Open the deployment actions menu and choose Promote to Production
- Confirm. Easel queues a production rebuild
- Wait until the new deployment is Ready
When the rebuild is Ready, production domains update if auto-assign is on. If auto-assign is off, the new build is Staged until you promote it.
Call this workflow Promote to Production (rebuild), not instant promote.
Promotion and caches
Promotion changes traffic assignment. It does not automatically purge ISR or runtime caches.
Caches are keyed by deployment ID, so traffic to the newly Current deployment uses that deployment's cache namespace. Edge responses follow the newly aliased deployment's routes and assets.
You can clear ISR or runtime cache for a deployment from the dashboard when you need an explicit purge.
Permissions
Only Owner and Admin roles can promote. Activity is recorded when production traffic moves.