Skip to content

Draft feature docs: porter apply exit codes for superseded deploys#395

Open
mintlify[bot] wants to merge 1 commit into
mainfrom
mintlify/f350dbd6
Open

Draft feature docs: porter apply exit codes for superseded deploys#395
mintlify[bot] wants to merge 1 commit into
mainfrom
mintlify/f350dbd6

Conversation

@mintlify

@mintlify mintlify Bot commented Jun 29, 2026

Copy link
Copy Markdown
Contributor

Summary

Documents the new exit code 3 returned by porter apply --wait when a deployment is superseded by a newer revision, so CI consumers can distinguish a canceled deploy from a genuine failure.

Changes

  • Added an Exit codes section to the porter apply command reference with a table of 0 / 1 / 3 outcomes.
  • Noted that exit code 3 for superseded deploys is rolled out per project (feature-flagged) and falls back to exit 0 until enabled.
  • Included a CI snippet showing how to branch on $? to skip alerts when a deploy was replaced by a newer revision.

Context

Upstream change makes porter apply --wait exit 3 (instead of 0) when a deploy is canceled by a newer one starting before it finishes. Previously CI treated a deploy that never shipped as a success. The behavior is opt-in per project via feature flag; other entry points (update-image --wait, porter app …, porter deploy) keep their existing exit 1 for now.

cc @georgezhang for review.

@mintlify
mintlify Bot requested a review from georgez98 June 29, 2026 14:46
@mintlify

mintlify Bot commented Jun 29, 2026

Copy link
Copy Markdown
Contributor Author

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
porter 🟢 Ready View Preview Jun 29, 2026, 3:05 PM

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.

0 participants