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

问星刘映 發表於 2025-2-6 15:52:00

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

最近想在麒麟系统上运行.NET 6程序，经过一番折腾最终完成了，简单记录一下。
目标系统:
<ul>
<li>CPU: aarch64架构（ARM64)</li>
<li>操作系统：银河麒麟V10高级服务器系统</li>
</ul>
银河麒麟V10系统（以下简称麒麟）使用的是redhat类似的dnf包管理方式，但是无法安装<code>epel</code>，因此很多软件无法直接包安装。
<h2 id="方案">方案</h2>
<ol>
<li>直接在麒麟上安装dotnet，并运行dotnet程序 这种方式很直接，无奈dotnet不支持在ARM64架构下的包管理安装，只能使用<code>snap</code>、安装脚本或者手动进行安装。然后<code>snap</code>我在麒麟上发现也不好装，一直没有成功；安装脚本需要连接国外的服务器，我这联外网有点问题，死活是装不上；手动方式我觉得好麻烦，直接放弃吧。</li>

</ol>
<blockquote>
感兴趣的朋友可以参考这两篇文章：文章1、文章2

</blockquote>
<ol start="2">
<li>通过docker的形式执行dotnet程序 这种方式兼容性强，只要对应依赖的组件有aarch64版本的docker镜像就可以用，dotnet是有的，麒麟也支持docker。</li>

</ol>
于是乎选择的使用docker进行部署，由于还需要部署数据库，选择使用docker-compose是更好的选择。只需要在系统中执行
<pre class="highlighter-hljs"><code class="language-bash highlighter-hljs hljs">dnf install docker docker-compose
</code></pre>
系统即可安装好必要的docker组件。
<h2 id="要点记录">要点记录</h2>
有关如何将在Docker上运行.NET 6程序，很多文章已经有写，官网也有很详细的说明，我就不重复了写了。
<h3 id="net程序参数传递">.NET程序参数传递</h3>
传统上.NET程序一般使用<code>appsettings.json</code>进行参数的设置，在docker中，为了配置方便，更多使用环境变量进行参数的传递，默认.NET依赖注入的<code>IConfiguration</code>就可以直接读取环境变量，但是对于手动的情况，需要指定<code>AddEnvironmentVariables()</code>方法：
<pre class="highlighter-hljs"><code class="language-c# highlighter-hljs hljs language-c">var config = new ConfigurationBuilder()
.SetBasePath(Directory.GetCurrentDirectory())
.AddJsonFile("appsettings.json", optional: true)
.AddEnvironmentVariables()
.Build();
</code></pre>
如果需要设置如下参数：
<pre class="highlighter-hljs"><code class="language-json highlighter-hljs hljs">"IdentityConfig": {
"server.urls": "http://*:5000", // 服务地址
}
</code></pre>
那么在docker-compose设置中应当这么写：
<pre class="highlighter-hljs"><code class="language-yaml highlighter-hljs hljs">environment:
 # - ASPNETCORE_ENVIRONMENT=Docker
 - IdentityConfig__server.urls=http://*:5000 #
</code></pre>
冒号在yaml配置中应当替换为两个连续下划线“__”，dotnet读取配置的时候，依然可以使用<code>config</code>获得参数。
<h3 id="dockerfile设置">Dockerfile设置</h3>
选择docker这种方式的话，需要从源代码编译.NET应用，因此在执<code>行Dockerfile</code>的时候，会执行<code>dotnet restore</code>之类的命令，强烈建议换成国内的nuget源，国外的还是慢了点。
国内的有：
<ul>
<li>华为云：https://repo.huaweicloud.com/repository/nuget/v3/index.json</li>
<li>腾讯云：https://mirrors.cloud.tencent.com/nuget</li>
<li>中国区Azure：https://nuget.cdn.azure.cn/v3/index.json 请在dotnet restore build publish添加<code>--source https://nuget.cdn.azure.cn/v3/index.json</code>指定使用固定的源进行编译。</li>

</ul>
<h3 id="emq-x设备用户名与密码登录">EMQ X设备用户名与密码登录</h3>
最为非常流行的mqtt服务器，emqx也提供了docker的安装方式。这里需要说一下，现在很多mqtt设备只能支持固定的用户名和密码登录，因此启动docker的时候，需要通过文件指定（在EMQX 4.4上测试通过）。
<pre class="highlighter-hljs"><code class="language-yaml highlighter-hljs hljs">volumes:
 - ./emqx/emqx_auth_mnesia.conf:/opt/emqx/etc/plugins/emqx_auth_mnesia.conf
</code></pre>
文件内容很简单：
<pre class="highlighter-hljs"><code class="language-conf highlighter-hljs hljs">## 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
</code></pre>
<h3 id="postgesql数据库文件配置">postgesql数据库文件配置</h3>
由于对docker的volume机制不是很熟悉，即便指定了文件夹映射（<code>./postgres_data:/var/lib/postgresql/data</code>），新建了数据库之后，工作虽然一切正常，但是宿主文件夹内部没有任何东西，每次docker-compose down删除了容器后，数据消失的一干二净。最后按照文档的对数据存储的推荐方式，指定了<code>PGDATA</code>最后得以解决。
<pre class="highlighter-hljs"><code class="language-yaml highlighter-hljs hljs"> volumes:
 - ./postgres_data:/var/lib/postgresql/data/pgdata
environment:
 POSTGRES_PASSWORD: "123456"
 PGDATA: "/var/lib/postgresql/data/pgdata"
</code></pre>
关于docker volume一些行为没太摸清楚，现在感觉是如果指定一个空文件夹映射，只有在容器内新生成的文件才能出现的宿主中，以后有机会在研究吧。
<h3 id="vnc设置">VNC设置</h3>
一直比较习惯使用xrdp，通过windows自带的远程桌面访问linux，不过麒麟系统dnf里面并没有这个包。只能用VNC了。大体步骤和[这篇文章](https://blog.csdn.net/qq_28903377/article/details/116565345写的一样，只要给麒麟安装上server并配置启动就好了，我稍微简化了一下，因为dnf源里面自带了<code>tigervnc-server</code>，不需要手动下载了，直接
<pre class="highlighter-hljs"><code class="language-bash highlighter-hljs hljs">dnf install tigervnc-server
</code></pre>
客户端只要安装tigervnc-viewer就可以了。
<h3 id="docker-compose">docker-compose</h3>
<ul>
<li>按照docker官方的说法，执行docker-compose up -d的时候，会自动加载docker-compose.yml以及docker-compose.override.yml两个文件。如果使用-f参数指定其他名称的文件时，比如：docker-compose-linux.yml，请注意，docker不会自动加载docker-compose-linux.override.yml文件。</li>
<li>docker-compose对同一个网络内的服务设置了服务名称的主机名解析，因此需要在服务之间相互访问（常见于反向代理）时，不应该使用IP，而应该使用服务名称替代。</li>
<li>docker-compose内可以指定<code>healthcheck</code>进行服务的健康检查，如果对启动顺序要求比较高的话，建议加上，如何对.NET 6程序进行健康检查，官方有一个文档，但是一些步骤不是很清楚，以后有机会单独写一篇。</li>
<li>停止docker-compose运行的服务时，不要使用docker-compose down，这个命令会删除所有的容器，容器产生的信息在没有正确使用volumes的情况下会丢失，建议使用docker-compose stop替代。</li>
<li>docker-compose.yml中，需要谨慎设置build节中的context与dockerfile，参考Dockerfile确定它的当前目录是什么设置context。</li>
<li>成功编译并且运行docker-compose后，可以删除.NET项目源代码并删除docker-compose.yml中的build设置，只要不删除image，容器依然可以正常启动。</li>
</ul>
<h2 id="总结">总结</h2>
aarch64上的国产银河麒麟v10系统，已经有很多软件可用了（redis、pg等），可能还有一些软件无法适配（只支持x64平台的），但是对于.NET程序来说，由于runtime已经完全支持aarch64，绝大部分应用可以正常运行。
<blockquote>
本文使用docker-compose在linux与windows（windows desktop wsl2）上都测试.NET 6通过。
</blockquote> 
来源：https://www.cnblogs.com/lhxsoft/p/18701184

頁: [1]

琼殿技术论坛's Archiver

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