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

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

目標系統:

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

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

方案

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

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

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": "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源，國外的還是慢了點，

國內的有：

• 華為云：https://repo.huaweicloud.com/repository/nuget/v3/index.json
• 騰訊云：https://mirrors.cloud.tencent.com/nuget
• 中國區Azure：https://nuget.cdn.azure.cn/v3/index.json
  請在dotnet restore build publish添加--source https://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了，大體步驟和[這篇文章](https://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通過，

標籤：其他

上一篇：龍珠:超宇宙 for Mac(格斗類角色扮演游戲)

下一篇：設定centos系統的命令提示符為綠色