Dynamic Worker pools

Dynamic Worker Pools are a special type of worker pool used by Octopus Cloud. They use workers provided by Octopus, and they don't require users to configure any infrastructure.

On demand

Dynamic workers are created on demand and leased to an Octopus Cloud instance for a limited time before being destroyed.

Isolated

Each worker is provisioned exclusively to a specific customer, and is completely isolated from other customers.

Dynamic Worker Images

Each dynamic worker pool can specify the worker image used. Windows Server Core 2019 is the default. Ubuntu Server 18.04 (end-of-life, see below) and 22.04 worker images are also available.

Editing a dynamic worker pool allows you to modify the image used.

The available worker images list specific operating system versions (e.g., Windows Server Core 2019) but also generic "default" options such as Windows (default). Choosing the default option means that your worker will get the latest stable worker image released. This is a good option to choose if you're running a basic script that doesn't have any dependencies on specific tool or operating system versions.

If you're writing a script that relies on a specific version of tooling (e.g., helm), then we recommend choosing a specific worker image, instead of the "default" options, to prevent worker image upgrades from impacting your deployments.

Deprecation

When an image is marked as deprecated, you will see warnings in the Octopus UI, and in the deployment log. After a suitable deprecation period, deployments will start to fail if they target an image that has hit end-of-life.

When you start getting warnings in your deployments and/or see deprecation warnings in the Octopus portal, please plan to modify your worker pool to use a different image and test your scripts on the new image.

If your Worker Pool is set to use the Operating System default, for example, Windows (default), the default will be swapped over to a new Operating System version by Octopus Deploy. Your deployments and runbooks will automatically use the new version.

You should validate that your deployments and runbooks work with the new version prior to the cutover date. The new image will be made available prior to the cutover date and we will notify you of the cutover date to give you time to undertaking any required testing.

Please see Ubuntu 18.04 End-of-life for a current deprecation, and the steps you may need to take.

Modifying the worker pool

If the Worker Pool has been configured to specifically use a deprecated worker type, you will need to update the Worker Image on the Worker Pool.

The Worker Pool with a deprecated Worker Type will show a Deprecated label next to the worker pool, available by navigating to Infrastructure ➜ Worker Pools :

The Worker Type can be modified by editing the Worker Pool and changing the Worker Type to a different option, such as Windows (default) or a specific operating system version.

Available Dynamic Worker Images

Worker images are rebuilt on a regular basis, so that the operating system is up to date with the latest security patches.

Windows Server Core 2019

Each Windows Server Core 2019 worker is provisioned with a baseline of tools including (but not limited to):

• .NET Core (2.1, 3.1)
• .NET Framework 3.5
• .NET Framework 4.8
• AWS IAM Authenticator (0.5.1)
• Chocolatey (latest)
• Docker (19.03.5)
• Helm (2.9.1)
• Kubectl (1.16.10)
• Microsoft Service Fabric (6.1.480.9494)
• Microsoft Service Fabric SDK (3.0.480)
• Nuget CLI (latest)
• Octopus Client (latest)
• Pip (20.1.1)
• Powershell Core (latest)
• Python (3.7.4)
• GCloud CLI (339.0.0)

Windows 2019 workers are capable of running execution worker containers.

Ubuntu 18.04

Each Ubuntu Server 18.04 worker is provisioned with a baseline of tools including (but not limited to):

• .NET Core (2.1, 3.1)
• Docker (latest)
• Powershell Core (latest)
• Python 3 (latest)
• GCloud CLI (339.0.0)

Ubuntu 22.04

Each Ubuntu Server 22.04 worker is provisioned with a baseline of tools including (but not limited to):

• .NET 6
• Docker (latest)
• Powershell Core (latest)
• Python 3 (latest)
• GCloud CLI (367.0.0)

kubectl on Windows Images

Windows 2019 dynamic worker images come with many versions of kubectl available.

A specific version can be used by specifying a custom kubectl location of c:\tools\kubectl\{{version}}\kubectl.exe, where {{version}} is one of the following:

• 1.11.1
• 1.11.3
• 1.12.1
• 1.13.12
• 1.14.9
• 1.15.6
• 1.16.10
• 1.17.5
• 1.18.0
• 1.19.9
• 1.20.5
• 1.21.9
• 1.22.6

Installing Software On Dynamic Workers

Octopus does not recommend installing additional software on Dynamic Workers.

By default, every dynamic worker is destroyed after it has been allocated for over 72 hours. In addition Octopus cannot guarantee that the dynamic worker leased to run one step will be the same worker leased to other executing steps in a deployment or runbook run.

For deployments and runbook runs that require additional software dependencies on a Dynamic worker, our recommendation is to leverage execution containers for workers. Octopus provides execution containers with a baseline of tools (octopusdeploy/worker-tools) pre-installed. These tools won't include every possible software combination you might need. If you require a specific set of software and tooling we recommend building your own custom docker images for use with execution containers.

If you choose to install additional software on a dynamic worker, you are responsible for:

• Ensuring that software is installed at the start of each deployment or runbook run.
• Writing the necessary scripts to download and install that software.
• Verifying the latest version of the software works with the latest security patches of the host OS.
• Handling any issues that arise if a different dynamic worker is leased to different steps in your deployment or runbook run.

Learn more

• Worker blog posts
• Worker Tools, versioning and caching

Need support? We're here to help.