在 SLES 上安装 .NET SDK 或 .NET 运行时

  • 项目

SLES 支持 .NET。 本文介绍如何在 SLES 上安装 .NET。

如果要开发 .NET 应用，请安装 SDK（包括运行时）。 或者，如果只需运行应用程序，请安装运行时。 如果要安装该运行时，建议安装 ASP.NET Core 运行时，因为它同时包括 .NET 和 ASP.NET Core 运行时。

使用 dotnet --list-sdks 和 dotnet --list-runtimes 命令查看安装的版本。 有关详细信息，请参阅如何检查是否已安装 .NET。

支持的发行版

下表列出了 SLES 12 SP2 和 SLES 15 上当前受支持的 .NET 版本。 这些版本在 .NET 达到支持终止日期或 SLES 版本不再受到支持之前仍受支持。

SLES .NET
15 8、7、6
12 SP5 8、7、6

以下 .NET 版本 ❌ 不再受到支持：

  • .NET 5
  • .NET Core 3.1
  • .NET Core 3.0
  • .NET Core 2.2
  • .NET Core 2.1
  • .NET Core 2.0

安装预览版本

包存储库中未提供 .NET 的预览版和候选发布版本。 可通过下面其中一种方式安装 .NET 的预览版和候选发布版本：

删除预览版本

使用包管理器管理 .NET 安装时，如果之前安装了预览版本，则可能会遇到冲突。 包管理器可能会将非预览版本解释为 .NET 的较早版本。 若要安装非预览版本，需要首先卸载预览版本。 有关如何卸载 .NET 的详细信息，请参阅如何删除 .NET 运行时和 SDK。

SLES 15

安装 .NET 之前，请运行以下命令，将 Microsoft 包签名密钥添加到受信任密钥列表，并添加 Microsoft 包存储库。 打开终端并运行以下命令：

sudo rpm -Uvh https://packages.microsoft.com/config/sles/15/packages-microsoft-prod.rpm

目前，SLES 15 Microsoft 存储库安装包会将 microsoft-prod.repo 文件安装到错误的目录，从而导致 zypper 找不到 .NET 包。 若要解决此问题，请在正确的目录中创建一个符号链接。

sudo ln -s /etc/yum.repos.d/microsoft-prod.repo /etc/zypp/repos.d/microsoft-prod.repo

安装 SDK

.NET SDK 使你可以通过 .NET 开发应用。 如果安装 .NET SDK，则无需安装相应的运行时。 若要安装 .NET SDK，请运行以下命令：

sudo zypper install dotnet-sdk-8.0

安装运行时

通过 ASP.NET Core 运行时，可以运行使用 .NET 开发且未提供运行时的应用。 以下命令将安装 ASP.NET Core 运行时，这是与 .NET 最兼容的运行时。 在终端中，运行以下命令：

sudo zypper install aspnetcore-runtime-8.0

作为 ASP.NET Core 运行时的一种替代方法，你可以安装不包含 ASP.NET Core 支持的 .NET 运行时：将上一命令中的 aspnetcore-runtime-8.0 替换为 dotnet-runtime-8.0：

sudo zypper install dotnet-runtime-8.0

SLES 12

SLES 12 系列的 .NET 需要至少为 SP2。

安装 .NET 之前，请运行以下命令，将 Microsoft 包签名密钥添加到受信任密钥列表，并添加 Microsoft 包存储库。 打开终端并运行以下命令：

sudo rpm -Uvh https://packages.microsoft.com/config/sles/12/packages-microsoft-prod.rpm

安装 SDK

.NET SDK 使你可以通过 .NET 开发应用。 如果安装 .NET SDK，则无需安装相应的运行时。 若要安装 .NET SDK，请运行以下命令：

sudo zypper install dotnet-sdk-8.0

安装运行时

通过 ASP.NET Core 运行时，可以运行使用 .NET 开发且未提供运行时的应用。 以下命令将安装 ASP.NET Core 运行时，这是与 .NET 最兼容的运行时。 在终端中，运行以下命令：

sudo zypper install aspnetcore-runtime-8.0

作为 ASP.NET Core 运行时的一种替代方法，你可以安装不包含 ASP.NET Core 支持的 .NET 运行时：将上一命令中的 aspnetcore-runtime-8.0 替换为 dotnet-runtime-8.0：

sudo zypper install dotnet-runtime-8.0

如何安装其他版本

.NET 的所有版本均可从 https://dotnet.microsoft.com/download/dotnet 下载，但需要手动安装。 可尝试使用包管理器来安装不同版本的 .NET。 但请求的版本可能不可用。

添加到包管理器源的包以可改动的格式命名，例如：{product}-{type}-{version}。

  • product
    要安装的 .NET 产品的类型。 有效选项是：

    • dotnet
    • aspnetcore

  • type
    选择 SDK 或运行时。 有效选项是：

    • sdk（仅适用于 dotnet 产品）
    • runtime

  • version
    要安装的 SDK 或运行时的版本。 有效选项为任何已发布的版本，例如：

    • 8.0
    • 6.0
    • 3.1
    • 2.1

    尝试下载的 SDK/运行时可能不适用于 Linux 发行版。 有关受支持的发行版列表，请参阅在 Linux 上安装 .NET。

示例

  • 安装 ASP.NET Core 8.0 运行时：aspnetcore-runtime-8.0
  • 安装 .NET Core 2.1 运行时：dotnet-runtime-2.1
  • 安装 .NET 5 SDK：dotnet-sdk-5.0
  • 安装 .NET Core 3.1 SDK：dotnet-sdk-3.1

注意

某些包在 Linux 发行版上可能不可用。

缺少包

如果包版本组合无效，则它不可用。 例如，没有 ASP.NET Core SDK。 ASP.NET Core 的 SDK 组件包含在 .NET SDK 中。 aspnetcore-sdk-8.0 的值不正确，应为 dotnet-sdk-8.0。 有关 .NET 支持的 Linux 发行版的列表，请参阅 .NET 依赖项和要求。

包管理器疑难解答

本部分提供有关使用包管理器安装 .NET 时可能会遇到的常见错误的信息。

未能提取

安装 .NET 包时，可能会看到类似于 signature verification failed for file 'repomd.xml' from repository 'packages-microsoft-com-prod' 的错误。 一般而言，此错误表示 .NET 的包源正在通过更新的包版本进行更新，应稍后重试。 升级期间，包源的不可用时间不应超过 2 小时。 如果持续收到此错误超过 2 小时，请在 https://github.com/dotnet/core/issues 中提交问题。

依赖项

使用包管理器进行安装时，将为你安装这些库。 但是，如果手动安装 .NET 或发布自包含的应用，则需要确保已安装以下库：

  • krb5
  • libicu
  • libopenssl1_1

如果目标运行时环境的 OpenSSL 版本为 1.1 或更高版本，则需要安装 compat-openssl10。

可以使用 zypper install 命令安装依赖项。 以下代码片段演示了如何安装 krb5 库：

sudo zypper install krb5

有关依赖项的详细信息，请参阅独立式 Linux 应用。

如果 .NET 应用使用 System.Drawing.Common 程序集，则还需要安装 libgdiplus。 由于 Linux 上不再支持 System.Drawing.Common，因此这仅适用于 .NET 6，并且需要设置 System.Drawing.EnableUnixSupport 运行时配置开关。

后续步骤