Missing information on how to get localization working on Linux images

[R4cOOn]

Type of issue

Other (describe below)

Description

The page is missing information on how to get localization working on Linux.

From what I can gather, when using the official "alpine" images in Docker/Kubernetes the following packages must be installed:

• icu-libs
• icu-data-full
  using the apk add --no-cahce icu-data-full icu-libs command and then setting the environment variable as documented in this page.

Failure to install both packages will make the code run without exception but won't do the actual localization.

Page URL

https://learn.microsoft.com/en-us/dotnet/core/runtime-config/globalization

Content source URL

https://github.com/dotnet/docs/blob/live/docs/core/runtime-config/globalization.md

Document Version Independent Id

5591d41e-b330-8066-e193-79c6ff037fb6

Article author

@gewarren

Metadata

• ID: 047c947a-f6e8-5aa8-3217-37687eedb408
• Service: dotnet-fundamentals

[gewarren]

@richlander Can you confirm this information?

[richlander]

Sorry for the delay in answering!

We started down a new path with .NET 8, adding ICU and tzdata in a new extra image flavor:

• Announcement: New approach for differentiating .NET 8+ images dotnet-docker#4821
• https://github.com/dotnet/dotnet-docker/blob/main/samples/enable-globalization.md
• Add runtime-deps extra Dockerfiles and conform to new packaging strategy dotnet-docker#4847
• Add Ubuntu Chiseled extra images for Runtime and ASP.NET Core dotnet-docker#5028

Note: tzdata has a new challenge, which we've resolved:

• Add tzdata-legacy package to Ubuntu Noble and Noble Chiseled extra images dotnet-docker#6110

We provided a full set of extra images for Azure Linux and Ubuntu Chiseled. For Alpine, we provided a extra image for the runtime-deps layer only. That works well for self-contained apps.

There is an open issue requesting to expand that:

• Provide an official ASP.NET alpine-extra image with globalization support (ICU and tzdata) dotnet-docker#4955

You can see how our alpine-extra images are configured: https://github.com/dotnet/dotnet-docker/blob/0a4258cc250885be5162d01f178bff5c856291f4/src/runtime-deps/8.0/alpine3.20-extra/amd64/Dockerfile#L15-L16. Following that pattern -- for example using an aspnet Alpine image -- will work.