Skip to content

Commit 9c941ad

Browse files
Update for new Ubuntu 24.04 and Windows 2025 DW images (#3240)
* Update for new Ubuntu 24.04 and Windows 2025 DW images * Fixes lint errors * Only list already advertised tools * Remove additional new tool reference --------- Co-authored-by: Steve Fenton <99181436+steve-fenton-octopus@users.noreply.github.com>
1 parent 937b315 commit 9c941ad

2 files changed

Lines changed: 46 additions & 10 deletions

File tree

src/pages/docs/best-practices/octopus-administration/worker-configuration.md

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -23,25 +23,26 @@ The leasing algorithm is not round-robin. It looks for the worker with the leas
2323
:::
2424

2525
Some important items to note about workers:
26+
2627
- Unlike deployment targets, workers are designed to run multiple tasks concurrently.
2728
- **Octopus Server 2020.1** added the [Worker Pool Variable Type](/docs/projects/variables/worker-pool-variables) making it possible to scope worker pools to environments.
2829
- **Octopus Server 2020.2** added the [execution container for workers](/docs/projects/steps/execution-containers-for-workers) feature, making it easier to manage software dependencies.
2930
- We provide a [Tentacle Docker image](https://hub.docker.com/repository/docker/octopusdeploy/tentacle) that can be configured to run as a worker.
3031

3132
## Provided Workers
3233

33-
The Octopus Server includes a [built-in worker](/docs/infrastructure/workers/built-in-worker). When you configure a deployment or runbook to run tasks on the server, it is handing off that work to the built-in worker.
34+
The Octopus Server includes a [built-in worker](/docs/infrastructure/workers/built-in-worker). When you configure a deployment or runbook to run tasks on the server, it is handing off that work to the built-in worker.
3435

3536
:::div{.hint}
36-
Octopus Cloud is running the Octopus Linux container. To ensure maximum cross-compatibility with both Windows and Linux, the built-in worker is disabled on Octopus Cloud. Instead, we provide you with the ability to choose from 2 [dynamic workers](/docs/infrastructure/workers/dynamic-worker-pools), Windows Server 2019 and Ubuntu 22.04. Each worker type is a different worker pool.
37+
Octopus Cloud is running the Octopus Linux container. To ensure maximum cross-compatibility with both Windows and Linux, the built-in worker is disabled on Octopus Cloud. Instead, we provide you with the ability to choose from 2 [dynamic workers](/docs/infrastructure/workers/dynamic-worker-pools). Each worker type is a different worker pool.
3738
:::
3839

3940
The built-in worker and [dynamic workers](/docs/infrastructure/workers/dynamic-worker-pools) were created to help get you started. Using them at scale will quickly expose their flaws.
4041

4142
- The built-in worker will run under the same account as the Octopus Deploy service. By default, that is `Local System`. You can change it to run under a different account, but it can only run under one account. You cannot change that account during a deployment or runbook run.
4243
- The built-in worker may or may not be in the same data center as your deployment targets. You could experience some significant latency.
4344
- Dynamic workers and built-in workers are limited to the software installed on the host servers. This includes specific software. Upgrading to a newer version results in a "big bang" change in your CI/CD pipeline which increases risk.
44-
- The IP address assigned to dynamic workers will change at most once an hour and at least once every 72 hours.
45+
- The IP address assigned to dynamic workers will change at most once an hour and at least once every 72 hours.
4546
- Dynamic workers are assigned to an entire instance, not just a space. We have seen cases where a deployment blocks on one space, blocking a deployment on another space because they both used the same dynamic worker.
4647
- There is only one dynamic worker per pool. Workers have some blocking tasks (install Calamari and downloading a package). If a process needs to acquire a mutex for that blocking task, it has to wait until other tasks are done.
4748

src/pages/docs/infrastructure/workers/dynamic-worker-pools.md

Lines changed: 42 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -97,6 +97,20 @@ Each `Ubuntu Server 22.04` worker is provisioned with a baseline of tools includ
9797
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.
9898
:::
9999

100+
### Ubuntu 24.04
101+
102+
Each `Ubuntu Server 24.04` worker is provisioned with a baseline of tools including (but not limited to):
103+
104+
- .NET (10.0, 8.0)
105+
- Docker (29.5.3)
106+
- PowerShell Core (7.6.2)
107+
- Python 3 (latest for Ubuntu 24.04)
108+
- GCloud CLI (566.0.0)
109+
110+
:::div{.hint}
111+
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.
112+
:::
113+
100114
### Windows Server Core 2022
101115

102116
This is the default for the Windows operating system, referenced as `Windows (default)`.
@@ -110,7 +124,7 @@ Each `Windows Server Core 2022` worker is provisioned with a baseline of tools i
110124
- Chocolatey (latest)
111125
- Docker (latest)
112126
- Helm (3.19.4)
113-
- Kubectl (multiple versions)
127+
- Kubectl (1.35.1, 1.34.4, 1.33.8, 1.32.12)
114128
- Microsoft Service Fabric (10.1.2338.9590)
115129
- Microsoft Service Fabric SDK (7.1.2338)
116130
- Nuget CLI (latest)
@@ -126,16 +140,37 @@ Windows 2022 workers are capable of running [execution worker containers](/docs/
126140
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.
127141
:::
128142

143+
### Windows Server Core 2025
144+
145+
Each `Windows Server Core 2025` worker is provisioned with a baseline of tools including (but not limited to):
146+
147+
- .NET (10.0, 8.0)
148+
- .NET Framework 4.8 (Default for Windows Server 2025)
149+
- AWS IAM Authenticator (0.7.17)
150+
- Chocolatey (2.7.2)
151+
- Docker (29.5.2)
152+
- Helm (3.20.1)
153+
- Kubectl (1.36.1, 1.35.5, 1.34.8, 1.33.12)
154+
- Microsoft Service Fabric (10.1.2338.9590)
155+
- Microsoft Service Fabric SDK (7.1.2338)
156+
- Nuget CLI (latest)
157+
- Octopus Client (latest)
158+
- Pip (latest)
159+
- PowerShell Core (7.6.2)
160+
- Python (3.14.5)
161+
- GCloud CLI (566.0.0)
162+
163+
Windows 2025 workers are capable of running [execution worker containers](/docs/projects/steps/execution-containers-for-workers).
164+
165+
:::div{.hint}
166+
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.
167+
:::
168+
129169
## kubectl on Windows Images
130170

131171
Windows dynamic worker images come with many versions of `kubectl` available.
132172

133-
A specific version can be used by [specifying a custom kubectl location](/docs/deployments/kubernetes/kubectl) of `c:\tools\kubectl\{{version}}\kubectl.exe`, where `{{version}}` is one of the following:
134-
135-
- `1.32.12`
136-
- `1.33.8`
137-
- `1.34.4`
138-
- `1.35.1`
173+
A specific version can be used by [specifying a custom kubectl location](/docs/deployments/kubernetes/kubectl) of `c:\tools\kubectl\{{version}}\kubectl.exe`, where `{{version}}` is one of the versions specified above for your dynamic worker version.
139174

140175
## Installing Software On Dynamic Workers
141176

0 commit comments

Comments
 (0)