From bc7395d23b6be144a5f76de1835c1b60284b2013 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Tue, 18 Nov 2025 16:36:20 +0000 Subject: [PATCH 1/3] Initial plan From f779120765b8e638d6041161a5bf025b1706f384 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Tue, 18 Nov 2025 16:41:33 +0000 Subject: [PATCH 2/3] Clarify that Debian images will not be shipped for .NET 10 Co-authored-by: lbussell <36081148+lbussell@users.noreply.github.com> --- .../containers/10.0/default-images-use-ubuntu.md | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/docs/core/compatibility/containers/10.0/default-images-use-ubuntu.md b/docs/core/compatibility/containers/10.0/default-images-use-ubuntu.md index c5df8303c9f15..7a9e031f21bbe 100644 --- a/docs/core/compatibility/containers/10.0/default-images-use-ubuntu.md +++ b/docs/core/compatibility/containers/10.0/default-images-use-ubuntu.md @@ -12,7 +12,9 @@ The default Linux distro for .NET tags has been changed from Debian to Ubuntu. T - `docker pull mcr.microsoft.com/dotnet/sdk:10.0` - Refers to Ubuntu 24.04 "Noble Numbat" - `docker pull mcr.microsoft.com/dotnet/sdk:10.0-noble` - Refers to Ubuntu 24.04 "Noble Numbat" -For more information about the container image platforms available at .NET 10's launch, see [dotnet-docker #6539](https://github.com/dotnet/dotnet-docker/discussions/6539). This change was proposed in [dotnet-docker #6526](https://github.com/dotnet/dotnet-docker/issues/6526). +**Important**: Debian-based container images will not be shipped for .NET 10. Only Ubuntu, Alpine, Azure Linux, and Windows platforms are officially supported. If you require Debian-based images, you must build and maintain custom container images based on Debian. + +For more information about the container image platforms available at .NET 10's launch, see [dotnet-docker #6539](https://github.com/dotnet/dotnet-docker/discussions/6539). This change was proposed in [dotnet-docker #6526](https://github.com/dotnet/dotnet-docker/issues/6526). Community feedback regarding Debian support can be found in [dotnet-docker #6734](https://github.com/dotnet/dotnet-docker/issues/6734). ## Version introduced @@ -24,7 +26,7 @@ In .NET 9 and earlier versions, default tags referenced images based on Debian. ## New behavior -Starting in .NET 10, default tags reference images based on Ubuntu. +Starting in .NET 10, default tags reference images based on Ubuntu. Additionally, Debian-based images are no longer provided as an official option. ## Type of breaking change @@ -36,7 +38,9 @@ Debian and .NET release cycles (for mainline support) are the same length, while ## Recommended action -Test your application. This change is unlikely to affect users. +Test your application with Ubuntu-based images. This change is unlikely to affect most users. + +If you specifically require Debian-based images for .NET 10, you'll need to create and maintain custom container images. Microsoft will not provide official Debian-based images for .NET 10 or later versions. ## Affected APIs From 63a8f6226ae6d6258a9bab149043eb367a0a6059 Mon Sep 17 00:00:00 2001 From: Logan Bussell Date: Tue, 18 Nov 2025 08:50:52 -0800 Subject: [PATCH 3/3] Apply suggestions from code review --- .../containers/10.0/default-images-use-ubuntu.md | 8 +++----- 1 file changed, 3 insertions(+), 5 deletions(-) diff --git a/docs/core/compatibility/containers/10.0/default-images-use-ubuntu.md b/docs/core/compatibility/containers/10.0/default-images-use-ubuntu.md index 7a9e031f21bbe..11dd58274e9f7 100644 --- a/docs/core/compatibility/containers/10.0/default-images-use-ubuntu.md +++ b/docs/core/compatibility/containers/10.0/default-images-use-ubuntu.md @@ -12,9 +12,7 @@ The default Linux distro for .NET tags has been changed from Debian to Ubuntu. T - `docker pull mcr.microsoft.com/dotnet/sdk:10.0` - Refers to Ubuntu 24.04 "Noble Numbat" - `docker pull mcr.microsoft.com/dotnet/sdk:10.0-noble` - Refers to Ubuntu 24.04 "Noble Numbat" -**Important**: Debian-based container images will not be shipped for .NET 10. Only Ubuntu, Alpine, Azure Linux, and Windows platforms are officially supported. If you require Debian-based images, you must build and maintain custom container images based on Debian. - -For more information about the container image platforms available at .NET 10's launch, see [dotnet-docker #6539](https://github.com/dotnet/dotnet-docker/discussions/6539). This change was proposed in [dotnet-docker #6526](https://github.com/dotnet/dotnet-docker/issues/6526). Community feedback regarding Debian support can be found in [dotnet-docker #6734](https://github.com/dotnet/dotnet-docker/issues/6734). +Debian container images will not be shipped for .NET 10. For more information about the container image platforms available at .NET 10's launch, see [dotnet-docker #6539](https://github.com/dotnet/dotnet-docker/discussions/6539). This change was proposed in [dotnet-docker #6526](https://github.com/dotnet/dotnet-docker/issues/6526). ## Version introduced @@ -26,7 +24,7 @@ In .NET 9 and earlier versions, default tags referenced images based on Debian. ## New behavior -Starting in .NET 10, default tags reference images based on Ubuntu. Additionally, Debian-based images are no longer provided as an official option. +Starting in .NET 10, the default container image tags reference Ubuntu images. Additionally, Debian-based images are no longer provided. ## Type of breaking change @@ -40,7 +38,7 @@ Debian and .NET release cycles (for mainline support) are the same length, while Test your application with Ubuntu-based images. This change is unlikely to affect most users. -If you specifically require Debian-based images for .NET 10, you'll need to create and maintain custom container images. Microsoft will not provide official Debian-based images for .NET 10 or later versions. +If you specifically require Debian-based images for .NET 10, you may need to create and maintain custom container images. Please see [installing .NET in a Dockerfile](https://github.com/dotnet/dotnet-docker/blob/main/documentation/scenarios/installing-dotnet.md) for details on how to create your own .NET container images. ## Affected APIs