-
Notifications
You must be signed in to change notification settings - Fork 4.9k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
* Cleanup wording * Update wording * Provide a better explanation on portable builds * Update linux-support.md Co-authored-by: Maira Wenzel <[email protected]> * Merge all content into a single document * Add additional container registries * Update support.md Co-authored-by: Jan Kotas <[email protected]> --------- Co-authored-by: Maira Wenzel <[email protected]> Co-authored-by: Jan Kotas <[email protected]>
- Loading branch information
3 people
authored
Jun 26, 2024
1 parent
763e620
commit e1e716d
Showing
4 changed files
with
81 additions
and
83 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,59 +1,3 @@ | ||
| # .NET Support and Compatibility for Linux Distributions | ||
|
|
||
| .NET is supported by various [commercial and community organizations](support.md) on [multiple Linux distributions](linux.md). | ||
|
|
||
| .NET can be run on any Linux distribution, via: | ||
|
|
||
| - Portable builds, which are built to be broadly compatible with most Linux distributions. | ||
| - Distribution-specific builds, which are built specifically for a given distribution version (like Red Hat Enterprise Linux 9 or Ubuntu 22.04). | ||
|
|
||
| Microsoft builds are portable builds. | ||
|
|
||
| ## General dependencies | ||
|
|
||
| Portable builds have multiple dependencies that must be installed: | ||
|
|
||
| - [.NET 6 dependencies](./release-notes/6.0/linux-packages.md) | ||
| - [.NET 7 dependencies](./release-notes/7.0/linux-packages.md) | ||
| - [.NET 8 dependencies](./release-notes/8.0/linux-packages.md) | ||
|
|
||
| ## libc compatibility | ||
|
|
||
| Portable builds supports both [glibc](https://www.gnu.org/software/libc/)-based and [musl libc](https://musl.libc.org/)-based Linux distributions, per the following minimum version information. | ||
|
|
||
| - [.NET 6 minimum libc](release-notes/6.0/supported-os.md#libc-compatibility) | ||
| - [.NET 7 minimum libc](release-notes/7.0/supported-os.md#libc-compatibility) | ||
| - [.NET 8 minimum libc](release-notes/8.0/supported-os.md#libc-compatibility) | ||
|
|
||
| You can use the following pattern to determine the libc version provided for your distribution. | ||
|
|
||
| On Alpine: | ||
|
|
||
| ```bash | ||
| # ldd --version | ||
| musl libc (aarch64) | ||
| Version 1.2.3 | ||
| ``` | ||
|
|
||
| On Ubuntu: | ||
|
|
||
| ```bash | ||
| # ldd --version | ||
| ldd (Ubuntu GLIBC 2.35-0ubuntu3.1) 2.35 | ||
| ``` | ||
|
|
||
| ## 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 | ||
|
|
||
| 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. | ||
|
|
||
| RHEL compatible distributions are supported, including: AlmaLinux, CentOS, Oracle Linux, and Rocky Linux. | ||
| This content has been moved to [linux.md](linux.md). |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,35 +1,38 @@ | ||
| # .NET Support and Distributions | ||
| # .NET Support | ||
|
|
||
| .NET is available (as a binary distribution) in many package managers and official download sites. These builds of .NET are provided and supported by organizations that participate in the .NET community, [build .NET from source](https://github.com/dotnet/dotnet), and offer stable binaries to their users. These organizations work together to enable developers to be productive and safe on Linux, macOS, and Windows. | ||
| .NET binaries, packages, and container images are provided and supported by organizations that participate in the .NET community, [build .NET from source](https://github.com/dotnet/dotnet), and offer regularly updated assets to their users. These organizations work together to enable developers to be productive and safe on Linux, macOS, and Windows. | ||
|
|
||
| Patches are provided for functional or security issues, typically monthly on [Patch Tuesday](https://en.wikipedia.org/wiki/Patch_Tuesday). | ||
| ## Policies | ||
|
|
||
| .NET is supported per the following policies: | ||
|
|
||
| * [.NET releases](releases.md) | ||
| * [.NET release policies](release-policies.md) | ||
| * [.NET supported operating system lifecycle](os-lifecycle-policy.md). | ||
| * [.NET supported operating system lifecycle](os-lifecycle-policy.md) | ||
|
|
||
| ## Community support | ||
|
|
||
| Community support is available on GitHub, such as at [dotnet/core](https://github.com/dotnet/core). | ||
|
|
||
| Community builds are available for [Linux](linux.md) and [macOS](https://formulae.brew.sh/cask/dotnet-sdk). | ||
| Community builds are available for [FreeBSD](https://wiki.freebsd.org/.NET), [Linux](linux.md), and [macOS](https://formulae.brew.sh/cask/dotnet-sdk) | ||
|
|
||
| ## Commercial support | ||
|
|
||
| Official builds and commercial support is available from the following companies: | ||
| Commercial support is provided by the following companies. | ||
|
|
||
| ## Canonical | ||
| ### Canonical | ||
|
|
||
| Canonical supports .NET on Ubuntu, per the following. | ||
|
|
||
| - .NET 6 is supported in Ubuntu 22.04. | ||
| - .NET 7 is supported in Ubuntu 22.04. | ||
| - .NET 8 is supported in Ubuntu 23.10+. | ||
| * .NET 6 is supported in Ubuntu 22.04+ | ||
| * .NET 8 is supported in Ubuntu 22.04+. | ||
|
|
||
| ## Microsoft | ||
| ### Microsoft | ||
|
|
||
| Microsoft provides [stable builds](https://dotnet.microsoft.com/download) and [commercial support](https://support.serviceshub.microsoft.com/supportforbusiness/onboarding) for .NET on Linux, macOS, and Windows, per [.NET support policy](https://dotnet.microsoft.com/platform/support/policy). | ||
| Microsoft provides [stable builds](https://dotnet.microsoft.com/download) and [commercial support](https://support.serviceshub.microsoft.com/supportforbusiness/onboarding) for .NET on [multiple operating systems](os-lifecycle-policy.md), per [.NET support policy](https://dotnet.microsoft.com/platform/support/policy). | ||
|
|
||
| A more restrictive policy is used for [.NET container images](https://github.com/dotnet/dotnet-docker/blob/main/documentation/supported-platforms.md). | ||
| .NET container images are provided for a more limited set of [operating system versions](https://github.com/dotnet/dotnet-docker/blob/main/documentation/supported-platforms.md). | ||
|
|
||
| ## Red Hat | ||
| ### Red Hat | ||
|
|
||
| Red Hat supports .NET on Red Hat Enterprise Linux, per [.NET life cycle policy](https://access.redhat.com/support/policy/updates/net-core). |