.NET 6應用程式適配國產銀河麒麟V10系統隨記

2022 年 8 月 19 日
筆記
linux, 個人筆記

最近想在麒麟系統上運行.NET 6程式，經過一番折騰最終完成了，簡單記錄一下。

目標系統:

CPU: aarch64架構（ARM64)
作業系統：銀河麒麟V10高級伺服器系統

銀河麒麟V10系統（以下簡稱麒麟）使用的是redhat類似的dnf包管理方式，但是無法安裝epel，因此很多軟體無法直接包安裝。

方案

直接在麒麟上安裝dotnet，並運行dotnet程式
這種方式很直接，無奈dotnet不支援在ARM64架構下的包管理安裝，只能使用snap、安裝腳本或者手動進行安裝。然後snap我在麒麟上發現也不好裝，一直沒有成功；安裝腳本需要連接國外的伺服器，我這聯外網有點問題，死活是裝不上；手動方式我覺得好麻煩，直接放棄吧。

感興趣的朋友可以參考這兩篇文章：文章1、文章2

通過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": "//*:5000", // 服務地址
}

那麼在docker-compose設置中應當這麼寫：

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

冒號在yaml配置中應當替換為兩個連續下劃線「__」，dotnet讀取配置的時候，依然可以使用config[IdentityConfig:server.urls]獲得參數。

Dockerfile設置

選擇docker這種方式的話，需要從源程式碼編譯.NET應用，因此在執行Dockerfile的時候，會執行dotnet restore之類的命令，強烈建議換成中國的nuget源，國外的還是慢了點。

中國的有：

華為云：//repo.huaweicloud.com/repository/nuget/v3/index.json
騰訊云：//mirrors.cloud.tencent.com/nuget
中國區Azure：//nuget.cdn.azure.cn/v3/index.json
請在dotnet restore build publish添加--source //nuget.cdn.azure.cn/v3/index.json指定使用固定的源進行編譯。

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 = [email protected]
##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了。大體步驟和[這篇文章](//blog.csdn.net/qq_28903377/article/details/116565345寫的一樣，只要給麒麟安裝上server並配置啟動就好了，我稍微簡化了一下，因為dnf源裡面自帶了tightvnc-server，不需要手動下載了，直接

dnf install tightvnc-server

客戶端只要安裝tightvnc-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通過。

Tags: linux 個人筆記