Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Document Windows lack of multi-platform tags #4975

Merged
merged 1 commit into from
Oct 31, 2023
Merged

Document Windows lack of multi-platform tags #4975

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 11 additions & 2 deletions documentation/supported-tags.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -49,9 +49,18 @@ These tags reference images for [multiple platforms](https://docs.docker.com/bui
They include:

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

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

### `<Major.Minor.Patch .NET Version>-<OS version>`

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.
Expand Down Expand Up @@ -109,7 +118,7 @@ These "floating version" `latest` tag references an image with the latest `Major

Notes:

- The `latest` tag references the latest stable release.
- The `latest` tag references the latest stable release.
- In the `nightly` image repo, it may reference the latest preview release.

## Tag policies
Expand Down