From cc6f88fd8a9ca6cce61c3efe3ecd312e3d927729 Mon Sep 17 00:00:00 2001 From: Sarah-A Date: Wed, 21 Oct 2026 13:54:49 +1000 Subject: [PATCH 1/9] Update worker images EOL details Updated the default Ubuntu and Windows worker images to 24.04 and 2025 respectively, reflecting the latest versions and their associated tools. --- .../workers/dynamic-worker-pools.md | 55 ++----------------- 1 file changed, 5 insertions(+), 50 deletions(-) diff --git a/src/pages/docs/infrastructure/workers/dynamic-worker-pools.md b/src/pages/docs/infrastructure/workers/dynamic-worker-pools.md index 62d1eb92e8..d20096a622 100644 --- a/src/pages/docs/infrastructure/workers/dynamic-worker-pools.md +++ b/src/pages/docs/infrastructure/workers/dynamic-worker-pools.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Default.astro pubDate: 2023-01-01 -modDate: 2026-07-02 +modDate: 2026-10-21 title: Dynamic Worker pools description: Dynamic Worker pools are used in our cloud product to dynamically create and assign workers to running tasks. This page describes how dynamic worker pools work. navOrder: 50 @@ -36,12 +36,12 @@ Each dynamic worker pool uses a specific worker image. This is a VM image which When you sign up to [Octopus Cloud](/docs/octopus-cloud) (or create a new [space](/docs/administration/spaces)), you automatically receive a worker pool for the `Ubuntu (default)` image, and a worker pool for the `Windows (default)` image. -The full list of available worker images includes both specific operating system versions (e.g., `Ubuntu Linux 22.04`), and also generic "default" options such as `Ubuntu (default)`. Choosing the default option means that your worker will use the latest stable worker image when it is released. +The full list of available worker images includes both specific operating system versions (e.g., `Ubuntu Linux 24.04`), and also generic "default" options such as `Ubuntu (default)`. Choosing the default option means that your worker will use the latest stable worker image when it is released. The current default images are: -- `Ubuntu (default)` ➜ `Ubuntu Linux 22.04` -- `Windows (default)` ➜ `Windows Server Core 2022` +- `Ubuntu (default)` ➜ `Ubuntu Linux 24.04` +- `Windows (default)` ➜ `Windows Server Core 2025` ### Choosing an Image @@ -57,7 +57,7 @@ Alternatively, you can choose a specific worker image, instead of the "default" | Type | Pros | Cons | |--------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | Default (eg `Ubuntu (default)`) | Automatically uses the latest image. Deployments will continue to work even when a worker image is marked as deprecated or decommissioned. | The versions of dependencies (e.g. Helm) are not fixed; deployments that rely on specific versions of dependencies or operating system‑specific features may break during upgrades. | -| Specific (e.g., `Ubuntu Linux 22.04`)| The version of the operating system and dependencies are fixed and can be relied upon. | When a worker image is marked as deprecated, warnings will start to appear in your deployment logs; when it is decommissioned, you will need to update your worker pool or deployments will fail. | +| Specific (e.g., `Ubuntu Linux 24.04`)| The version of the operating system and dependencies are fixed and can be relied upon. | When a worker image is marked as deprecated, warnings will start to appear in your deployment logs; when it is decommissioned, you will need to update your worker pool or deployments will fail. | ### Deprecation @@ -81,22 +81,6 @@ Click the overflow menu (`...`) and click **Edit**. You can then select a new wo Worker images are rebuilt on a regular basis, so that the operating system is up to date with the latest security patches. -### Ubuntu 22.04 - -This is the default for the Ubuntu operating system, referenced as `Ubuntu (default)`. - -Each `Ubuntu Server 22.04` worker is provisioned with a baseline of tools including (but not limited to): - -- .NET (8.0, 6.0) -- Docker (latest) -- PowerShell Core (latest) -- Python 3 (latest) -- GCloud CLI (550.0.0) - -:::div{.hint} -Ubuntu workers are designed to use [execution worker containers](https://octopus.com/blog/execution-containers) for tooling like `kubectl` and `helm`. This makes it much easier to choose the appropriate runtime environment with the tools you need for your use case. -::: - ### Ubuntu 24.04 Each `Ubuntu Server 24.04` worker is provisioned with a baseline of tools including (but not limited to): @@ -111,35 +95,6 @@ Each `Ubuntu Server 24.04` worker is provisioned with a baseline of tools includ Ubuntu workers are designed to use [execution worker containers](https://octopus.com/blog/execution-containers) for tooling like `kubectl` and `helm`. This makes it much easier to choose the appropriate runtime environment with the tools you need for your use case. ::: -### Windows Server Core 2022 - -This is the default for the Windows operating system, referenced as `Windows (default)`. - -Each `Windows Server Core 2022` worker is provisioned with a baseline of tools including (but not limited to): - -- .NET (8.0, 6.0) -- .NET Framework 3.5 -- .NET Framework 4.8 -- AWS IAM Authenticator (0.7.10) -- Chocolatey (latest) -- Docker (latest) -- Helm (3.19.4) -- Kubectl (1.35.1, 1.34.4, 1.33.8, 1.32.12) -- Microsoft Service Fabric (10.1.2338.9590) -- Microsoft Service Fabric SDK (7.1.2338) -- Nuget CLI (latest) -- Octopus Client (latest) -- Pip (latest) -- PowerShell Core (latest) -- Python (3.14) -- GCloud CLI (550.0.0) - -Windows 2022 workers are capable of running [execution worker containers](/docs/projects/steps/execution-containers-for-workers). - -:::div{.hint} -We recommend execution containers as the preferred option for steps requiring external tools. This allows you to control which version of the tools will be used as your scripts will rely on a specific version that they are compatible with to function correctly. -::: - ### Windows Server Core 2025 Each `Windows Server Core 2025` worker is provisioned with a baseline of tools including (but not limited to): From afbb3ebc8770308b884ef74eafd6278fd9108841 Mon Sep 17 00:00:00 2001 From: Sarah-A Date: Wed, 21 Oct 2026 14:02:02 +1000 Subject: [PATCH 2/9] Update Ubuntu 22.04 End-of-life documentation Updated modification date and added warning about Ubuntu 24.04 images. --- .../workers/dynamic-worker-pools/ubuntu-2204-end-of-life.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/src/pages/docs/infrastructure/workers/dynamic-worker-pools/ubuntu-2204-end-of-life.md b/src/pages/docs/infrastructure/workers/dynamic-worker-pools/ubuntu-2204-end-of-life.md index a48ec06971..5e092434b6 100644 --- a/src/pages/docs/infrastructure/workers/dynamic-worker-pools/ubuntu-2204-end-of-life.md +++ b/src/pages/docs/infrastructure/workers/dynamic-worker-pools/ubuntu-2204-end-of-life.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Default.astro pubDate: 2026-06-18 -modDate: 2026-06-18 +modDate: 2026-10-21 title: Ubuntu 22.04 End-of-life description: Describing the deprecation process of Ubuntu 22.04 Dynamic Workers. navOrder: 50 @@ -9,6 +9,10 @@ hideInThisSection: true hideInThisSectionHeader: true --- +:::div{.warning} +Ubuntu 24.04 images are no longer available as of 13 October 2026. The details below are provided for historical reference. +::: + Our Ubuntu Dynamic Workers are being upgraded to use Ubuntu 24.04. This may result in breaking changes for users of community steps or custom scripts. ## What is changing? From fce55bce0a2e0aa00d81bcc07e189bac1eb44f6b Mon Sep 17 00:00:00 2001 From: Sarah-A Date: Wed, 21 Oct 2026 14:06:01 +1000 Subject: [PATCH 3/9] Update Windows 2022 End-of-life documentation Updated the modification date and added a warning about the unavailability of Windows Server 2022 images. --- .../workers/dynamic-worker-pools/windows-2022-end-of-life.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) 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 index f9e5505ed7..54f04157f4 100644 --- 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 @@ -1,13 +1,16 @@ --- layout: src/layouts/Default.astro pubDate: 2026-07-14 -modDate: 2026-07-14 +modDate: 2026-10-21 title: Windows 2022 End-of-life description: Describing the deprecation process of Windows 2022 Dynamic Workers. navOrder: 50 hideInThisSection: true hideInThisSectionHeader: true --- +:::div{.warning} +Windows Server 2022 images are no longer available as of 13 October 2026. The details below are provided for historical reference. +::: 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. From 7efff1a2048e6fe2d5e8741b4774cf799adf7bbd Mon Sep 17 00:00:00 2001 From: Sarah-A Date: Wed, 21 Oct 2026 14:06:49 +1000 Subject: [PATCH 4/9] wip --- .../workers/dynamic-worker-pools/ubuntu-2204-end-of-life.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/pages/docs/infrastructure/workers/dynamic-worker-pools/ubuntu-2204-end-of-life.md b/src/pages/docs/infrastructure/workers/dynamic-worker-pools/ubuntu-2204-end-of-life.md index 5e092434b6..1a163a48de 100644 --- a/src/pages/docs/infrastructure/workers/dynamic-worker-pools/ubuntu-2204-end-of-life.md +++ b/src/pages/docs/infrastructure/workers/dynamic-worker-pools/ubuntu-2204-end-of-life.md @@ -10,7 +10,7 @@ hideInThisSectionHeader: true --- :::div{.warning} -Ubuntu 24.04 images are no longer available as of 13 October 2026. The details below are provided for historical reference. +Ubuntu 22.04 images are no longer available as of 13 October 2026. The details below are provided for historical reference. ::: Our Ubuntu Dynamic Workers are being upgraded to use Ubuntu 24.04. This may result in breaking changes for users of community steps or custom scripts. From c4f23c410d8435201fd4b9b9c14002c9bd35c3a1 Mon Sep 17 00:00:00 2001 From: Sarah-A Date: Wed, 21 Oct 2026 14:23:00 +1000 Subject: [PATCH 5/9] Update modification date and Docker image versions Updated the modification date and Docker image distribution versions in the documentation. --- .../workers/worker-tools-versioning-and-caching.md | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/src/pages/docs/infrastructure/workers/worker-tools-versioning-and-caching.md b/src/pages/docs/infrastructure/workers/worker-tools-versioning-and-caching.md index cfba23e5d4..8f9c9c07ad 100644 --- a/src/pages/docs/infrastructure/workers/worker-tools-versioning-and-caching.md +++ b/src/pages/docs/infrastructure/workers/worker-tools-versioning-and-caching.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Default.astro pubDate: 2023-01-01 -modDate: 2026-10-16 +modDate: 2026-10-21 title: Worker Tools, Versioning and Caching description: How Octopus creates, versions, caches, and releases the worker-tools Docker images for use with the execution containers for workers feature. navOrder: 50 @@ -11,13 +11,11 @@ Worker Tools are a set of Docker images used as [execution containers for worker ## Versioning Worker Tools -Worker Tool images follow a semantic versioning (SemVer) approach of `Major.Minor.Patch-Distro` for their tag format. When we release a new version of Worker Tools to the [Worker Tools Docker Hub repository](https://hub.docker.com/r/octopusdeploy/worker-tools/tags), we also add the following image tags, distribution (`ubuntu.22.04` or `windows.ltsc2022`), `Major-Distro` (e.g. `3-Distro`) and `Major.Minor-Distro` (`3.3-Distro`). We also publish multi-platform tags without a distribution, `Major.Minor.Patch`, `Major.Minor`, `Major` and `latest`, which contain the images for every distribution. We recommend using the fully qualified SemVer as patch updates of Worker Tools could result in an updated tool dependency introducing a breaking change. +Worker Tool images follow a semantic versioning (SemVer) approach of `Major.Minor.Patch-Distro` for their tag format. When we release a new version of Worker Tools to the [Worker Tools Docker Hub repository](https://hub.docker.com/r/octopusdeploy/worker-tools/tags), we also add the following image tags, distribution (`ubuntu.24.04` or `windows.ltsc2025`), `Major-Distro` (e.g. `3-Distro`) and `Major.Minor-Distro` (`3.3-Distro`). We also publish multi-platform tags without a distribution, `Major.Minor.Patch`, `Major.Minor`, `Major` and `latest`, which contain the images for every distribution. We recommend using the fully qualified SemVer as patch updates of Worker Tools could result in an updated tool dependency introducing a breaking change. The Worker Tools Dockerfiles use a combination of tools pinned to specific versions, such as CLI tools and Frameworks, while other tools pull their latest available release. For Ubuntu, these are pulled with apt-get, and for Windows, chocolatey. You can find the full details of these tools in the Docker files for -- [Windows 2022](https://github.com/OctopusDeploy/WorkerTools/blob/main/windows.ltsc2022/Dockerfile) - [Windows 2025](https://github.com/OctopusDeploy/WorkerTools/blob/main/windows.ltsc2025/Dockerfile) -- [Ubuntu 22.04](https://github.com/OctopusDeploy/WorkerTools/blob/main/ubuntu.22.04/Dockerfile) - [Ubuntu 24.04](https://github.com/OctopusDeploy/WorkerTools/blob/main/ubuntu.24.04/Dockerfile) The tools pulling their latest releases for Ubuntu include `wget`, `python3-pip`, `groff`, `unzip`, `apt-utils`, `curl`, `software-properties-common`, `jq`, `yq`, `openssh-client`, `rsync`, `git`, `augeas-tools`, `maven`, `gradle`, `Node 14`, `istioctl`, `linkerd`, `umoci`. From d70754f9ebd4a6952744c78b4c9820a44889ac50 Mon Sep 17 00:00:00 2001 From: Sarah-A Date: Wed, 21 Oct 2026 14:40:45 +1000 Subject: [PATCH 6/9] Update execution containers documentation for new images Updated documentation to reflect changes in container images and Windows base image recommendations. --- .../execution-containers-for-workers/index.mdx | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/src/pages/docs/projects/steps/execution-containers-for-workers/index.mdx b/src/pages/docs/projects/steps/execution-containers-for-workers/index.mdx index 0369d8f2e4..a3b8a93a35 100644 --- a/src/pages/docs/projects/steps/execution-containers-for-workers/index.mdx +++ b/src/pages/docs/projects/steps/execution-containers-for-workers/index.mdx @@ -1,7 +1,7 @@ --- layout: src/layouts/Default.astro pubDate: 2023-01-01 -modDate: 2023-01-01 +modDate: 2023-10-21 title: Execution containers for workers description: How to set a step in your deployment/runbook process to run inside a container. navOrder: 30 @@ -34,7 +34,7 @@ You need Docker installed and running on the [worker](/docs/infrastructure/worke - Set the **Execution Location** for your step to **Run on a worker**. - In **Container Image** select **Run inside a container on a worker** and then **Pull container from a registry**. - Choose the previously added container registry. -- Enter the name of the image (execution container) you want your step to run in. (e.g. `octopusdeploy/worker-tools:ubuntu.22.04`). +- Enter the name of the image (execution container) you want your step to run in. (e.g. `octopusdeploy/worker-tools:ubuntu.24.04`). - Click **Save**. - Click **Create release & deploy**. @@ -75,8 +75,8 @@ We recommend using our `worker-tools` image as a starting point for your own cus The canonical source for what is contained in the `octopusdeploy/worker-tools` images is the `Dockerfile`'s in the [GitHub repo](https://github.com/OctopusDeploy/WorkerTools). For example: -- The [Ubuntu 22.04 Dockerfile](https://github.com/OctopusDeploy/WorkerTools/blob/master/ubuntu.22.04/Dockerfile) -- The [Windows 2022 Dockerfile](https://github.com/OctopusDeploy/WorkerTools/blob/master/windows.ltsc2022/Dockerfile) +- The [Ubuntu 24.04 Dockerfile](https://github.com/OctopusDeploy/WorkerTools/blob/main/ubuntu.24.04/Dockerfile) +- The [Windows 2025 Dockerfile](https://github.com/OctopusDeploy/WorkerTools/blob/main/windows.ltsc2025/Dockerfile) Some of the tools included are: @@ -98,10 +98,10 @@ It can be beneficial to build your own custom Docker image when using execution #### Supported Windows base images -For Windows images, we recommend using a base image no older than the `ltsc2022` image. Octopus does not support images that are older than `ltsc2022`, and while containers based on these images can still run steps, you may run into unexpected issues. +For Windows images, we recommend using a base image no older than the `ltsc2025` image. Octopus does not support images that are older than `ltsc2025`, and while containers based on these images can still run steps, you may run into unexpected issues. :::div{.hint} -If your containers are based on an earlier image of Windows, we strongly recommend upgrading your workers to Windows 2022 and rebasing your Docker containers to use a 2022 base image. +If your containers are based on an earlier image of Windows, we strongly recommend upgrading your workers to Windows 2025 and rebasing your Docker containers to use a 2025 base image. ::: #### Supported Linux distributions @@ -118,10 +118,10 @@ You can usually find the base operating system of a Linux Docker image by runnin docker run --entrypoint='' [image name] /bin/cat /etc/os-release. ``` -For example for the `octopusdeploy/worker-tools:5.0.0-ubuntu.22.04` image, you'd run: +For example for the `octopusdeploy/worker-tools:6.6.5-ubuntu.24.04` image, you'd run: ```bash -docker run --entrypoint='' octopusdeploy/worker-tools:5.0.0-ubuntu.22.04 /bin/cat /etc/os-release. +docker run --entrypoint='' octopusdeploy/worker-tools:6.6.5-ubuntu.24.04 /bin/cat /etc/os-release. ``` #### Required OS dependencies From 37894b08d51dc1f3a930047bfe3ef73a7557f6e6 Mon Sep 17 00:00:00 2001 From: Sarah-A Date: Fri, 23 Oct 2026 06:56:50 +1000 Subject: [PATCH 7/9] wip --- .../projects/steps/execution-containers-for-workers/index.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/pages/docs/projects/steps/execution-containers-for-workers/index.mdx b/src/pages/docs/projects/steps/execution-containers-for-workers/index.mdx index a3b8a93a35..bc5c955c9e 100644 --- a/src/pages/docs/projects/steps/execution-containers-for-workers/index.mdx +++ b/src/pages/docs/projects/steps/execution-containers-for-workers/index.mdx @@ -1,7 +1,7 @@ --- layout: src/layouts/Default.astro pubDate: 2023-01-01 -modDate: 2023-10-21 +modDate: 2026-10-21 title: Execution containers for workers description: How to set a step in your deployment/runbook process to run inside a container. navOrder: 30 From 33071255ad653fabfaed4cc7612a08fec60065d6 Mon Sep 17 00:00:00 2001 From: Sarah-A Date: Fri, 23 Oct 2026 07:22:02 +1000 Subject: [PATCH 8/9] wip --- .../workers/worker-tools-versioning-and-caching.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/pages/docs/infrastructure/workers/worker-tools-versioning-and-caching.md b/src/pages/docs/infrastructure/workers/worker-tools-versioning-and-caching.md index 8f9c9c07ad..a1b879ad6d 100644 --- a/src/pages/docs/infrastructure/workers/worker-tools-versioning-and-caching.md +++ b/src/pages/docs/infrastructure/workers/worker-tools-versioning-and-caching.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Default.astro pubDate: 2023-01-01 -modDate: 2026-10-21 +modDate: 2026-10-23 title: Worker Tools, Versioning and Caching description: How Octopus creates, versions, caches, and releases the worker-tools Docker images for use with the execution containers for workers feature. navOrder: 50 @@ -44,7 +44,7 @@ In short, we recommend the following. On Ubuntu, use the `octopusdeploy/worker-t ## Caching Worker Tools -Worker Tools are cached on dynamic workers to help improve the performance of deployments. Windows workers cache the latest two sets of Worker Tools while Ubuntu workers cache the latest three. Each worker only caches the images for its own operating system, so a `windows.ltsc2022` image on a Windows 2025 worker is always downloaded in full. +Worker Tools are cached on dynamic workers to help improve the performance of deployments. Windows workers cache the latest two sets of Worker Tools while Ubuntu workers cache the latest three. Each worker only caches the images for its own operating system, so for example, a Windows 2022 image on a Windows 2025 worker is always downloaded in full. To understand this cache, it's important to understand a worker's life cycle. Workers are acquired from a dynamic worker pool and leased to a single cloud instance. They are allocated in a round robin fashion to individual deployment steps, storing packages, Docker images, and other data on disk. Workers are destroyed after either the worker has been idle for 60 minutes or has existed for 72 hours (3 days). From 6996f6268f91cbce171c324e1c3fcf7672026869 Mon Sep 17 00:00:00 2001 From: Sarah-A Date: Fri, 23 Oct 2026 07:27:44 +1000 Subject: [PATCH 9/9] wip Clarified caching behavior for Worker Tools on different OS versions. --- .../workers/worker-tools-versioning-and-caching.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/pages/docs/infrastructure/workers/worker-tools-versioning-and-caching.md b/src/pages/docs/infrastructure/workers/worker-tools-versioning-and-caching.md index a1b879ad6d..54153ad68c 100644 --- a/src/pages/docs/infrastructure/workers/worker-tools-versioning-and-caching.md +++ b/src/pages/docs/infrastructure/workers/worker-tools-versioning-and-caching.md @@ -44,7 +44,7 @@ In short, we recommend the following. On Ubuntu, use the `octopusdeploy/worker-t ## Caching Worker Tools -Worker Tools are cached on dynamic workers to help improve the performance of deployments. Windows workers cache the latest two sets of Worker Tools while Ubuntu workers cache the latest three. Each worker only caches the images for its own operating system, so for example, a Windows 2022 image on a Windows 2025 worker is always downloaded in full. +Worker Tools are cached on dynamic workers to help improve the performance of deployments. Windows workers cache the latest two sets of Worker Tools while Ubuntu workers cache the latest three. Each worker only caches the images for its own operating system version. For example, a `windows.ltsc2022` image on a Windows 2025 worker is always downloaded in full. To understand this cache, it's important to understand a worker's life cycle. Workers are acquired from a dynamic worker pool and leased to a single cloud instance. They are allocated in a round robin fashion to individual deployment steps, storing packages, Docker images, and other data on disk. Workers are destroyed after either the worker has been idle for 60 minutes or has existed for 72 hours (3 days).