Skip to content

Commit 6595bef

Browse files
committed
docs: document redeploying recent deployments from the dashboard
1 parent ff2aa23 commit 6595bef

2 files changed

Lines changed: 18 additions & 0 deletions

File tree

‎docs/deployment/atomic-deployment.mdx‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -147,6 +147,8 @@ Three ways out, in order of preference:
147147
- **Pass `--force`**, if you drive deploys yourself.
148148
- **Use an id that captures more than the commit** — `${GITHUB_SHA}-${GITHUB_RUN_ID}`, say — if your builds legitimately depend on inputs outside the tree. You lose idempotency in exchange.
149149
150+
For a deployment from the GitHub integration in the last 7 days, you can also [redeploy it from the dashboard](/deployment/overview#redeploying-from-the-dashboard). This builds the same commit again even though a deployment with that id already exists.
151+
150152
See the [deploy command reference](/cli-deploy-commands) for all deploy flags.
151153
152154
## Automatic discovery

‎docs/deployment/overview.mdx‎

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -160,6 +160,22 @@ Or from the dashboard:
160160

161161
To keep your app and tasks in sync without coordinating promotion at all, see [atomic deployments](/deployment/atomic-deployment).
162162

163+
### Redeploying from the dashboard
164+
165+
You can rebuild a recent deployment as a new deployment from the **Deployments** page. Open the menu on the deployment's row and select **Redeploy**.
166+
167+
The **Redeploy** action is available for deployments that:
168+
169+
- Have finished: deployed, failed, canceled or timed out.
170+
- Were created in the last 7 days.
171+
- Were triggered by the [GitHub integration](/github-integration), or deployed from the CLI with `--native-build` and without `--local-bundle`.
172+
173+
A GitHub integration deployment is rebuilt from the same commit and branch. A CLI deployment is rebuilt from the source files uploaded for the original deployment.
174+
175+
The new deployment gets a new version. **Promote deployment automatically** is selected by default, so the new version becomes the current version once it deploys successfully. Clear the checkbox to [skip promotion](#skipping-promotion) and promote it later. The new deployment's page shows the deployment it was redeployed from under **Redeploy of**.
176+
177+
You can't redeploy while another deployment is in progress in the same environment. If your production environment uses [atomic deployments with Vercel](/vercel-integration#atomic-deployments), redeploy it from Vercel instead.
178+
163179
## Staging deploys
164180

165181
By default, the `deploy` command will deploy to the `prod` environment. If you want to deploy to a different environment, you can use the `--env` flag:

0 commit comments

Comments
 (0)