Skip to content

Commit 24af4e8

Browse files
Add Ubuntu 22.04 Dynamic Worker end-of-life docs (DRAFT)
Draft only — content pending review. Documents the upgrade from Ubuntu 22.04 to Ubuntu 24.04 Dynamic Workers, with timeline (Jul-Oct 2026) and FAQ covering Ubuntu and .NET breaking changes. Timeline aligns with the Windows 2022 EOL change.
1 parent 12df465 commit 24af4e8

1 file changed

Lines changed: 79 additions & 0 deletions

File tree

Lines changed: 79 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,79 @@
1+
---
2+
layout: src/layouts/Default.astro
3+
pubDate: 2026-06-18
4+
modDate: 2026-06-18
5+
title: Ubuntu 22.04 End-of-life
6+
description: Describing the deprecation process of Ubuntu 22.04 Dynamic Workers.
7+
navOrder: 50
8+
hideInThisSection: true
9+
hideInThisSectionHeader: true
10+
---
11+
12+
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.
13+
14+
## What is changing?
15+
16+
Ubuntu 22.04 is approaching the end of its standard support, so we're upgrading our dynamic workers to use Ubuntu 24.04. As part of this upgrade, we've also updated some of the tools bundled in the image, including the .NET versions available on the worker.
17+
18+
## Who will be impacted?
19+
20+
Users of Octopus Cloud using Ubuntu Dynamic Workers and running custom scripts or community steps may be impacted, as there are breaking changes between Ubuntu 22.04 and Ubuntu 24.04, and between the .NET releases.
21+
22+
If you only use built-in Octopus Deploy steps, you don't need to do anything. All built-in steps work on Ubuntu 24.04. Some community steps and custom scripts may be affected.
23+
24+
## What do I need to do?
25+
26+
You'll need to test any impacted custom scripts on Ubuntu 24.04 and update them to make sure your deployment process isn't affected by the breaking changes.
27+
28+
To reduce the risk during this process, we're making the Ubuntu 24.04 Dynamic Worker available before the deprecation date so you can test against the new worker before you migrate. See the timeline below for the details.
29+
30+
## Timeline
31+
32+
### Octopus preparation
33+
34+
| Date | Details |
35+
|---------------|:--------------------------------------------------------------------|
36+
| Jun 2026 | Octopus will produce and test an Ubuntu 24.04 Dynamic Worker image. |
37+
38+
### Customer action required
39+
40+
| Date | Details |
41+
|-----------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
42+
| 14 Jul 2026 | Ubuntu 24.04 Dynamic Worker will be made available for customers. Customers should test their impacted deployments and runbooks on an Ubuntu 24.04 worker with the aim of completing testing by 14 August 2026. |
43+
| 8 Sep 2026 | Octopus will switch over the default "Hosted Ubuntu" worker pool to use the Ubuntu 24.04 worker. If customers experience failed deployments or runbooks, they can select the Ubuntu 22.04 worker until 13 October 2026 while they resolve any issues. |
44+
| 13 Oct 2026 | Ubuntu 22.04 Dynamic Workers will no longer be available on Octopus Cloud. |
45+
46+
## FAQ
47+
48+
### Why the deadline of 13 October 2026?
49+
50+
We're bringing the deadline forward so you can start using the new Ubuntu 24.04 Dynamic Worker image sooner, rather than waiting until Ubuntu 22.04 reaches the end of its LTS support in May 2027. This date also aligns with our Windows Dynamic Worker upgrade, so customers running both don't have to plan around two separate migrations.
51+
52+
### What are the breaking changes between Ubuntu releases?
53+
54+
It's not possible to give a complete and definitive answer, as this depends on your use cases. Please refer to the following documents:
55+
56+
- [Ubuntu 22.04 release notes](https://documentation.ubuntu.com/release-notes/22.04/)
57+
- [Ubuntu 24.04 release notes](https://discourse.ubuntu.com/t/ubuntu-24-04-lts-noble-numbat-release-notes/39890)
58+
59+
### What are the breaking changes between the .NET releases?
60+
61+
It's not possible to give a complete and definitive answer, as this depends on your use cases. Please refer to the following release notes:
62+
63+
- [.NET 7 breaking changes](https://learn.microsoft.com/en-us/dotnet/core/compatibility/7.0)
64+
- [.NET 8 breaking changes](https://learn.microsoft.com/en-us/dotnet/core/compatibility/8.0)
65+
- [.NET 9 breaking changes](https://learn.microsoft.com/en-us/dotnet/core/compatibility/9.0)
66+
- [.NET 10 breaking changes](https://learn.microsoft.com/en-us/dotnet/core/compatibility/10)
67+
- [.NET release types](https://learn.microsoft.com/en-us/dotnet/core/releases-and-support)
68+
69+
### What if I experience a breaking change but I can't remediate it in time?
70+
71+
You can provision your own worker with Ubuntu 22.04 and select its worker pool for the deployment process that experiences the breaking change.
72+
73+
### Are the Windows Dynamic Workers affected in any way?
74+
75+
The Windows Dynamic Workers are also being updated. A separate notification covers the details of that change.
76+
77+
### How does this affect execution containers?
78+
79+
Ubuntu 22.04 Docker images, along with [Worker Tools](/docs/infrastructure/workers/worker-tools-versioning-and-caching), can still run on Ubuntu 24.04 Dynamic Workers. We'll no longer provide support for the `ubuntu.22.04` Worker Tools image, so we recommend moving to the new `ubuntu.24.04` image.

0 commit comments

Comments
 (0)