Adnc如何本地调试 - 一个轻量级的.Net6微服务/分布式开发框架

前言

Adnc是一个完全可以落地的微服务/分布式框架，集成了一系列主流稳定的微服务配套组件。如果只是在本地调试，只需要安装必备软件，必备软件除开发工具外，建议大家都使用Docker安装；同样也可以采取自己熟悉的任何方式安装或者使用已经安装好的。服务自动注册/发现/配置中心，因为在代码中做了环境变量判断，调试环境不会启用。

必备软件有哪些

1. Visual Studio 2022

Adnc基于.Net6开发，所以需要安装Visual Studio 2022。

2. Redis

安装Redis

#新建/data/redis目录
mkdir -p /data/redis
#进入redis目录
cd /data/redis
#下载已经配置好的redis.conf到当前目录，如果不能下载成功，请手工处理
wget https://gitee.com/alpha2007/Adnc/raw/master/doc/redis/redis.conf
#`redis.conf` 部分节点说明
#--------------------------------------------------------
#`bind 127.0.0.1` 注释掉这部分，这是限制redis只能本地访问<br/>
#`protected-mode no` 默认yes，开启保护模式，限制为本地访问<br/>
#`daemonize no` 默认no，改为yes意为以守护进程方式启动，可后台运行，除非kill进程（可选），改为yes会使配置文件方式启动redis失败,请设置成no.<br/>
#`dir  ./` 输入本地redis数据库存放文件夹（可选）<br/>
#`appendonly yes` redis持久化（可选）<br/>
#`loadmodule /usr/lib/redis/modules/redisbloom.so` 挂载布隆过滤器模块
#--------------------------------------------------------
#拉取包含布隆过滤器的redis镜像文件
docker pull redislabs/rebloom:2.2.5
#启动redis容器，监听13379端口，并挂载redis.conf与data目录
docker run -p 13379:6379 --restart=always --name redis -v /data/redis/redis.conf:/etc/redis/redis.conf -v /data/redis/data:/data -d redislabs/rebloom:2.2.5 redis-server /etc/redis/redis.conf

修改以下3个服务appsettings.development.json文件的redis节点信息。

Adnc.Usr.WebApi、Adnc.Cus.WebApi、Adnc.Maint.WebApi
如果你是windows系统下安装的redis或者在linux系统下安装但没有挂载redisbloom.so模块，需要将EnableBloomFilter设置为false。

  "Redis": {
    "EnableBloomFilter": true,
    "Dbconfig": {
      "ConnectionString": "服务器IP:13379,password=football,defaultDatabase=1,ssl=false,sslHost=null,connectTimeout=4000,allowAdmin=true"
    }
  },

3. RabbitMQ

安装RabbitMQ

#拉取rabbitmq镜像
docker pull rabbitmq:3.8.9-management
#启动容器，监听18578,13572端口
#新手特别要注意RabitMq有两个端口,13572=数据端口，18578=web管理页端口。
docker run --restart=always --name=rabbitmq -p 18578:15672 -p 13572:5672 -e RABBITMQ_DEFAULT_USER=admin -e RABBITMQ_DEFAULT_PASS=football -d rabbitmq:3.8.9-management
#如果安装成功，我们访问`http://服务器IP:18578`,会出现登录页面

修改Adnc.Shared.WebApi/appsettings.shared.Development文件的RabbitMq节点信息。

  "RabbitMq": {
    "HostName": "服务器Ip",
    "VirtualHost": "/",
    "Port": "13572",
    "UserName": "admin",
    "Password": "football"
  }

4. MongoDB

安装MongoDB

#拉取mongo镜像
docker pull mongo:4.4.3
docker run --restart=always --name mongo -p 13017:27017 -e MONGO_INITDB_ROOT_USERNAME=admin -e MONGO_INITDB_ROOT_PASSWORD=football -e TZ=Asia/Shanghai -v /data/mongo:/data/db -v /data/mongo/backup:/data/backup -d mongo:4.4.3 --auth
#进入mongo容器
docker exec -it mongo mongo admin
use admin
db.auth("admin","football")
# 新建logs_dev数据库
use logs_dev
# 创建一个空的test集合，logs_dev如果没有任何集合,Adnc的健康监测不能通过。
db.createCollection("test")
# 创建用户
db.createUser({user:'alpha',pwd:'football',roles:[{role:'readWrite',db:'logs_dev'}]})

修改Adnc.Shared.WebApi/appsettings.shared.Development文件的MongoDb节点信息。

  "MongoDb": {
    "ConnectionString": "mongodb://用户名:密码@服务器Ip:13017/logs_dev?authSource=logs_dev",
    "CollectionNamingConvention": 2,
    "PluralizeCollectionNames": true
  }

5. Mariadb/Mysql

安装Mariadb/Mysql

#拉取mariadb镜像
docker pull mariadb:10.5.8
#启动容器，监听13308端口，并挂载data与logs目录
docker run --restart=always --name mariadb -p 13308:3306 -e MYSQL_ROOT_PASSWORD=alpha.netcore -e TZ=Asia/Shanghai -v /data/mariadb/logs:/var/log/mysql -v /data/mariadb/data:/var/lib/mysql -d mariadb:10.5.8

# 创建数据库并导入数据
cd /data
#下载脚本
wget https://gitee.com/alpha2007/Adnc/raw/master/doc/adnc_usr_dev.sql
wget https://gitee.com/alpha2007/Adnc/raw/master/doc/adnc_maint_dev.sql
wget https://gitee.com/alpha2007/Adnc/raw/master/doc/adnc_cus_dev.sql
#如果wget下载失败,请手动下载并上传到/root/data目录,文件地址如下
#https://github.com/AlphaYu/Adnc/tree/master/doc
# 拷贝脚本文件到mariadb容器
docker cp /data/adnc_usr_dev.sql mariadb:/usr/adnc_usr_dev.sql
docker cp /data/adnc_maint_dev.sql mariadb:/usr/adnc_maint_dev.sql
docker cp /data/adnc_cus_dev.sql mariadb:/usr/adnc_cus_dev.sql
# 进入容器
docker exec -it mariadb /bin/bash
# 启动mariadb client
mysql -uroot -palpha.netcore

#创建数据库 adnc_usr_dev
CREATE DATABASE IF NOT EXISTS adnc_usr_dev CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
#导入数据
use adnc_usr_dev;
source /usr/adnc_usr_dev.sql;

#创建数据库 adnc_maint_dev
CREATE DATABASE IF NOT EXISTS adnc_maint_dev CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
#导入数据
use adnc_maint_dev;
source /usr/adnc_maint_dev.sql;

#创建数据库 adnc_cus_dev
CREATE DATABASE IF NOT EXISTS adnc_cus_dev CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
use adnc_cus_dev;
source /usr/adnc_cus_dev.sql;

修改以下3个服务appsettings.development.json文件的Mysql节点信息。

Adnc.Usr.WebApi、Adnc.Cus.WebApi、Adnc.Maint.WebApi

  "Mysql": {
    "ConnectionString": "Server=服务器ip;Port=13308;database=库名;uid=账号;pwd=密码;"
  }

必备软件安装完成，下面介绍如何启动。

启动服务端ServerApi

右键解决方案，选择多个项目启动，并点击确定

需要启动以下4个项目Adnc.Gateway.Ocelot、Adnc.Usr.WebApi、Adnc.Maint.WebApi、Adnc.Cus.WebApi。实际开发过程中并不需要这样，这样介绍主要是为了快速在本地跑起来。

回到Visual Studio 2022 主界面，点击启动，这样后端Api与网关就启动了。

工程名	描述	URL地址
Adnc.Gateway.Ocelot	网关	http://localhost:5002
Adnc.Usr.WebApi	用户中心	http://localhost:50010 http://localhost:5002/usr/index.html
Adnc.Maint.WebApi	运维中心	http://localhost:50020 http://localhost:5002/maint/index.html
Adnc.Cus.WebApi	客户中心	http://localhost:50030 http://localhost:5002/cus/index.html

启动前端ClientApp

使用Visual Code 打开前端项目ClientApp，前端使用Vue开发，需要安装很多依赖包

#安装依赖包
npm install --registry=https://registry.npm.taobao.org
#启动前端，地址：localhost:5001,这里请耐心等待，成功后会自动打开浏览器
npm run dev

启动成功后，默认页面是登录页面
账号：alpha2008
密码：alpha2008

WELL DONE，记得star && fork。

全文完

posted @ 2020-12-04 19:57 风口旁的猪阅读(1833) 评论(0) 编辑收藏举报

会员力量，点亮园子希望

刷新页面返回顶部

风口旁的猪

代码改变世界，开源推动社区