Skip to content

Commit 10a07a4

Browse files
Update Worker Tools docs (#3199)
* Update Worker Tools docs * Fix linting * Generate image set --------- Co-authored-by: Steve Fenton <99181436+steve-fenton-octopus@users.noreply.github.com>
1 parent dd9588b commit 10a07a4

8 files changed

Lines changed: 13 additions & 7 deletions

File tree

43.5 KB
Loading
53.4 KB
Loading
22.2 KB
Loading
67 KB
Loading
Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
{"width":1204,"height":832,"updated":"2026-06-04T07:00:55.039Z"}
66.9 KB
Loading
Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
{
22
"width": 1073,
3-
"height": 751,
4-
"updated": "2025-08-01T08:52:49.163Z"
5-
}
3+
"height": 826,
4+
"updated": "2026-06-04T02:52:22.163Z"
5+
}

src/pages/docs/infrastructure/workers/worker-tools-versioning-and-caching.md

Lines changed: 9 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
layout: src/layouts/Default.astro
33
pubDate: 2023-01-01
4-
modDate: 2026-01-14
4+
modDate: 2026-06-04
55
title: Worker Tools, Versioning and Caching
66
description: How Octopus creates, versions, caches, and releases the worker-tools Docker images for use with the execution containers for workers feature.
77
navOrder: 50
@@ -13,11 +13,16 @@ Worker Tools are a set of Docker images used as [execution containers for worker
1313

1414
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 recommend using the fully qualified SemVer as patch updates of Worker Tools could result in an updated tool dependency introducing a breaking change.
1515

16-
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](https://github.com/OctopusDeploy/WorkerTools/blob/master/windows.ltsc2022/Dockerfile) and [Ubuntu](https://github.com/OctopusDeploy/WorkerTools/blob/master/ubuntu.22.04/Dockerfile) Worker Tools.
16+
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
17+
18+
- [Windows 2022](https://github.com/OctopusDeploy/WorkerTools/blob/main/windows.ltsc2022/Dockerfile)
19+
- [Windows 2025](https://github.com/OctopusDeploy/WorkerTools/blob/main/windows.ltsc2025/Dockerfile)
20+
- [Ubuntu 22.04](https://github.com/OctopusDeploy/WorkerTools/blob/main/ubuntu.22.04/Dockerfile)
21+
- [Ubuntu 24.04](https://github.com/OctopusDeploy/WorkerTools/blob/main/ubuntu.24.04/Dockerfile)
1722

1823
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`.
1924

20-
For Windows these include `chocolatey` and `dotnet 6.0.*`.
25+
For Windows these include `chocolatey` and `dotnet 10.0.*` and `dotnet 8.0.*`.
2126

2227
If your steps depend on any of these packages, we recommend you target the fully qualified SemVer of Worker Tools. Otherwise, our additional Worker Tools tags may be suitable for your use case. We version our releases as follows:
2328

@@ -37,7 +42,7 @@ Patch update
3742
- Update of a pinned tools Patch version
3843
- Any new release, the latest tools will be updated automatically
3944

40-
In short, we recommend using the full `octopusdeploy/worker-tools:Major.Minor.Patch-Distro` tag format. Depending on your use case, the latest releases, `octopusdeploy/worker-tools:ubuntu.22.04` and `octopusdeploy/worker-tools:windows.ltsc2022` respectively or `octopusdeploy/worker-tools:Major-distro`, `octopusdeploy/worker-tools:Major.Minor-Distro` may be suitable for you.
45+
In short, we recommend using the full `octopusdeploy/worker-tools:Major.Minor.Patch-Distro` tag format. Depending on your use case, the latest releases, `octopusdeploy/worker-tools:ubuntu.24.04` and `octopusdeploy/worker-tools:windows.ltsc2025` respectively or `octopusdeploy/worker-tools:Major-distro`, `octopusdeploy/worker-tools:Major.Minor-Distro` may be suitable for you.
4146

4247
## Caching Worker Tools
4348

0 commit comments

Comments
 (0)