Update Linux support statements #7971

richlander · 2022-11-17T01:39:07Z

No description provided.

linux-support.md

jkotas · 2022-11-17T01:47:20Z

linux-support.md

+.NET can be installed on your distribution using one of the follow approaches:
+
+* Install from the [official archive for your distribution](./linux.md).
+* Install the [Microsoft Linux build](https://dotnet.microsoft.com/download), which is built to run on any distro with compatible dependencies (including libc).


https://dotnet.microsoft.com/download link auto-detects the OS, so it won't show you how to install on Linux unless you are actually on Linux box.

You can force it to show linux by using https://dotnet.microsoft.com/download?initial-os=linux

linux-support.md

jkotas · 2022-11-17T01:56:56Z

linux-support.md

+
+* Install from the [official archive for your distribution](./linux.md).
+* Install the [Microsoft Linux build](https://dotnet.microsoft.com/download), which is built to run on any distro with compatible dependencies (including libc).
+* Build from source via [dotnet/source-build](https://github.com/dotnet/source-build).


Suggested change

* Build from source via [dotnet/source-build](https://github.com/dotnet/source-build).

I would delete it from here and just leave the paragraph at the end of linux.md. This is very advanced option.

I was wanting to leave something for distro-owners. How should we communicate that. I think they are more likely to find these files than dotnet/source-build.

Should we add a call to action like "If you are interested in packaging .NET for your distribution, please see to get started"?

linux-support.md

bartonjs · 2022-11-17T04:43:26Z

linux-support.md

+.NET has two policies for OpenSSL:
+
+- When built into a distro archive, .NET will load a specific OpenSSL version, per the distro archive policy.
+- When built by Microsoft (as a portable Linux build), .NET will the highest OpenSSL version it finds (that it supports), but can be configured to use a specific version.


This is... true... but not always.

If we add support for a new OpenSSL via servicing it gets added as the lowest priority. (IIRC, we added support for 1.1.x lower than 1.0.x because we did so late or in servicing; then made 1.1.x the higher priority in the next release)

I didn't realize that. That's certainly good context, but it is also messy. Do you have a specific edit you'd like me to take?

Not a specific edit, no. Though throwing in a weasel word like "generally" is probably good enough.

When built by Microsoft (as a portable Linux build), .NET will generally use the highest OpenSSL version it finds (that it supports), but can be configured to use a specific version.

Perhaps?

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

richlander · 2022-11-17T06:45:25Z

See: dotnet/docs#32638

richlander · 2022-11-17T06:47:31Z

linux-support.md

+.NET can be installed on your distribution using one of the following approaches:
+
+* Install from the [official archive for your distribution](./linux.md).
+* Install the [Microsoft Linux build](https://dotnet.microsoft.com/download/dotnet), which is built to run on any distro with compatible dependencies (including libc).


Suggested change

* Install the [Microsoft Linux build](https://dotnet.microsoft.com/download/dotnet), which is built to run on any distro with compatible dependencies (including libc).

* Install the [Microsoft Linux build](https://dotnet.microsoft.com/download?initial-os=linux), which is built to run on any distro with compatible dependencies (including libc).

https://dotnet.microsoft.com/download?initial-os=linux just has a big button that points to the doc page with the actual install instructions.

Should we link https://learn.microsoft.com/en-us/dotnet/core/install/linux directly from here to skip the click-through?

richlander · 2022-11-17T06:48:01Z

linux.md

@@ -0,0 +1,40 @@
+# .NET for Linux Distributions
+
+.NET can be [installed on Linux](https://learn.microsoft.com/dotnet/core/install/linux) in multiple ways, via packages, [scripts](https://github.com/dotnet/install-scripts), or [tarballs](https://dotnet.microsoft.com/en-us/download). It can be installed globally, locally/privately, or with an app.


Suggested change

.NET can be [installed on Linux](https://learn.microsoft.com/dotnet/core/install/linux) in multiple ways, via packages, [scripts](https://github.com/dotnet/install-scripts), or [tarballs](https://dotnet.microsoft.com/en-us/download). It can be installed globally, locally/privately, or with an app.

.NET can be [installed on Linux](https://learn.microsoft.com/dotnet/core/install/linux) in multiple ways, via packages, [scripts](https://github.com/dotnet/install-scripts), or [tarballs](https://dotnet.microsoft.com/download?initial-os=linux). It can be installed globally, locally/privately, or with an app.

omajid · 2022-11-17T13:51:10Z

linux-support.md

+.NET has two policies for OpenSSL:
+
+- When built into a distro archive, .NET will load a specific OpenSSL version, per the distro archive policy.
+- When built by Microsoft (as a portable Linux build), .NET will load the highest OpenSSL version it finds (that it supports), but can be configured to use a specific version.


There is a nuance here in that when we added support for a newer OpenSSL version to an existing release (eg dotnet/corefx#34443) we tried to make sure it still looks for OpenSSL versions in the same order as before the modification.

omajid · 2022-11-17T13:54:41Z

linux-support.md

+
+New .NET versions will typically only be supported on RHEL era distributions in active support. Check [release notes](./release-notes/README.md) for a given .NET version for specific support information.
+
+Red Hat family distributions include: AlmaLinux, CentOS, Fedora, Oracle Linux, Red Hat Enterprise Linux, and Rocky Linux.


Fedora is a bit of an odd one in this list. All others are RHEL or RHEL rebuilds. They follow the same versions as RHEL (and the list above). Fedora has it's own versions, schedules, releases and versions of components like openssl and glibc.

Not saying that Fedora shouldn't be supported, but I am not sure it belongs in a list where very other distro is a rebuild of RHEL.

linux.md

omajid · 2022-11-17T13:57:55Z

linux.md

+.NET containers are published to multiple registries.
+
+- [Microsoft Artifact Repository](https://mcr.microsoft.com/catalog?search=dotnet/)
+- [OpenShift](https://developers.redhat.com/blog/2018/07/05/deploy-dotnet-core-apps-openshift)


@aslicerh should we point to the Red Hat container catalog here too?

Works for me! Please update it. You choose.

omajid · 2022-11-17T13:58:48Z

linux.md

+- [OpenShift](https://developers.redhat.com/blog/2018/07/05/deploy-dotnet-core-apps-openshift)
+- [Ubuntu Rocks](https://hub.docker.com/r/ubuntu/dotnet-aspnet)
+
+Microsoft publishes container images per [.NET container publishing policy](https://github.com/dotnet/dotnet-docker/blob/main/documentation/supported-platforms.md).


Should we talk about the policies of others (eg, Rocks, Red Hat), even if it's "others may have a different policy"?

linux-support.md

omajid · 2022-11-17T14:56:19Z

linux.md

+
+.NET can be built from source via [dotnet/source-build](https://github.com/dotnet/source-build). This capability is expanding with [dotnet/dotnet](https://github.com/dotnet/dotnet) (which also uses source-build).
+
+For distributions publishing packages, please follow the [official packaging guidelines](https://learn.microsoft.com/dotnet/core/distribution-packaging#recommended-packages).


Should we add some motivation here? Something like "Not following this will probably break the Side-by-Side versioning experience of .NET"?

That context should be in the linked document, IMO.

linux.md

jkotas · 2022-11-17T15:32:49Z

linux-support.md

@@ -0,0 +1,55 @@
+# .NET Support and Compatibility for Linux Distributions
+
+.NET is officially supported on multiple [Linux distributions](os-support-lifecycle.md) and [supported by the community on several others](linux.md).


officially supported

I would avoid "officially" in these docs. It feels superfluous and/or ambiguous.

Officially supported -> Supported by Microsoft

Official packaging guidelines -> packaging guidelines. (We do not have non-official packaging guidelines.)

jkotas · 2022-11-17T15:34:47Z

linux-support.md

+
+## Linux distributions support
+
+.NET can typically be run on any Linux distribution.  Commercially supported distributions are listed in [.NET Supported OS Policy](./os-lifecycle-policy.md), while other distributions are supported at best effort per the compatibility rules above.


Tizen is commercially supported Linux distro as well...

jkotas · 2022-11-17T17:27:09Z

linux-support.md

+ldd (Ubuntu GLIBC 2.35-0ubuntu3.1) 2.35
+```
+
+## OpenSSL compatibility


Similar compatibility constrains and policies apply to ICU and other unmanaged dependencies.

It includes libc when built into distro archive. dotnet binaries built into distro archive target glibc version targeted by the distro. The versions from the previous paragraph do not apply.

Would it be better to start this doc by saying that the dotnet built into a distro archive is typically hardbound to the specific versions of libraries included in the distro. And the rest of the doc would only talk about policies used by (Microsoft) portable build.

linux-support.md

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

richlander · 2022-11-18T06:06:06Z

I believe I addressed most/all of the feedback.

@bartonjs -- Is there a link for how to configure which OpenSSL version you want to use?

jkotas

LGTM!

leecow · 2022-11-18T18:25:42Z

linux.md

+
+.NET is supported on Linux per [.NET Support and Compatibility for Linux Distributions](linux-support.md).
+
+## Official archives


Would it be appropriate to include a small caution note in this section for any customers migrating from packages.microsoft.com usage?

Yes. Good call.

We could link to this, or is it too specific? #7699

There's also https://github.com/dotnet/docs/blob/main/docs/core/install/linux-package-mixup.md that provides similar info

linux-support.md

Co-authored-by: Omair Majid <omajid@redhat.com>

Update Linux support statements

9738d17

richlander requested review from rbhanda, leecow and dcwhittaker as code owners November 17, 2022 01:39

jkotas reviewed Nov 17, 2022

View reviewed changes

linux-support.md Outdated Show resolved Hide resolved

jkotas reviewed Nov 17, 2022

View reviewed changes

linux-support.md Outdated Show resolved Hide resolved

jkotas reviewed Nov 17, 2022

View reviewed changes

linux-support.md Outdated Show resolved Hide resolved

bartonjs reviewed Nov 17, 2022

View reviewed changes

Apply suggestions from code review

534ec94

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

richlander mentioned this pull request Nov 17, 2022

Simplify linux doc dotnet/docs#32638

Merged

richlander commented Nov 17, 2022

View reviewed changes

omajid reviewed Nov 17, 2022

View reviewed changes

linux.md Outdated Show resolved Hide resolved

omajid reviewed Nov 17, 2022

View reviewed changes

jkotas reviewed Nov 17, 2022

View reviewed changes

linux-support.md Outdated Show resolved Hide resolved

omajid reviewed Nov 17, 2022

View reviewed changes

jkotas reviewed Nov 17, 2022

View reviewed changes

linux.md Outdated Show resolved Hide resolved

jkotas reviewed Nov 17, 2022

View reviewed changes

richlander commented Nov 18, 2022

View reviewed changes

linux-support.md Outdated Show resolved Hide resolved

richlander and others added 3 commits November 17, 2022 19:29

Apply suggestions from code review

5996e07

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

Update per feedback

d7cc988

Update per feedback

99b3cf3

jkotas approved these changes Nov 18, 2022

View reviewed changes

leecow approved these changes Nov 18, 2022

View reviewed changes

leecow reviewed Nov 18, 2022

View reviewed changes

omajid reviewed Nov 18, 2022

View reviewed changes

linux-support.md Outdated Show resolved Hide resolved

richlander and others added 4 commits November 18, 2022 12:17

Update linux-support.md

507c44c

Co-authored-by: Omair Majid <omajid@redhat.com>

Update per feedback

9f4f386

Update per feedback

b536575

Update wording

cc63349

richlander merged commit 4131427 into dotnet:main Nov 19, 2022

richlander deleted the linux-support branch November 19, 2022 01:05

	* Install the [Microsoft Linux build](https://dotnet.microsoft.com/download/dotnet), which is built to run on any distro with compatible dependencies (including libc).
	* Install the [Microsoft Linux build](https://dotnet.microsoft.com/download?initial-os=linux), which is built to run on any distro with compatible dependencies (including libc).

		@@ -0,0 +1,40 @@
		# .NET for Linux Distributions

		.NET can be [installed on Linux](https://learn.microsoft.com/dotnet/core/install/linux) in multiple ways, via packages, [scripts](https://github.com/dotnet/install-scripts), or [tarballs](https://dotnet.microsoft.com/en-us/download). It can be installed globally, locally/privately, or with an app.


		New .NET versions will typically only be supported on RHEL era distributions in active support. Check [release notes](./release-notes/README.md) for a given .NET version for specific support information.

		Red Hat family distributions include: AlmaLinux, CentOS, Fedora, Oracle Linux, Red Hat Enterprise Linux, and Rocky Linux.


		.NET can be built from source via [dotnet/source-build](https://github.com/dotnet/source-build). This capability is expanding with [dotnet/dotnet](https://github.com/dotnet/dotnet) (which also uses source-build).

		For distributions publishing packages, please follow the [official packaging guidelines](https://learn.microsoft.com/dotnet/core/distribution-packaging#recommended-packages).

		@@ -0,0 +1,55 @@
		# .NET Support and Compatibility for Linux Distributions

		.NET is officially supported on multiple [Linux distributions](os-support-lifecycle.md) and [supported by the community on several others](linux.md).


		## Linux distributions support

		.NET can typically be run on any Linux distribution. Commercially supported distributions are listed in [.NET Supported OS Policy](./os-lifecycle-policy.md), while other distributions are supported at best effort per the compatibility rules above.


		.NET is supported on Linux per [.NET Support and Compatibility for Linux Distributions](linux-support.md).

		## Official archives

Update Linux support statements #7971

Update Linux support statements #7971

Uh oh!

Conversation

richlander commented Nov 17, 2022

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

richlander commented Nov 17, 2022

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

richlander commented Nov 18, 2022

Uh oh!

jkotas left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!