Skip to content

Commit 32301c7

Browse files
authored
Document Windows lack of multi-platform tags (#4975)
1 parent 04ddc48 commit 32301c7

File tree

1 file changed

+11
-2
lines changed

1 file changed

+11
-2
lines changed

documentation/supported-tags.md

Lines changed: 11 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -49,9 +49,18 @@ These tags reference images for [multiple platforms](https://docs.docker.com/bui
4949
They include:
5050

5151
- Debian, unless specified (like `6.0-alpine`).
52-
- Each supported Nano Server version for OS-agnostic tags (like `7.0` and `latest`)
5352
- All [supported architectures](supported-platforms.md#architectures).
5453

54+
**Note:** Since .NET 8, these multi-platform tags **specifically exclude all Windows versions** due to `containerd`'s platform matching algorithm for Windows hosts.
55+
Please see [#4492 (Switch multi-platform tags to Linux only)](https://github.com/dotnet/dotnet-docker/issues/4492) for more context.
56+
If you are using Windows, you will need to explicitly specify an OS Version with a single-platform tag like so:
57+
```Dockerfile
58+
FROM mcr.microsoft.com/dotnet/sdk:8.0-nanoserver-ltsc2022
59+
FROM mcr.microsoft.com/dotnet/sdk:8.0-nanoserver-1809
60+
FROM mcr.microsoft.com/dotnet/sdk:8.0-windowsservercore-ltsc2019
61+
FROM mcr.microsoft.com/dotnet/sdk:8.0-windowsservercore-ltsc2022
62+
```
63+
5564
### `<Major.Minor.Patch .NET Version>-<OS version>`
5665

5766
These "fixed version" tags reference an image with a specific `Major.Minor.Patch` .NET version, for a specific operating system, while architecture will be chosen based on the requesting environment.
@@ -109,7 +118,7 @@ These "floating version" `latest` tag references an image with the latest `Major
109118

110119
Notes:
111120

112-
- The `latest` tag references the latest stable release.
121+
- The `latest` tag references the latest stable release.
113122
- In the `nightly` image repo, it may reference the latest preview release.
114123

115124
## Tag policies

0 commit comments

Comments
 (0)