Octopus Deploy Documentation

Ubuntu 18.04 End-of-life

Last updated

Our Ubuntu dynamic workers are being upgraded to use Ubuntu 22.04, this upgrade will result in breaking changes for users of gcloud CLI and users of .NET Core 2.1/3.1 and Ubuntu 18.04 capabilities that are not offered by the updated replacements.

What is changing?

Due to the deprecation of Ubuntu 18.04, we are upgrading our dynamic workers to use Ubuntu 22.04. This change has also required upgrades of:

  • gcloud CLI from 339.0.0 to 367.0.0; and
  • .NET Core 2.1/3.1 to .NET 6.

Who will be impacted?

Users of Octopus Cloud utilizing Ubuntu workers and running custom scripts or community steps may be impacted as there are breaking changes between Ubuntu 18.04 and Ubuntu 22.04, and breaking changes between .NET Core 2.1/3.1 and .NET 6.

Cloud customers impacted by the GCloud CLI update will be those with a deployment process which:

  • Has a Run gcloud in a Script step, which runs on the Hosted Ubuntu Worker Pool, which does not use an execution container, and the script contains calls to gcloud; OR
  • Has a Run a Script step, which runs on the Hosted Ubuntu Worker Pool, and the script contains calls to gcloud.

What do I need to do?

Any impacted custom scripts will need to be updated to use Ubuntu 22.04 and tested to ensure your deployment process has not been impacted by the breaking changes. To mitigate the risk in this process we will be releasing the updated dynamic worker before the deprecation date so users can test against the new workers prior to migration. Please see the timeline below for the details.

Note: All Octopus Deploy steps will work under Ubuntu 22.04 but some community steps may be impacted.

Timeline

Octopus preparation

Date Details
Q4 2022 Octopus will produce and test an Ubuntu 22.04 worker image
Jan 2023 Internal testing of existing tooling to confirm compatibility

Customer action required

Date Details
1 Feb 2023 Ubuntu 22.04 dynamic worker will be made available for customers.
  • Customers should test their impacted deployments and runbooks on an Ubuntu 22.04 worker with the aim of completing testing by the 15th of March 2023
15 Mar 2023 Octopus will switch over the default "Hosted Ubuntu" worker pool to use the Ubuntu 22.04 worker.
  • If customers experience failed deployments or runbooks, they will be able to select the Ubuntu 18.04 worker until 3 April 2023 while they resolve any issues with running on an Ubuntu 22.04 worker
3 Apr 2023 Ubuntu 18.04 dynamic workers will no longer be available on Octopus Cloud.

FAQ

Why the deadline of 3 April 2023?

Ubuntu 18.04 exits LTS support and will not be patched including any security vulnerability. Consequently, Octopus will not provide an unsupported Dynamic worker image.

What are the breaking changes between Ubuntu releases?

It is not possible to give a complete and definitive answer as this depends on your use cases. Therefore, please refer to the following release notes:

What are the breaking changes between the .NET releases?

It is not possible to give a complete and definitive answer as this depends on your use cases. Therefore please refer to the following release notes:

What if I experience a breaking change but I can’t remediate it in time?

There is the option to provision your own worker with Ubuntu 18.04 and selecting its worker pool for your deployment process that experience the breaking change.

Why is GCloud CLI part of this notification?

Ubuntu 22.04 requires a later version of GCloud CLI. We have selected the earliest version on GCloud CLI that is compatible with Ubuntu 22.04 to minimize the number of breaking changes we expose our customers to. Customers can use the GCloud 367.0.0 Release Notes to assess whether their GCloud script steps are impacted by the breaking changes between GCloud versions 339.0.0 and 367.0.0.

Are the Windows dynamic workers affected in any way?

This change does not impact the Windows dynamic workers.

Need support? We're here to help.