Skip to content

docs: add runbook for failed Vercel deployment rollback - #594

Merged
barry01-hash merged 4 commits into
PromptMintLabs:mainfrom
Kriss255:fix/issue-474-add-runbook-for-failed-vercel-deployment
Sep 3, 2026
Merged

docs: add runbook for failed Vercel deployment rollback#594
barry01-hash merged 4 commits into
PromptMintLabs:mainfrom
Kriss255:fix/issue-474-add-runbook-for-failed-vercel-deployment

Conversation

@Kriss255

Copy link
Copy Markdown
Contributor

Overview

This PR adds a runbook for failed Vercel deployment rollback after auto-rollback events. It documents the rollback procedure, how to read Vercel deployment failure logs, and how to verify that a stable deployment has been restored.

Related Issue

Closes #

Changes

🔄 Rollback Runbook

  • [ADD] docs/operations/auto-rollback.md

    • Explains what triggers a Vercel auto-rollback and how recent failed deploys are handled.
    • Provides step-by-step rollback procedures using both the Vercel dashboard and Vercel CLI.
    • Includes verification steps to confirm the correct deployment is live.
  • [ADD] runbook.md

    • Entry-point runbook linking to the detailed operations and troubleshooting guides.
    • Quick-reference commands for listing deployments, checking deployment status, and rolling back.
  • [ADD] docs/operations/runbook.md

    • Operational runbook for triaging failed Vercel deployments.
    • Covers how to inspect deployment logs, identify common failure signatures, and decide between redeploying and rolling back.
  • [MODIFY] docs/troubleshooting.md

    • Adds a "failed Vercel deployment rollback" section with common failure patterns.
    • Includes log-reading guidance and links to the new auto-rollback runbook.

Verification Results

Manual verification:
✅ Rollback steps verified against Vercel dashboard + CLI
✅ Log-reading examples match Vercel deployment output
✅ All cross-references resolve
✅ Markdown lint passes
Acceptance Criteria Status
Rollback procedure is documented step-by-step ✅ Dashboard + CLI steps with verification
Deployment failure logs can be read and interpreted ✅ Common log patterns and failure signatures documented
Runbook is linked from troubleshooting docs docs/troubleshooting.md links to the new runbook
Auto-rollback behavior is explained ✅ Trigger conditions and rollback process documented

Closes #474

@drips-wave

drips-wave Bot commented Aug 31, 2026

Copy link
Copy Markdown

@Kriss255 Great news! 🎉 Based on an automated assessment of this PR, the linked Wave issue(s) no longer count against your application limits.

You can now already apply to more issues while waiting for a review of this PR. Keep up the great work! 🚀

Learn more about application limits

@barry01-hash
barry01-hash merged commit 1028e51 into PromptMintLabs:main Sep 3, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add runbook for failed Vercel deployment rollback

2 participants