Skip to content

Commit ca2ed20

Browse files
Copilotlbussell
andauthored
Clarify that Debian images will not be shipped for .NET 10 (#49953)
* Initial plan * Clarify that Debian images will not be shipped for .NET 10 Co-authored-by: lbussell <[email protected]> * Apply suggestions from code review --------- Co-authored-by: copilot-swe-agent[bot] <[email protected]> Co-authored-by: lbussell <[email protected]> Co-authored-by: Logan Bussell <[email protected]>
1 parent 1d845f4 commit ca2ed20

File tree

1 file changed

+5
-3
lines changed

1 file changed

+5
-3
lines changed

docs/core/compatibility/containers/10.0/default-images-use-ubuntu.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ The default Linux distro for .NET tags has been changed from Debian to Ubuntu. T
1212
- `docker pull mcr.microsoft.com/dotnet/sdk:10.0` - Refers to Ubuntu 24.04 "Noble Numbat"
1313
- `docker pull mcr.microsoft.com/dotnet/sdk:10.0-noble` - Refers to Ubuntu 24.04 "Noble Numbat"
1414

15-
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).
15+
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).
1616

1717
## Version introduced
1818

@@ -24,7 +24,7 @@ In .NET 9 and earlier versions, default tags referenced images based on Debian.
2424

2525
## New behavior
2626

27-
Starting in .NET 10, default tags reference images based on Ubuntu.
27+
Starting in .NET 10, the default container image tags reference Ubuntu images. Additionally, Debian-based images are no longer provided.
2828

2929
## Type of breaking change
3030

@@ -36,7 +36,9 @@ Debian and .NET release cycles (for mainline support) are the same length, while
3636

3737
## Recommended action
3838

39-
Test your application. This change is unlikely to affect users.
39+
Test your application with Ubuntu-based images. This change is unlikely to affect most users.
40+
41+
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.
4042

4143
## Affected APIs
4244

0 commit comments

Comments
 (0)