jprdonnelly/core
1
0
Fork 0
mirror of synced 2025-12-23 21:05:00 -05:00
Code Issues Projects Releases Wiki Activity

Cleanup support wording (#9364)

Browse Source 
* Cleanup wording

* Update wording

* Provide a better explanation on portable builds

* Update linux-support.md

Co-authored-by: Maira Wenzel <mairaw@microsoft.com>

* Merge all content into a single document

* Add additional container registries

* Update support.md

Co-authored-by: Jan Kotas <jkotas@microsoft.com>

---------

Co-authored-by: Maira Wenzel <mairaw@microsoft.com>
Co-authored-by: Jan Kotas <jkotas@microsoft.com>
This commit is contained in:
Rich Lander
2024-06-25 20:07:14 -07:00
committed by GitHub
parent 763e6208a6
commit e1e716de1c
4 changed files with 81 additions and 83 deletions
Download Patch File Download Diff File Expand all files Collapse all files

71
linux.md
View File

@@ -1,10 +1,22 @@
# .NET for Linux Distributions
# .NET Support and Compatibility for Linux Distributions
.NET can be installed on Linux in multiple ways, via [packages](https://learn.microsoft.com/dotnet/core/install/linux), [scripts](https://github.com/dotnet/install-scripts), or [tarballs](https://dotnet.microsoft.com/download/dotnet). It can be installed globally, locally/privately, or with an app.
.NET can be [installed](https://learn.microsoft.com/dotnet/core/install/linux) and run on almost any Linux distribution. Packages that are available in a given distribution are compatible with that distribution. Packages and binaries from Microsoft are compatible with a broad set of distributions.
.NET is supported on Linux per [.NET Support and Compatibility for Linux Distributions](linux-support.md).
The community provides best effort support for .NET across all Linux distributions. [Commercial support](support.md) is provided for some popular distributions.
## Package archives
## Containers
.NET containers are published to multiple registries.
- [Chainguard Images](https://images.chainguard.dev/directory/image/dotnet-sdk/versions)
- [Microsoft Artifact Repository](https://mcr.microsoft.com/catalog?search=dotnet/)
- [OpenShift](https://developers.redhat.com/blog/2018/07/05/deploy-dotnet-core-apps-openshift)
- [SUSE Linux Enterprise Server Container Images](https://registry.suse.com/repositories?languages%5B%5D=dotnet)
- [Ubuntu Rocks](https://hub.docker.com/r/ubuntu/dotnet-aspnet)
Note: Microsoft publishes container images per [.NET container publishing policy](https://github.com/dotnet/dotnet-docker/blob/main/documentation/supported-platforms.md). Other distributions may have different policies.
## Packages
.NET is included in the package archives of the following distributions:
@@ -28,15 +40,54 @@ Microsoft offers alternate package feeds at [packages.microsoft.com](http://pack
Microsoft is [no longer publishing packages for Ubuntu starting with Ubuntu 24.04](https://github.com/dotnet/core/discussions/9258).
## Containers
[SDK feature bands](https://learn.microsoft.com/en-us/dotnet/core/releases-and-support#feature-bands-sdk-only) are the only significant difference between Microsoft and distro-provided builds. Distro-provided SDK builds are always within the `.1xx` feature band, while Microsoft SDK builds are always for the latest feature band, for example `.2xx`.
.NET containers are published to multiple registries.
## Dependencies
- [Microsoft Artifact Repository](https://mcr.microsoft.com/catalog?search=dotnet/)
- [OpenShift](https://developers.redhat.com/blog/2018/07/05/deploy-dotnet-core-apps-openshift)
- [Ubuntu Rocks](https://hub.docker.com/r/ubuntu/dotnet-aspnet)
.NET has multiple dependencies that must be installed. If you install .NET via packages, these packages will typically already be installed.
Microsoft publishes container images per [.NET container publishing policy](https://github.com/dotnet/dotnet-docker/blob/main/documentation/supported-platforms.md). Other distributions may have different policies.
- [.NET 6 dependencies](./release-notes/6.0/linux-packages.md)
- [.NET 8 dependencies](./release-notes/8.0/linux-packages.md)
- [.NET 9 dependencies](./release-notes/9.0/linux-packages.md)
## Portable build compatibility
Portable builds are compiled to provide [broad compatibility](https://github.com/dotnet/runtime/issues/83428). The minimum supported libc version is documented in [.NET Supported OS Policy](./os-lifecycle-policy.md).
Microsoft provides [portable builds](https://dotnet.microsoft.com/download/dotnet) that support both [glibc](https://www.gnu.org/software/libc/)-based and [musl libc](https://musl.libc.org/)-based Linux distributions.
The following examples demonstrate how to find the libc version provided for your distribution.
On Alpine 3.13:
```bash
# ldd --version
musl libc (aarch64)
Version 1.2.2
```
On Ubuntu 16.04:
```bash
# ldd --version
ldd (Ubuntu GLIBC 2.23-0ubuntu11.3) 2.23
```
## OpenSSL compatibility
Portable builds support both OpenSSL 1.x and 3.x and can be run on distributions with either version of OpenSSL. For example, Ubuntu 22.04 only includes OpenSSL 3 in its official package archive.
The highest OpenSSL version is loaded by default, but it can be [configured to use a specific version](https://github.com/dotnet/runtime/issues/79153#issuecomment-1335476471).
## Red Hat Enterprise Linux support
RHEL-compatible distributions are supported, including: AlmaLinux, CentOS Stream, Oracle Linux, and Rocky Linux.
New .NET versions will typically only be supported on Red Hat Enterprise Linux (RHEL) versions in active support.
- RHEL 7 is considered in maintenance.
- RHEL 8 is considered in active support.
- RHEL 9 is considered in active support.
## Building .NET from source