docs(deployment): record how to break the build-old deadlock - #18
Merged
Conversation
The script skips its own scratch directories now, but a server that has not yet pulled that change cannot get past the cleanliness check to reach it: the check runs before `git pull`, and the pinned SSH command runs the copy of the script already on the server. It needs one manual `rm -rf` to break the loop, once. Writing it down because the failure is self-inflicted, the message does not say what to do about it, and the fix looks more dangerous than it is — those two directories are the previous release's bundles, not the live ones. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
datlechin
added a commit
that referenced
this pull request
Aug 17, 2026
The script skips its own scratch directories now, but a server that has not yet pulled that change cannot get past the cleanliness check to reach it: the check runs before `git pull`, and the pinned SSH command runs the copy of the script already on the server. It needs one manual `rm -rf` to break the loop, once. Writing it down because the failure is self-inflicted, the message does not say what to do about it, and the fix looks more dangerous than it is — those two directories are the previous release's bundles, not the live ones.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Follow-up to #17. That PR fixed the script; this documents the one manual step a server already stuck in the loop needs.
Why a manual step is unavoidable
The pinned
authorized_keyscommand runs the copy ofscripts/deploy.shon the server, and the cleanliness check at line 98 runs beforegit pullat line 104. So a server holdingbuild-old/ssr-oldcannot reach the commit that teaches the script to ignore them. #17 fixes every future deploy; it cannot fix the current one.Then re-run the workflow.
Worth writing down because the error message says what is wrong but not what to do, and because the fix looks more dangerous than it is: those two directories are the previous release's bundles. The live ones are
public/buildandbootstrap/ssr. Deleting them costs only the ability to roll back to the release before last, which git can rebuild.🤖 Generated with Claude Code