From 89ce62ba906c67967784928f6d2a355aaa9c87f8 Mon Sep 17 00:00:00 2001 From: Krish Date: Thu, 18 Jun 2026 12:19:25 +1000 Subject: [PATCH 1/5] Add Windows 2022 Dynamic Worker end-of-life docs (DRAFT) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Draft only — content pending review. Documents the upgrade from Windows Server 2022 to Windows Server 2025 Dynamic Workers, with timeline (Jul-Oct 2026) and migration guide. --- .../windows-2022-end-of-life.md | 105 ++++++++++++++++++ 1 file changed, 105 insertions(+) create mode 100644 src/pages/docs/infrastructure/workers/dynamic-worker-pools/windows-2022-end-of-life.md diff --git a/src/pages/docs/infrastructure/workers/dynamic-worker-pools/windows-2022-end-of-life.md b/src/pages/docs/infrastructure/workers/dynamic-worker-pools/windows-2022-end-of-life.md new file mode 100644 index 0000000000..2a32710ea9 --- /dev/null +++ b/src/pages/docs/infrastructure/workers/dynamic-worker-pools/windows-2022-end-of-life.md @@ -0,0 +1,105 @@ +--- +layout: src/layouts/Default.astro +pubDate: 2026-07-14 +modDate: 2026-07-14 +title: Windows 2022 End-of-life +description: Describing the deprecation process of Windows 2022 Dynamic Workers. +navOrder: 50 +hideInThisSection: true +hideInThisSectionHeader: true +--- + +Our Windows Server 2022 Dynamic Workers are being upgraded to use Windows Server 2025, this may result in breaking changes for users of community steps or custom scripts. + + +## What is changing? +Due to Windows Server 2022 reaching the end of standard support on 13 October 2026, we are upgrading our dynamic workers to use Windows Server 2025. + + +## Who will be impacted? +Users of Octopus Cloud using Windows Dynamic Workers (`Windows (default)` and `Windows Server Core 2022` images) and running custom scripts or community steps may be impacted as there are **breaking changes between Windows 2022 and Windows 2025**. Should any additional components be identified as having breaking changes we will endeavour to inform you via email and Octopus community Slack. + +Steps running execution containers on Windows Dynamic Workers may also be impacted as Windows containers can generally only run when the container base image OS version matches the host OS version. This means the Windows 2022 container image you are currently using will likely fail to run on a Windows 2025 Dynamic Worker. + +**Note:** All Octopus Deploy steps will work under Windows 2025 but some community and custom steps may be impacted. + +## What do I need to do? +To mitigate the risk in this process we will be releasing Windows 2025 Dynamic Workers before the deprecation date so users can test against the new workers prior to deprecation. Please see the timeline below for the details. + +If you are running custom scripts, using community steps, or using execution containers on Windows workers, we recommend following the [migration guide](#migration-guide) below to test your deployments on Windows 2025 Dynamic Workers. + +## Alternate (recommended) course of action +Unless you have a specific need for a Windows Dynamic Worker we recommend considering a change to an Ubuntu 24.04 based Dynamic Worker as Ubuntu 24.04 Dynamic Workers are more performant. + +Built in steps work on both Ubuntu and Windows Dynamic Workers with the exception of Windows specific steps. Community steps and custom step templates would also need testing. + +## Timeline + +**Octopus preparation** + +| Date | Details | +|---------------|:-------------------------------------------------------------------| +| Jun 2026 | Octopus will produce and test a Windows 2025 Dynamic Worker image. | + + +**Customer action required** + +| Date | Details | +|-----------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| 14 Jul 2026 | Windows 2025 Dynamic Worker will be made available for customers.
| +| 8 Sep 2026 | Octopus will update the `Windows (default)` image to resolve to Windows Server Core 2025.