[Breaking change]: Debian container images upgraded to Debian 12 (Bookworm)

[mthalman]

Description

The default Linux distro for .NET container images is Debian. In .NET 8, the Debian version has been upgraded to Debian 12 (Bookworm). This new version of Debian may have changes in it that break your application as is the case with any OS version upgrade. This is a result of upgraded package versions. The most notable change is the upgrade of Open SSL from 1.1 to 3.0.

Version

.NET 8 Preview 1

Previous behavior

In .NET 6 and 7, the default Debian version was Debian 11 (Bullseye).

Notable package versions:

• libicu: 67
• libssl: 1.1

New behavior

In .NET 8, the default Debian version is Debian 12 (Bookworm).

Notable package versions:

• libicu: 72
• libssl: 3

Type of breaking change

• Binary incompatible: Existing binaries may encounter a breaking change in behavior, such as failure to load or execute, and if so, require recompilation.
• Source incompatible: When recompiled using the new SDK or component or to target the new runtime, existing source code may require source changes to compile successfully.
• Behavioral change: Existing binaries may behave differently at run time.

Reason for change

According to the container support policy, with each version of .NET, the latest stable version of Debian is targeted as the default version.

Recommended action

Please review Debian 12's release notes for more details.

Feature area

Deployment

Affected APIs

No response

---

Associated WorkItem - 118221