AI专业者开发社区 5 号成员
  •  0 回帖  •  31 浏览  •  3 个月前
   

.NET 6应用程序适配国产银河麒麟V10系统随记

最近想在麒麟系统上运行.NET 6 程序，经过一番折腾最终完成了，简单记录一下。

目标系统:

  • CPU: aarch64 架构（ARM64)
  • 操作系统：银河麒麟 V10 高级服务器系统

银河麒麟 V10 系统（以下简称麒麟）使用的是 redhat 类似的 dnf 包管理方式，但是无法安装epel，因此很多软件无法直接包安装。

方案

  1. 直接在麒麟上安装 dotnet，并运行 dotnet 程序
    这种方式很直接，无奈 dotnet不支持在 ARM64 架构下的包管理安装，只能使用snap、安装脚本或者手动进行安装。然后snap我在麒麟上发现也不好装，一直没有成功；安装脚本需要连接国外的服务器，我这联外网有点问题，死活是装不上；手动方式我觉得好麻烦，直接放弃吧。

感兴趣的朋友可以参考这两篇文章：文章 1、文章 2

  1. 通过 docker 的形式执行 dotnet 程序
    这种方式兼容性强，只要对应依赖的组件有 aarch64 版本的 docker 镜像就可以用，dotnet 是有的，麒麟也支持 docker。

于是乎选择的使用 docker 进行部署，由于还需要部署数据库，选择使用 docker-compose 是更好的选择。只需要在系统中执行

dnf install docker docker-compose

系统即可安装好必要的 docker 组件。

要点记录

有关如何将在 Docker 上运行.NET 6 程序，很多文章已经有写，官网也有很详细的说明，我就不重复了写了。

.NET 程序参数传递

传统上.NET 程序一般使用appsettings.json进行参数的设置，在 docker 中，为了配置方便，更多使用环境变量进行参数的传递，默认.NET 依赖注入的IConfiguration就可以直接读取环境变量，但是对于手动的情况，需要指定AddEnvironmentVariables()方法：

var config = new ConfigurationBuilder()
.SetBasePath(Directory.GetCurrentDirectory())
.AddJsonFile("appsettings.json", optional: true)
.AddEnvironmentVariables()
.Build();

如果需要设置如下参数：

  "IdentityConfig": {
    "server.urls": "http://*:5000", // 服务地址
}

那么在 docker-compose 设置中应当这么写：

environment:
      # - ASPNETCORE_ENVIRONMENT=Docker
      - IdentityConfig__server.urls=http://*:5000 #

冒号在 yaml 配置中应当替换为两个连续下划线“__”，dotnet 读取配置的时候，依然可以使用config[IdentityConfig:server.urls]获得参数。

Dockerfile 设置

选择 docker 这种方式的话，需要从源代码编译.NET 应用，因此在执行Dockerfile的时候，会执行dotnet restore之类的命令，强烈建议换成国内的 nuget 源，国外的还是慢了点。

国内的有：

EMQ X 设备用户名与密码登录

最为非常流行的 mqtt 服务器，emqx 也提供了 docker 的安装方式。这里需要说一下，现在很多 mqtt 设备只能支持固定的用户名和密码登录，因此启动 docker 的时候，需要通过文件指定（在 EMQX 4.4 上测试通过）。

volumes:
      - ./emqx/emqx_auth_mnesia.conf:/opt/emqx/etc/plugins/emqx_auth_mnesia.conf

文件内容很简单：

## Password hash.
##
## Value: plain | md5 | sha | sha256 | sha512
auth.mnesia.password_hash = plain

##--------------------------------------------------------------------


ClientId Authentication


##--------------------------------------------------------------------


Examples


##auth.client.1.clientid = id
##auth.client.1.password = passwd


##--------------------------------------------------------------------


Username Authentication


##--------------------------------------------------------------------


Examples:


auth.user.1.username = test
auth.user.1.password = test
##auth.user.2.username = feng@emqtt.io
##auth.user.2.password = public

postgesql 数据库文件配置

由于对 docker 的 volume 机制不是很熟悉，即便指定了文件夹映射（./postgres_data:/var/lib/postgresql/data），新建了数据库之后，工作虽然一切正常，但是宿主文件夹内部没有任何东西，每次 docker-compose down 删除了容器后，数据消失的一干二净。最后按照文档的对数据存储的推荐方式，指定了PGDATA最后得以解决。

    volumes:
      - ./postgres_data:/var/lib/postgresql/data/pgdata
    environment:
      POSTGRES_PASSWORD: "123456"
      PGDATA: "/var/lib/postgresql/data/pgdata"

关于 docker volume 一些行为没太摸清楚，现在感觉是如果指定一个空文件夹映射，只有在容器内新生成的文件才能出现的宿主中，以后有机会在研究吧。

VNC 设置

一直比较习惯使用 xrdp，通过 windows 自带的远程桌面访问 linux，不过麒麟系统 dnf 里面并没有这个包。只能用 VNC 了。大体步骤和 [这篇文章](https://blog.csdn.net/qq_28903377/article/details/116565345 写的一样，只要给麒麟安装上 server 并配置启动就好了，我稍微简化了一下，因为 dnf 源里面自带了tigervnc-server，不需要手动下载了，直接

dnf install tigervnc-server

客户端只要安装 tigervnc-viewer 就可以了。

docker-compose

  • 按照 docker 官方的说法，执行 docker-compose up -d 的时候，会自动加载 docker-compose.yml 以及 docker-compose.override.yml 两个文件。如果使用 -f 参数指定其他名称的文件时，比如：docker-compose-linux.yml，请注意，docker 不会自动加载 docker-compose-linux.override.yml 文件。
  • docker-compose 对同一个网络内的服务设置了服务名称的主机名解析，因此需要在服务之间相互访问（常见于反向代理）时，不应该使用 IP，而应该使用服务名称替代。
  • docker-compose 内可以指定healthcheck进行服务的健康检查，如果对启动顺序要求比较高的话，建议加上，如何对.NET 6 程序进行健康检查，官方有一个文档，但是一些步骤不是很清楚，以后有机会单独写一篇。
  • 停止 docker-compose 运行的服务时，不要使用 docker-compose down，这个命令会删除所有的容器，容器产生的信息在没有正确使用 volumes 的情况下会丢失，建议使用 docker-compose stop 替代。
  • docker-compose.yml 中，需要谨慎设置 build 节中的 context 与 dockerfile，参考 Dockerfile 确定它的当前目录是什么设置 context。
  • 成功编译并且运行 docker-compose 后，可以删除.NET 项目源代码并删除 docker-compose.yml 中的 build 设置，只要不删除 image，容器依然可以正常启动。

总结

aarch64 上的国产银河麒麟 v10 系统，已经有很多软件可用了（redis、pg 等），可能还有一些软件无法适配（只支持 x64 平台的），但是对于.NET 程序来说，由于 runtime 已经完全支持 aarch64，绝大部分应用可以正常运行。

本文使用 docker-compose 在 linux 与 windows（windows desktop wsl2）上都测试.NET 6 通过。