Red Hat Summit 红帽全球峰会支持控制台（Console）开发人员开始试用联系人

在 RHEL 9 中使用 .NET 8.0

.NET 8.0

在 RHEL 9 上安装并运行 .NET 8.0

Red Hat Customer Content Services

摘要

本指南论述了如何在 RHEL 9 上安装和运行 .NET 8.0。

使开源包含更多
复制链接

红帽致力于替换我们的代码、文档和 Web 属性中有问题的语言。我们从这四个术语开始：master、slave、黑名单和白名单。由于此项工作十分艰巨，这些更改将在即将推出的几个发行版本中逐步实施。详情请查看 CTO Chris Wright 的信息。

对红帽文档提供反馈
复制链接

我们感谢您对我们文档的反馈。让我们了解如何改进它。

通过 Jira 提交反馈（需要帐户）

  1. 登录到 Jira 网站。
  2. 在顶部导航栏中点 Create
  3. 在 Summary 字段中输入描述性标题。
  4. 在 Description 字段中输入您对改进的建议。包括文档相关部分的链接。
  5. 点对话框底部的 Create。

第 1 章 .NET 8.0 简介
复制链接

.NET 是一个通用开发平台，它带有自动内存管理和现代编程语言。使用 .NET，您可以有效地构建高质量的应用程序。.NET 可通过认证的容器在 Red Hat Enterprise Linux (RHEL)和 OpenShift Container Platform 上提供。

.NET 提供以下功能：

  • 能够遵循基于微服务的方法，其中某些组件使用 .NET 构建，其他组件则使用 Java 构建，但所有组件都可以在 RHEL 和 OpenShift Container Platform 上的通用支持的平台中运行。
  • 在 Microsoft Windows 上更轻松地开发新的 .NET 工作负载的能力。您可以在 RHEL 或 Windows Server 上部署并运行应用程序。
  • 一个异构的数据中心，底层基础结构可以在不需要依赖 Windows 服务器的情况下运行 .NET 应用程序。

RHEL 8.9 及更新的版本、RHEL 9.3 及更新的版本以及支持的 OpenShift Container Platform 版本支持 .NET 8.0。

第 2 章 Installing .NET 8.0
复制链接

.NET 8.0 包括在 RHEL 9 的 AppStream 存储库中。AppStream 软件仓库在 RHEL 9 系统中默认启用。

您可以使用最新的 8.0 软件开发套件(SDK)安装 .NET 8.0 运行时。当较新的 SDK 可供 .NET 8.0 使用时，您可以运行 sudo yum install 来安装它。

先决条件

流程

  • 安装 .NET 8.0 及其所有依赖项： 

    $ sudo yum install dotnet-sdk-8.0 -y
    Copy to Clipboard Toggle word wrap

验证步骤

  • 验证安装： 

    $ dotnet --info
    Copy to Clipboard Toggle word wrap

    输出返回有关 .NET 安装和环境的相关信息。

第 3 章 使用 .NET 8.0 创建应用程序
复制链接

了解如何创建 C# hello-world 应用程序。

流程

  1. 在名为 my-app 的目录中创建一个新的 Console 应用程序： 

    $ dotnet new console --output my-app
    Copy to Clipboard Toggle word wrap

    输出返回： 

    The template "Console Application" was created successfully.

Processing post-creation actions...
Running 'dotnet restore' on my-app/my-app.csproj...
  Determining projects to restore...
  Restored /home/username/my-app/my-app.csproj (in 67 ms).
Restore succeeded.
    Copy to Clipboard Toggle word wrap

    从模板创建简单的 Hello World 控制台应用。应用程序存储在指定的 my-app 目录中。

验证步骤

  • 运行项目： 

    $ dotnet run --project my-app
    Copy to Clipboard Toggle word wrap

    输出返回： 

    Hello World!
    Copy to Clipboard Toggle word wrap

第 4 章 使用 .NET 8.0 发布应用程序
复制链接

.NET 8.0 应用程序可以发布，以使用共享的系统范围 .NET 版本或包含 .NET。

发布 .NET 8.0 应用程序有以下方法：

  • 自助包含部署(SCD)- 应用程序包括 .NET。此方法使用 Microsoft 构建的运行时。
  • 框架依赖的部署(FDD)- 应用程序使用共享的系统范围版本 .NET。
注意

当为 RHEL 发布应用程序时，红帽建议使用 FDD，因为它确保应用程序使用最新的 .NET 版本（由红帽构建）来使用一组原生依赖项。

先决条件

4.1. 发布 .NET 应用程序
复制链接

以下流程概述了如何发布与框架相关的应用程序。

流程

  1. 发布与框架相关的应用程序： 

    $ dotnet publish my-app -f net8.0
    Copy to Clipboard Toggle word wrap

    将 my-app 替换为您要发布的应用程序的名称。

  2. 可选： 如果应用程序仅适用于 RHEL，请修剪其他平台所需的依赖项： 

    $ dotnet publish my-app -f net8.0 -r rhel.9-architecture --self-contained false
    Copy to Clipboard Toggle word wrap

    • 根据您使用的平台替换 构架 ：

      • 对于 Intel： x64
      • 对于 IBM Z 和 LinuxONE: s390x
      • 对于 64 位 Arm: arm64
      • 对于 IBM Power： ppc64le

第 5 章 在容器中运行 .NET 8.0 应用程序
复制链接

使用 ubi8/dotnet-80-runtime 镜像在 Linux 容器中运行 .NET 应用程序。

以下示例使用 podman。

流程

  1. 在名为 mvc_runtime_example 的目录中创建一个新的 MVC 项目： 

    $ dotnet new mvc --output mvc_runtime_example
    Copy to Clipboard Toggle word wrap

  2. 发布项目： 

    $ dotnet publish mvc_runtime_example -f net8.0 /p:PublishProfile=DefaultContainer /p:ContainerBaseImage=registry.access.redhat.com/ubi8/dotnet-80-runtime:latest
    Copy to Clipboard Toggle word wrap

  3. 运行您的镜像： 

    $ podman run --rm -p8080:8080 mvc_runtime_example
    Copy to Clipboard Toggle word wrap

验证步骤

  • 查看容器中运行的应用程序： 

    $ xdg-open http://127.0.0.1:8080
    Copy to Clipboard Toggle word wrap

6.1. 概述
复制链接

通过从 s2i-dotnetcore 导入镜像流定义，将 NET 镜像添加到 OpenShift。

镜像流定义包括 dotnet 镜像流，其中包含不同支持的 .NET 版本的 sdk 镜像。.NET 程序的生命周期和支持政策 提供了支持版本的最新概述。

Expand
VersionTagAlias

.NET 6.0

dotnet:6.0-ubi8

dotnet:6.0

.NET 7.0

dotnet:7.0-ubi8

dotnet:7.0

.NET 8.0

dotnet:8.0-ubi8

dotnet:8.0

sdk 镜像具有对应的运行时镜像，这些镜像在 dotnet-runtime 镜像流下定义。

容器镜像在不同的 Red Hat Enterprise Linux 和 OpenShift 版本间工作。基于 UBI-8 的镜像(suffix -ubi8)托管在 registry.access.redhat.com 上，不需要身份验证。

6.2. 安装 .NET 镜像流
复制链接

要安装 .NET 镜像流，请使用 s2i-dotnetcore 中的镜像流定义以及 OpenShift Client (oc)二进制文件。镜像流可以从 Linux、Mac 和 Windows 安装。

您可以在全局 openshift 命名空间中或本地在项目命名空间中定义 .NET 镜像流。更新 openshift 命名空间定义需要足够的权限。

流程

  1. 安装（或更新）镜像流： 

    $ oc apply [-n namespace] -f
https://raw.githubusercontent.com/redhat-developer/s2i-dotnetcore/main/dotnet_imagestreams.json
    Copy to Clipboard Toggle word wrap

6.3. 使用 oc从源部署应用程序
复制链接

以下示例演示了如何使用 oc 部署 example-app 应用程序，它位于 redhat-developer/s2i-dotnetcore-ex GitHub 存储库的 dotnet-8.0 分支上的 app 文件夹中：

流程

  1. 创建新的 OpenShift 项目： 

    $ oc new-project sample-project
    Copy to Clipboard Toggle word wrap

  2. 添加 ASP.NET Core 应用程序： 

    $ oc new-app --name=example-app 'dotnet:8.0-ubi8~https://github.com/redhat-developer/s2i-dotnetcore-ex#dotnet-8.0' --build-env DOTNET_STARTUP_PROJECT=app
    Copy to Clipboard Toggle word wrap

  3. 监控构建的进度： 

    $ oc logs -f bc/example-app
    Copy to Clipboard Toggle word wrap

  4. 构建完成后查看部署的应用程序： 

    $ oc logs -f dc/example-app
    Copy to Clipboard Toggle word wrap

    该应用现在可在项目内访问。

  5. 可选 ：使项目可以被外部访问： 

    $ oc expose svc/example-app
    Copy to Clipboard Toggle word wrap

  6. 获取可共享 URL： 

    $ oc get routes
    Copy to Clipboard Toggle word wrap

6.4. 使用 oc从二进制工件部署应用程序
复制链接

您可以使用 .NET Source-to-Image (S2I)构建器镜像来使用您提供的二进制工件构建应用程序。

先决条件

  1. 发布的应用程序。

    如需更多信息，请参阅

流程

  1. 创建新的二进制构建： 

    $ oc new-build --name=my-web-app dotnet:8.0-ubi8 --binary=true
    Copy to Clipboard Toggle word wrap

  2. 启动构建并指定本地机器中二进制工件的路径： 

    $ oc start-build my-web-app --from-dir=bin/Release/net8.0/publish
    Copy to Clipboard Toggle word wrap

  3. 创建新应用程序： 

    $ oc new-app my-web-app
    Copy to Clipboard Toggle word wrap

6.5. .NET 8.0 的环境变量
复制链接

.NET 镜像支持多个环境变量来控制 .NET 应用程序的构建行为。您可以将这些变量设置为构建配置的一部分，或者将它们添加到应用程序源代码存储库中的 .s2i/environment 文件中。

Expand
变量名称描述default

DOTNET_STARTUP_PROJECT

选择要运行的项目。这必须是项目文件（如 csproj 或 fsproj）或包含单个项目文件的文件夹。

.

DOTNET_ASSEMBLY_NAME

选择要运行的 assembly。这不得包含 .dll 扩展。把它设置为 csproj 中指定的输出装配名称(PropertyGroup/AssemblyName)。

csproj 文件的名称

DOTNET_PUBLISH_READYTORUN

当设置为 true 时，应用程序将提前编译。这可减少 JIT 加载时所需的工作量，从而缩短启动时间。

false

DOTNET_RESTORE_SOURCES

指定恢复操作中使用的 NuGet 软件包源的空格分隔列表。这会覆盖 NuGet.config 文件中指定的所有源。此变量不能与 DOTNET_RESTORE_CONFIGFILE 结合使用。

 

DOTNET_RESTORE_CONFIGFILE

指定用于恢复操作的 NuGet.Config 文件。此变量不能与 DOTNET_RESTORE_SOURCES 结合使用。

 

DOTNET_TOOLS

指定在构建应用程序前要安装的 .NET 工具列表。可以通过发布待处理软件包名称（带有 @ <version> ）来安装特定版本。

 

DOTNET_NPM_TOOLS

指定在构建应用程序前要安装的 NPM 软件包列表。

 

DOTNET_TEST_PROJECTS

指定要测试的测试项目列表。这必须是包含单个项目文件的项目文件或文件夹。为每个项目调用 dotnet test。

 

DOTNET_CONFIGURATION

以 Debug 或 Release 模式运行应用程序。这个值应该是 Release 或 Debug。

Release

DOTNET_VERBOSITY

指定 dotnet 构建 命令的详细程度。设置后，环境变量会在构建开始时打印。这个变量可以被设置为 msbuild verbosity 值（q[uiet]、m[inimal]、n[ormal]、d[etailed] 和 diag[nostic]）。

 

HTTP_PROXY, HTTPS_PROXY

配置分别构建和运行应用时使用的 HTTP 或 HTTPS 代理。

 

DOTNET_RM_SRC

当设置为 true 时，镜像中不包含源代码。

 

DOTNET_SSL_DIRS

弃用: 使用 SSL_CERT_DIR 替代

 

SSL_CERT_DIR

指定要信任的额外 SSL 证书的文件夹或文件列表。证书由构建期间运行的每个进程以及构建后在镜像中运行的所有进程（包括构建的应用程序）信任。这些项目可以是绝对路径（从 /开始）或源存储库中的路径（如证书）。

 

NPM_MIRROR

在构建过程中使用自定义 NPM registry 镜像下载软件包。

 

ASPNETCORE_URLS

这个变量设定为 http://*:8080 以配置 ASP.NET Core 以使用由镜像公开的端口。不建议更改此设置。

http://*:8080

DOTNET_RESTORE_DISABLE_PARALLEL

当设置为 true 时，会禁用并行恢复多个项目。这可减少构建容器以低 CPU 限值运行时恢复超时错误。

false

DOTNET_INCREMENTAL

当设置为 true 时，将保留 NuGet 软件包，以便它们可用于增量构建。

false

DOTNET_PACK

当设置为 true 时，在 /opt/app-root/app. tar.gz 中创建一个 tar.gz 文件，其中包含公布的应用程序。

 

6.6. 创建 MVC 示例应用程序
复制链接

s2i-dotnetcore-ex 是 .NET 的默认 Model, View, Controller (MVC)模板应用程序。

此应用程序被 .NET S2I 镜像用作示例应用程序，可以使用 Try 示例 链接直接从 OpenShift UI 创建。

也可以使用 OpenShift 客户端二进制文件(oc)创建应用。

流程

使用 oc 创建示例应用程序：

  1. 添加 .NET 应用程序： 

    $ oc new-app dotnet:8.0-ubi8~https://github.com/redhat-developer/s2i-dotnetcore-ex#dotnet-8.0 --context-dir=app
    Copy to Clipboard Toggle word wrap

  2. 使应用程序可以被外部访问： 

    $ oc expose service s2i-dotnetcore-ex
    Copy to Clipboard Toggle word wrap

  3. 获取 sharable URL: 

    $ oc get route s2i-dotnetcore-ex
    Copy to Clipboard Toggle word wrap

6.7. 创建 CRUD 示例应用程序
复制链接

s2i-dotnetcore-persistent-ex 是一个一个简单的 Create, Read, Update, Delete (CRUD).NET web 应用程序，它将数据存储在 PostgreSQL 数据库中。

流程

使用 oc 创建示例应用程序：

  1. 添加数据库： 

    $ oc new-app postgresql-ephemeral
    Copy to Clipboard Toggle word wrap

  2. 添加 .NET 应用程序： 

    $ oc new-app dotnet:8.0-ubi8~https://github.com/redhat-developer/s2i-dotnetcore-persistent-ex#dotnet-8.0 --context-dir app
    Copy to Clipboard Toggle word wrap

  3. 从 postgresql secret 和数据库服务名称环境变量添加环境变量： 

    $ oc set env dc/s2i-dotnetcore-persistent-ex --from=secret/postgresql -e database-service=postgresql
    Copy to Clipboard Toggle word wrap

  4. 使应用程序可以被外部访问： 

    $ oc expose service s2i-dotnetcore-persistent-ex
    Copy to Clipboard Toggle word wrap

  5. 获取 sharable URL: 

    $ oc get route s2i-dotnetcore-persistent-ex
    Copy to Clipboard Toggle word wrap

法律通告
复制链接

Copyright © 2025 Red Hat, Inc.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.
返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务，以及可以信赖的内容，帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情，请参阅红帽博客.

關於紅帽

我们提供强化的解决方案，使企业能够更轻松地跨平台和环境（从核心数据中心到网络边缘）工作。

Theme

© 2025 Red Hat