Skip to content

Commit db9a3bb

Browse files
authored
Update supported platforms documentation (#6540)
1 parent 25d0924 commit db9a3bb

File tree

2 files changed

+19
-10
lines changed

2 files changed

+19
-10
lines changed

documentation/supported-platforms.md

Lines changed: 16 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -9,19 +9,27 @@ This document describes the platforms (OS and architectures) supported by the of
99
- Images for new OS versions are typically released within one month of the new OS release, with a goal to release same-day when possible.
1010
- New OS versions are available in [`dotnet/nightly` repositories](https://github.com/dotnet/dotnet-docker/blob/nightly/README.md) first, and are added to the officially supported repos afterwards.
1111
- All new OS releases will be accompanied by an [announcement](https://github.com/dotnet/dotnet-docker/discussions/categories/announcements).
12+
- Unless otherwise specified (see Alpine Linux below), we stop publishing updates to images when the .NET version in the image reaches [end of support](https://dotnet.microsoft.com/platform/support/policy/dotnet-core) or when the OS base image stops receiving updates, whichever happens first.
1213

1314
These policies are specific to .NET container images. For more information on overall .NET OS support, see [.NET OS Support Tracking](https://github.com/dotnet/core/issues/9638).
1415

1516
### Linux
1617

17-
Each distribution (distro) has a unique approach to releasing, schedule, and end-of life (EOL). This prohibits the definition of a one-size-fits-all policy. Instead, a policy is defined for each supported distro.
18-
19-
- Alpine — support latest and retain support for the previous version one quarter (3 months) after a new version is released.
20-
- Azure Linux — support the latest *stable* version at the time a `major.minor` version of .NET is released. As new *stable* versions are released, support is added to the latest .NET version and latest LTS (if they differ).
21-
- Debian — support the latest *stable* version at the time a `major.minor` version of .NET is released. As new *stable* versions are released, support is added to the latest .NET version and latest LTS (if they differ) via an [OS-specific tag](supported-tags.md#os-tags-and-base-image-updates).
22-
- Ubuntu — support the latest *LTS* version at the time a `major.minor` version of .NET is released. As new *LTS* versions are released, support is added to the latest .NET version and latest LTS (if they differ).
23-
24-
Pre-release versions of the supported distros will be made available within the [nightly repositories](https://github.com/dotnet/dotnet-docker/blob/nightly/README.md) based on the availability of pre-release OS base images.
18+
Since Linux distributions ("distros") each have unique release and support policies, a one-size-fits-all policy doesn't make sense.
19+
Instead, we have separate policies for each distro.
20+
We publish .NET container images for the following versions of each Linux distro:
21+
22+
- Alpine Linux
23+
- .NET images will be published for the latest Alpine Linux version.
24+
- When new Alpine versions are released, new images will be added for all in-support .NET versions.
25+
- .NET images for the previous version of Alpine will published for 3 months after the new version is released.
26+
- Azure Linux and Ubuntu LTS
27+
- .NET images will be published images for the latest OS version at the time a new major/minor version of .NET is released.
28+
- When new OS versions are released, new images will be added to the latest .NET version and latest LTS .NET version (if they differ).
29+
- Debian
30+
- Existing .NET Debian images will continue to receive base image updates, but new .NET images will not be added for future Debian versions.
31+
32+
Pre-release versions of the above distros will be published in the [nightly repositories](https://github.com/dotnet/dotnet-docker/blob/nightly/README.md), pending the availability of pre-release base images.
2533

2634
#### FedRAMP Compliance
2735

documentation/supported-tags.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -49,7 +49,8 @@ These tags reference images for [multiple platforms](https://docs.docker.com/bui
4949

5050
They include:
5151

52-
- Debian, unless specified (like `8.0-alpine`).
52+
- For .NET 10, multi-platform tags refer to Ubuntu unless otherwise specified (like `8.0-alpine`).
53+
- For .NET versions prior to 10, multi-platform tags refer to Debian unless otherwise specified.
5354
- All [supported architectures](supported-platforms.md#architectures).
5455

5556
> [!WARNING]
@@ -235,7 +236,7 @@ For Windows, `amd64` is the only architecture supported and is excluded from the
235236
236237
Each tag will be supported for the lifetime of the .NET and OS version referenced by the tag, unless further restricted according to [platform support policy](supported-platforms.md).
237238
238-
When a .NET version or an OS version reaches End-of-Life (EOL), its tags will no longer be supported.
239+
When a .NET version or an OS version reaches [end of support](https://dotnet.microsoft.com/platform/support/policy/dotnet-core) (sometimes referred to as end-of-life or EOL), its tags will no longer be supported.
239240
Unsupported tags and images can still be pulled, but they will no longer receive updates for any reason.
240241
241242
See ["Is your image built from a supported .NET tag?"](vulnerability-reporting.md#c-is-your-image-built-from-a-supported-net-tag) for details on how to tell if a specific tag is supported.

0 commit comments

Comments
 (0)