前言

//program.cs
if (env.IsProduction() || env.IsStaging())
{
   var configuration = cb.Build();
   //從consul配置中心讀取配置
   var consulOption = configuration.GetSection("Consul").Get<ConsulConfig>();
   cb.AddConsul(new[] { consulOption.ConsulUrl }, consulOption.ConsulKeyPath);
}

//startup.cs
if (env.IsProduction() || env.IsStaging())
{
   //啟動後自動註冊服務到consul
   app.RegisterToConsul(_srvRegistration.GetConsulConfig());
}
 

//ServiceRegistrationHelper.cs
//獲取使用者認證、鑑權服務
var authServerAddress = (_env.IsProduction() || _env.IsStaging()) ? "adnc.usr.webapi" : "http://localhost:5010";
base.AddRpcService<IAuthRpcService>(authServerAddress, policies);

演示

• http://adnc.aspdotnetcore.net

GitHub

• https://github.com/alphayu/adnc

必備軟體有哪些

1. Visual Studio 2019

Adnc基於.Net Core 3.1開發，並且用了部分C# 8.0語法，所以需要安裝visual studio 2019。

2. Redis

#新建/data/redis目錄
cd /
mkdir data
cd data
mkdir redis
#進入redis目錄
cd reids
#拉取redis映象檔案
docker pull redis
#從官網下載redis.conf，並修改配置
wget http://download.redis.io/redis-stable/redis.conf 

• 修改上面下載的配置檔案redis.conf

bind 127.0.0.1 #註釋掉這部分，這是限制redis只能本地訪問

protected-mode no #預設yes，開啟保護模式，限制為本地訪問

daemonize no#預設no，改為yes意為以守護程序方式啟動，可後臺執行，除非kill程序（可選），改為yes會使配置檔案方式啟動redis失敗,請設定成no.

dir ./ #輸入本地redis資料庫存放資料夾（可選）

appendonly yes #redis持久化（可選）

#啟動redis容器，監聽13379埠，並掛載redis.conf與data目錄
docker run -p 13379:13379 --name redis -v /root/data/redis/redis.conf:/etc/redis/redis.conf -v /root/data/redis/data:/data -d redis redis-server /etc/redis/redis.conf

• 修改Adnc.Usr.WebApi、Adnc.Cus.WebApi、Adnc.Maint.WebApi 3個微服務appsettings.development.json檔案的redis節點資訊

  "Redis": {
    "MaxRdSecond": 120,
    "EnableLogging": false,
    "LockMs": 5000,
    "SleepMs": 300,
    "dbconfig": {
      "ConnectionStrings": [
        "你的redis地址:13379,password=你的密碼,poolsize=50,defaultDatabase=1,prefix="
      ],
      "ReadOnly": false
    }
  }

3. rabbitmq

#拉取rabbitmq映象
docker pull rabbitmq:management
#啟動容器，監聽18578，13572埠
docker run --name=rabbitmq -p 18578:15672 -p 13572:5672 -e RABBITMQ_DEFAULT_USER=admin -e RABBITMQ_DEFAULT_PASS=你的密碼 -d rabbitmq:management

如果安裝成功，我們訪問http://伺服器IP:18578,會出現登入頁面。

• 修改Adnc.Usr.WebApi、Adnc.Cus.WebApi、Adnc.Maint.WebApi 3個微服務appsettings.development.json檔案的RabbitMq節點資訊

  "RabbitMq": {
    "HostName": "伺服器Ip",
    "VirtualHost": "虛擬主機",
    "Port": "13572",
    "UserName": "使用者名稱",
    "Password": "密碼"
  }

4. mongodb

#拉取mongodb映象
docker pull mongo
#啟動容器，監聽13017埠並掛載data與backup目錄
docker run --name mongo -p 13017:27017 -v /root/data/mongo:/data/db -v /root/data/mongo/backup:/data/backup -d mongo --auth

• 修改Adnc.Usr.WebApi、Adnc.Cus.WebApi、Adnc.Maint.WebApi 3個微服務appsettings.development.json檔案的MongoDb節點資訊

  "MongoDb": {
    "ConnectionStrings": "mongodb://使用者名稱:密碼@伺服器Ip:13017/Logs",
    "CollectionNamingConvention": 2,
    "PluralizeCollectionNames": true
  }

• 修改nlog.config monogdb配置部分

5. mysql

#拉取mysql映象
docker pull mariadb
#啟動容器，監聽13308埠，並掛載data與logs目錄
docker run --name mariadb -p 13308:3306 -e MYSQL_ROOT_PASSWORD=你的root密碼 --restart=always -v /root/data/mariadb/conf:/etc/mysql -v /root/data/mariadb/logs:/var/log/mysql -v /root/data/mariadb/data:/var/lib/mysql -d mariadb

• 修改Adnc.Usr.WebApi、Adnc.Cus.WebApi、Adnc.Maint.WebApi 3個微服務appsettings.development.json檔案的mysql節點資訊

  "Mysql": {
    "WriteDbConnectionString": "Server=伺服器ip;Port=13308;database=庫名;uid=賬號;pwd=密碼;"
  }

• 3個微服務的sql指令碼在doc目錄中，請自行匯入

必備軟體安裝完成，下面介紹如何啟動。

啟動服務端ServerApi

• 修改Adnc.Usr.WebApi、Adnc.Cus.WebApi、Adnc.Maint.WebApi、Adnc.Infr.Gateway 4個微服務的launchSettings.json檔案
  註釋如下程式碼，這是啟動掛載SkyAPM的配置，因為你沒有安裝skywalking環境，註釋就可以了。

//註釋下面程式碼
"SKYWALKING__SERVICENAME": "adnc.usr.webapi.dev",
"ASPNETCORE_HOSTINGSTARTUPASSEMBLIES": "SkyAPM.Agent.AspNetCore"

• 右鍵解決方案，選擇多個專案啟動，並點選確定

需要啟動4個專案：Adnc.Infr.Gateway、Adnc.Cus.WebApi、Adnc.Maint.WebApi、Adnc.Usr.WebApi。

實際開發過程中並不需要這樣，這樣介紹主要是為了快速在本地跑起來。

• 回到Visual Studio 2019 主介面，點選啟動，這樣後臺介面與閘道器就啟動了。

啟動前端ClientApp

• 使用visual code 開啟前端專案ClientApp

前端使用Vue開發，需要安裝很多依賴包

#安裝依賴包
npm install --registry=https://registry.npm.taobao.org
#啟動前端頁面,地址：localhost:5001,這裡請耐心等待，成功後會自動開啟瀏覽器
npm run dev

• 啟動成功後，預設頁面是登入頁面，登入賬號：alpha2008密碼：alpha2008

問題交流

• 企 鵝 群：780634162
• 博    客：https://www.cnblogs.com/alphayu
• 專案網址：https://aspdotnetcore.net

License

MIT
Free Software, Hell Yeah!