Skip to content

Commit 983717e

Browse files
lucyjspenceclaude
andcommitted
Reflect resilient deployments on Octopus Cloud
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>
1 parent 557c794 commit 983717e

3 files changed

Lines changed: 13 additions & 7 deletions

File tree

src/pages/docs/octopus-cloud/frequently-asked-questions.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
layout: src/layouts/Default.astro
33
pubDate: 2024-11-08
4-
modDate: 2025-06-06
4+
modDate: 2026-06-23
55
title: Octopus Cloud Frequently Asked Questions
66
navTitle: Octopus Cloud FAQ
77
navOrder: 110
@@ -199,6 +199,10 @@ We publish Octopus Cloud’s [uptime track record](/docs/octopus-cloud/uptime-sl
199199

200200
We publish Octopus Cloud's [operational status](https://status.octopus.com/). You can subscribe to status change emails from our [operational status page](https://status.octopus.com/).
201201

202+
### What happens to my deployments during a maintenance window?
203+
204+
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 is paused and resumes automatically once your instance is back online, rather than failing. You don't need to drain tasks or manually re-run them afterwards. Other task types are not yet resilient and may be abandoned during an outage.
205+
202206
## Logs and data
203207

204208
### How do we access deployment and audit logs?

src/pages/docs/octopus-cloud/maintenance-window.md

Lines changed: 3 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
layout: src/layouts/Default.astro
33
pubDate: 2023-01-01
4-
modDate: 2025-08-13
4+
modDate: 2026-06-23
55
title: Maintenance windows
66
navTitle: Maintenance windows
77
navOrder: 80
@@ -48,18 +48,16 @@ On rare occasions, a maintenance action will require an outage. During the two-h
4848

4949
We follow this process to minimize impact:
5050

51-
- In-progress tasks get a few minutes to complete before being abandoned
51+
- In-progress tasks get a few minutes to complete. Deployments and runbook runs still running at the end of that time are resilient — they're paused and resume automatically once your instance is back online, rather than failing. Other in-progress tasks may still be abandoned
5252
- Users receive a maintenance page, and API requests return a 503 Service Unavailable status code
5353
- Maintenance operations occur
5454
- Your instance will start up again, and we confirm it is in a healthy state
5555
- The maintenance page is removed, and your instance is accessible again
5656
- Tasks paused during shutdown will be resumed
5757
- Tasks scheduled to start during the outage commence
5858

59-
We recommend avoiding non-idempotent deployments and runbook runs during maintenance windows.
60-
6159
:::div{.hint}
62-
One impact of an outage is that deployments and runbook runs may fail. We are actively working on [Resilient Scalable Deployments](https://roadmap.octopus.com/c/95-alpha-program-resilient-scalable-deployments-in-octopus-cloud) to allow deployments and runbook runs to resume post-outage.
60+
Deployments and runbook runs on Octopus Cloud are now resilient: if an outage interrupts a deployment or runbook run, it's paused and resumes automatically once your instance is back online, rather than failing. You no longer need to drain tasks or manually re-run them after a maintenance window. Other task types are not yet resilient and may be abandoned during an outage.
6361
:::
6462

6563
## How to view or change your maintenance window

src/pages/docs/octopus-rest-api/examples/bulk-operations/rerun-deployments-and-runbooks-after-node-shutdown.mdx

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,16 @@
11
---
22
layout: src/layouts/Default.astro
33
pubDate: 2023-01-01
4-
modDate: 2023-01-01
4+
modDate: 2026-06-23
55
title: Rerun all canceled deployments and runbook runs after node shutdown.
66
description: An example script that determine which deployments and runbook runs were canceled because of a node shutdown and resubmit them.
77
---
88
import RerunDeploymentsAndRunbooksAfterNodeFailure from 'src/shared-content/scripts/rerun-deployments-and-runbooks-after-node-failure.include.md';
99

10+
:::div{.hint}
11+
**Octopus Cloud:** This script is no longer needed for deployments and runbook runs. On Octopus Cloud, these tasks are resilient — they are paused and resume 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.
12+
:::
13+
1014
This script demonstrates how to programmatically determine which deployments and runbook runs can be resubmitted because they were canceled because of a node shutdown. The node could have been shutdown for normal reasons, or it could have stopped responding, or it could have been turned off.
1115

1216
## Usage

0 commit comments

Comments
 (0)