前言

    Adnc是一个轻量级的.Net Core微服务开发框架,同样适用于单体架构系统的开发。

    如果只是想本地调试,只需要安装必备软件,必备软件除开发工具外,其它软件建议大家都使用`docker`安装。如何安装`docker`,官方网站上有各种环境下的 安装指南

    微服务最核心的服务自动注册/发现/配置,`adnc`使用`consul`实现,因为在代码中做了限制,调试环境不会启动。当然如果你已经安装好了`cosnul`环境,也可以自己开启,请修改如下3个文件。建议先不要开启`cosnul`相关功能,先快速跑起来,`consul`如何配置,请参考 如何用docker consul部署到服务器
//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);

演示

GitHub

必备软件有哪些

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.WebApiAdnc.Cus.WebApiAdnc.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.WebApiAdnc.Cus.WebApiAdnc.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.WebApiAdnc.Cus.WebApiAdnc.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.WebApiAdnc.Cus.WebApiAdnc.Maint.WebApi 3个微服务appsettings.development.json文件的mysql节点信息
  "Mysql": {
"WriteDbConnectionString": "Server=服务器ip;Port=13308;database=库名;uid=账号;pwd=密码;"
}
  • 3个微服务的sql脚本在doc目录中,请自行导入

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

启动服务端ServerApi

  • 修改Adnc.Usr.WebApiAdnc.Cus.WebApiAdnc.Maint.WebApiAdnc.Infr.Gateway 4个微服务的launchSettings.json文件

    注释如下代码,这是启动挂载SkyAPM的配置,因为你没有安装skywalking环境,注释就可以了。
//注释下面代码
"SKYWALKING__SERVICENAME": "adnc.usr.webapi.dev",
"ASPNETCORE_HOSTINGSTARTUPASSEMBLIES": "SkyAPM.Agent.AspNetCore"
  • 右键解决方案,选择多个项目启动,并点击确定

需要启动4个项目:Adnc.Infr.GatewayAdnc.Cus.WebApiAdnc.Maint.WebApiAdnc.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

问题交流

License

MIT

Free Software, Hell Yeah!

Adnc如何本地调试 - 一个轻量级的.Net Core微服务开发框架的更多相关文章

  1. 一个轻量级的.Net Core微服务快速开发的轮子

    前言     Adnc是一个轻量级的.Net Core微服务快速开发框架,同时也可以应用于单体架构系统的开发.框架基于JWT认证授权.集成了一系列微服务配套组件,代码简洁.易上手.学习成本低.开箱即用 ...

  2. 分享一个集成.NET Core+Swagger+Consul+Polly+Ocelot+IdentityServer4+Exceptionless+Apollo+SkyWalking的微服务开发框架

    集成.NET Core+Swagger+Consul+Polly+Ocelot+IdentityServer4+Exceptionless+Apollo的微服务开发框架 Github源代码地址 htt ...

  3. spring-boot+spring-cloud+maven-module 一个 maven多模块的微服务架构模版

    spring-boot-cloud-module spring-boot+spring-cloud+maven-module 一个 maven多模块的微服务架构模版. 新手上路的绝佳模版,只有必要的配 ...

  4. 今天介绍一下自己的开源项目,一款以spring cloud alibaba为核心的微服务架构项目,为给企业与个人提供一个零开发基础的微服务架构。

    LaoCat-Spring-Cloud-Scaffold 一款以spring cloud alibab 为核心的微服务框架,主要目标为了提升自己的相关技术,也为了给企业与个人提供一个零开发基础的微服务 ...

  5. .NET Core微服务之路:让我们对上一个Demo通讯进行修改,完成RPC通讯

    最近一段时间有些事情耽搁了更新,抱歉各位了. 上一篇我们简单的介绍了DotNetty通信框架,并简单的介绍了基于DotNetty实现了回路(Echo)通信过程. 我们来回忆一下上一个项目的整个流程: ...

  6. .NET Core微服务之路:利用DotNetty实现一个简单的通信过程

    上一篇我们已经全面的介绍过<基于gRPC服务发现与服务治理的方案>,我们先复习一下RPC的调用过程(笔者会在这一节的几篇文章中反复的强调这个过程调用方案),看下图

  7. kubernetes实战篇之部署一个.net core微服务项目

    目录 继上一篇kubernetes理论知识完结.本篇主要讲解基于nexus搭建一个docker镜像仓库(当然大家实践过程是不必完全跟着做,也可以搭建harbor仓库或者直接把镜像推送到docker h ...

  8. 推荐一个超牛的SpringCloud微服务项目,开发脚手架

    前言 Cloud-Platform是国内首个基于Spring Cloud微服务化开发平台,具有统一授权.认证后台管理系统,其中包含具备用户管理.资源权限管理.网关API 管理等多个模块,支持多业务系统 ...

  9. 唱吧DevOps的落地,微服务CI/CD的范本技术解读----最大的难点并不是实际业务代码的编写,而是服务的监控和调试以及容器的编排

    1.业务架构:从单体式到微服务 K歌亭是唱吧的一条新业务线,旨在提供线下便捷的快餐式K歌方式,用户可以在一个电话亭大小的空间里完成K歌体验.K歌亭在客户端有VOD.微信和Web共三个交互入口,业务复杂 ...

随机推荐

  1. PyQt(Python+Qt)学习随笔:QTabWidget选项卡部件的currentWidget和widget方法

    老猿Python博文目录 专栏:使用PyQt开发图形界面Python应用 老猿Python博客地址 QTabWidget的每个选项卡都有一个对应的页面部件对象,可用通过currentWidget方法和 ...

  2. PyQt(Python+Qt)学习随笔:QAbstractItemView的dragEnabled属性的困惑

    老猿Python博文目录 老猿Python博客地址 dragEnabled属性用于控制视图是否支持拖拽,可以通过dragEnabled().setDragEnabled(bool enable)进行属 ...

  3. 10分钟快速入门vue.js

    Vue.js是一个轻巧.高性能.可组件化的MVVM库,一套用于构建用户界面的渐进式框架,上手简单,兼容强大. 官方文档:https://cn.vuejs.org/v2/guide/ 下面我们就直接来使 ...

  4. 自定义Django认证系统的技术方案

    Django已经提供了开箱即用的认证系统,但是可能并不满足我们的个性化需求.自定义认证系统需要知道哪些地方可以扩展,哪些地方可以替换.本文就来介绍自定义Django认证系统的相关技术细节. 自定义认证 ...

  5. 6个JS特效教程,学完即精通

    6个JS特效教程,学完即精通 JavaScript特效教程,学完你就能写任何特效.本课程将JavaScript.BOM.DOM.jQuery和Ajax课程中的各种网页特效提取出了再进行汇总.内容涵盖了 ...

  6. Day11 python高级特性-- 迭代器 Iterator

    直接可以作用于for循环的数据类型有以下几种:   •  集合数据类型:        list.tuple.dict.set.str   •  Generator:        生成器 和 带 y ...

  7. 1.pipeline原理

    redis基本语法:https://www.cnblogs.com/xiaonq/p/7919111.html redis四篇:https://www.cnblogs.com/xiaonq/categ ...

  8. 深入解析 C# 的 String.Create 的方法

    作者:Casey McQuillan 译者:精致码农 原文:http://dwz.win/YVW 说明:原文比较长,翻译时精简了很多内容,对于不重要的细枝末节只用了一句话概括,但不并影响阅读. 你还记 ...

  9. Android 7.0应用之间共享文件

    原文首发于微信公众号:躬行之,欢迎关注交流! 开发中经常需要将某个文件向另一个应用程序传递,如图片上传到另一个应用程序.文件在不同存储路径之间的复制粘贴等都需要共享文件,可以这样理解接收文件的应用是在 ...

  10. http详解笔记

    http详解笔记 http,(HyperText Transfer Protocol),超文本传输协议,亦成为超文本转移协议   通常使用的网络是在TCP/IP协议族的基础上运作的,HTTP属于它的一 ...