Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 5 additions & 1 deletion src/pages/docs/octopus-cloud/frequently-asked-questions.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
layout: src/layouts/Default.astro
pubDate: 2024-11-08
modDate: 2025-06-06
modDate: 2026-06-23
title: Octopus Cloud Frequently Asked Questions
navTitle: Octopus Cloud FAQ
navOrder: 110
Expand Down Expand Up @@ -199,6 +199,10 @@ We publish Octopus Cloud’s [uptime track record](/docs/octopus-cloud/uptime-sl

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/).

### What happens to my deployments during a maintenance window?

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 manually re-run them afterwards. Other task types are not yet resilient and may be abandoned during an outage.

## Logs and data

### How do we access deployment and audit logs?
Expand Down
8 changes: 3 additions & 5 deletions src/pages/docs/octopus-cloud/maintenance-window.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
layout: src/layouts/Default.astro
pubDate: 2023-01-01
modDate: 2025-08-13
modDate: 2026-06-23
title: Maintenance windows
navTitle: Maintenance windows
navOrder: 80
Expand Down Expand Up @@ -48,18 +48,16 @@ On rare occasions, a maintenance action will require an outage. During the two-h

We follow this process to minimize impact:

- In-progress tasks get a few minutes to complete before being abandoned
- In-progress tasks get a few minutes to complete. Deployments and runbook runs still running at the end of that time are resilient — they continue automatically once your instance is back online, rather than failing. Other in-progress tasks may still be abandoned
Comment thread
lucyjspence marked this conversation as resolved.
- Users receive a maintenance page, and API requests return a 503 Service Unavailable status code
- Maintenance operations occur
- Your instance will start up again, and we confirm it is in a healthy state
- The maintenance page is removed, and your instance is accessible again
- Tasks paused during shutdown will be resumed
- Tasks scheduled to start during the outage commence

We recommend avoiding non-idempotent deployments and runbook runs during maintenance windows.

:::div{.hint}
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.
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 manually re-run them after a maintenance window. Other task types are not yet resilient and may be abandoned during an outage.
:::

## How to view or change your maintenance window
Expand Down
Original file line number Diff line number Diff line change
@@ -1,12 +1,16 @@
---
layout: src/layouts/Default.astro
pubDate: 2023-01-01
modDate: 2023-01-01
modDate: 2026-06-23
title: Rerun all canceled deployments and runbook runs after node shutdown.
description: An example script that determine which deployments and runbook runs were canceled because of a node shutdown and resubmit them.
---
import RerunDeploymentsAndRunbooksAfterNodeFailure from 'src/shared-content/scripts/rerun-deployments-and-runbooks-after-node-failure.include.md';

:::div{.hint}
**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.
:::

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.

## Usage
Expand All @@ -23,10 +27,10 @@ This script has guardrails in place to ensure you don't make too many changes.

- A what if variable. Set that to `$true` and it will skip the submission step. It will print out all the deployments and runbook runs it would've done.
- This script will not resubmit every canceled runbook run or deployment. For a runbook run or deployment to be considered it must:
- Have been canceled within the time frame provided.
- Have been running on the node or nodes that were provided.
- Have been canceled because of a node shutdown.
- Have been canceled within the time frame provided.
- Have been running on the node or nodes that were provided.
- Have been canceled because of a node shutdown.

## Script

<RerunDeploymentsAndRunbooksAfterNodeFailure />
<RerunDeploymentsAndRunbooksAfterNodeFailure />