Skip to content

Document returning to a previous release by deployment_id, and retrying an activation - #696

Merged
dawsontoth merged 2 commits into
mainfrom
docs/deploy-keep-displaced-release
Sep 29, 2026
Merged

dawsontoth merged 2 commits into
mainfrom
docs/deploy-keep-displaced-release

Conversation

@dawsontoth

Copy link
Copy Markdown
Contributor

Documents #2315 step 5, from HarperFast/harper#2897: a deploy now keeps the release it replaces under the deployment id that deployed it, so deploy_component { project, deployment_id } returns to it, and activating the id that is already live succeeds without a swap, so a partial activation can be retried with the same id.

  • reference/operations-api/operations.md: the deployment_id parameter row, the staging caveats (a retry of the live id is safe; kept releases count against retention; a deployment id names one release while the node holds it), the 404 wording, and two new sections — Going back to a previous release and Retrying an activation.
  • reference/configuration/options.md: stagingRetention.maxCount now also bounds kept releases, each a full installed copy.
  • release-notes/v5-lincoln/5.3.md: a Going Back to a Previous Release note, including the disk-use change.

Badges stay v5.3.0: 5.3.0 is still in beta (latest tag v5.3.0-beta.4), and the staged-deploy section they extend is itself new in 5.3.0.

Verified with npm run format:check and npm run build (no broken links or anchors).

🤖 Generated with Claude Code

…id, and retrying an activation

Companion to HarperFast/harper#2897 (#2315 step 5). A deploy now keeps the release it replaces under the
deployment id that deployed it, so deploy_component { deployment_id } returns to it; activating the id that
is already live succeeds without a swap, so a retry converges. Kept releases share
deployment.stagingRetention.maxCount with staged builds, and each is a full installed copy.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
gemini-code-assist[bot]

This comment was marked as resolved.

…ve retry restarts every worker

From review: "published by that deployment", a capitalized retry list, Oxford commas, and a
simpler statement of when retention runs. Also states what harper#2897 now does on an already-live
retry with `restart`: it restarts every worker, isolated applications' included.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@dawsontoth
dawsontoth marked this pull request as ready for review September 29, 2026 14:05
@dawsontoth
dawsontoth requested a review from a team as a code owner September 29, 2026 14:05

@cb1kenobi cb1kenobi left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No confirmed blocking documentation defects were found. The changed text is internally consistent, and prior inline concerns were addressed at the reviewed commit.

—
Reviewed bf5a265

@cb1kenobi cb1kenobi left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The changed docs at this commit match the stated deploy behavior: kept releases are activated by deployment_id, already-live activation is retryable without a swap, and retention plus disk use are described the same way in the operations reference, config option, and 5.3 note. Prior inline wording notes are already addressed. No remaining blocking defect on the changed lines.

—
Reviewed bf5a265

@dawsontoth
dawsontoth merged commit e7c0ae1 into main Sep 29, 2026
14 of 15 checks passed
@dawsontoth
dawsontoth deleted the docs/deploy-keep-displaced-release branch September 29, 2026 14:18
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.

2 participants