Docs: Reflect resilient deployments on Octopus Cloud#3218
Conversation
042187c to
9369798
Compare
xwipeoutx
left a comment
There was a problem hiding this comment.
Added suggestions for "continue" vs "pause and resume", to avoid confusion with manual intervention and the like
There was a problem hiding this comment.
| Deployments and runbook runs on Octopus Cloud are resilient. If a [maintenance window](/docs/octopus-cloud/maintenance-window) or node restart interrupts a deployment or runbook run, it continues automatically once your instance is back online, rather than failing. You don't need to drain tasks or manually re-run them afterwards. |
There was a problem hiding this comment.
| Upgrading an instance is the primary cause of outages. Deployments and runbook runs on Octopus Cloud are now resilient: if an outage interrupts a deployment or runbook run, it continues automatically once your instance is back online, rather than failing. You no longer need to drain tasks or manually re-run deployments and runbook runs after a maintenance window. |
There was a problem hiding this comment.
| - Your instance will be given a few minutes to shut down cleanly. This will allow any in-progress tasks to complete. Deployments and runbook runs still in progress at the end of the timeout are resilient — they continue automatically once your instance is back online, so they no longer fail. Other in-progress system tasks may still be abandoned. |
There was a problem hiding this comment.
| **Octopus Cloud:** This script is no longer needed for deployments and runbook runs. On Octopus Cloud, these tasks are resilient — they continue automatically after a node restart or maintenance window rather than being cancelled. This script remains useful for self-hosted High Availability instances, where node restarts still cancel active tasks. |
983717e to
b196af0
Compare
|
Pull request environment is available at https://stoctodocspr3218.z22.web.core.windows.net. You can view the ephemeral environment status in Octopus Deploy. This environment will be automatically deprovisioned when the pull request is closed, or after 7 days of inactivity. |
b196af0 to
1d2d1d0
Compare
Deployments and runbook runs on Octopus Cloud now survive node restarts and maintenance windows: they pause and resume automatically rather than failing. Update the customer-facing docs that still framed task failure during outages as expected behaviour. - maintenance-window: replace the "resilience is future roadmap work" hint with shipped behaviour; scope the shutdown-timeout note to deployments/runbook runs (other system tasks may still be abandoned) - Cloud FAQ: add "What happens to my deployments during a maintenance window?" - bulk-operations rerun script: add a Cloud-obsolescence note (still relevant for self-hosted HA) Scope is Octopus Cloud only. Self-hosted HA pages are intentionally left unchanged — resilience is not yet on self-hosted. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
1d2d1d0 to
990e233
Compare
|
Incorporated @steve.leigh's suggestions — "paused/resumes" → "continues" in all four places (maintenance-window hint + outage bullet, Cloud FAQ, rerun-script note). Thanks for the precise-language nudge. Two intentional differences from the literal suggestions:
Also fixed the failing lint check — pre-existing |
What
Deployments and runbook runs on Octopus Cloud now survive node restarts and maintenance windows — they pause and resume automatically rather than failing. Several docs still framed task failure during outages as expected behaviour, or described resilience as future roadmap work. This updates them.
Scope
Octopus Cloud only, deployments and runbook runs only. The claim is resilience shipped on Cloud, not maintenance windows removed — maintenance windows still exist; deployments and runbook runs now survive them.
Other task types (e.g. system tasks, health checks) are not resilient yet, so the maintenance-window page keeps the "other in-progress system tasks may still be abandoned" caveat.
Self-hosted HA pages are intentionally left unchanged — resilience is not yet on self-hosted.
Changes
octopus-cloud/maintenance-window.mdoctopus-cloud/frequently-asked-questions.mdoctopus-rest-api/.../rerun-deployments-and-runbooks-after-node-shutdown.mdx🤖 Generated with Claude Code