如何轻松让项目集成Dapr的一行代码实现？
- 内容介绍
- 文章标签
- 相关推荐
本文共计1692个文字，预计阅读时间需要7分钟。
介绍Dapr简化了云原生开发，让开发者可以把焦点放在应用的业务逻辑上，从而使代码更简单、可移植。作为.NET开发者，我们也希望项目可以快速用上Dapr。那么，究竟应该如何做呢？
介绍Dapr简化了云原生开发，让开发可以把焦点放在应用的业务逻辑上，从而让代码简单、可移植，那作为一个.Net开发者，我们也希望项目可以快速用上dapr，那究竟应该如何做呢？
Dapr提出了Sidecar(边车)的概念，在启动项目时再额外启动一个Sidecar, 通过Sidecar可以解决进程间通信，为此官方提供了两种部署方式：
- 自托管方式下运行Dapr
- 在 Kubernetes 模式中部署和运行 Dapr
其中Kubernetes模式部署是通过Kubernetes来完成的，在开发中我们更多的是通过自托管模式使用Dapr，那自托管模式是怎么做的呢？
使用命令行工具，在项目根目录输入：
dapr run --app-id assignment-server --app-port 5038 dotnet run
详细文档参考：手把手教你学Dapr - 3. 使用Dapr运行第一个.Net程序
参考以上详细文档操作后，我们就可以在命令行工具中执行dapr invoke --app-id assignment-server --method hello或者Http请求来调用对应的应用的方法
看似好像也不是很复杂，但如果你需要调试dotnet项目呢？再复杂一点的需要启动多个项目进行调试呢？端口一多起来的确会显得很麻烦。
有没有什么办法可以解决呢？有，docker-compose。
但我还不想用这么重的东西，我想像平时开发项目一样直接在windows上运行可不可以？
Masa.Utils.Development.Dapr.AspNetCore 它来了协助管理dapr进程，用于开发时减少对docker compose的依赖
瞌睡了就有人送枕头，一句话让我们了解到了它的作用，正好解决了我们需要通过命令行来启动dapr的问题，那下面我们看看这个怎么用：
入门本着绝对不多写一行代码的心态，我们准备出发了……
-
从大佬doddgu的博客的链接中发现一份源码地址，为防止后期文档调整，先fork一份到自己仓库
git clone github.com/zhenlei520/dapr-study-room.git -
使用命令行工具打开目录dapr-study-room\Assignment03，然后执行命令
dotnet add package Masa.Utils.Development.Dapr.AspNetCore --version 0.4.0-preview.3或使用Visual Studio打开解决方案Assignment03，选中Assignment.Server并安装Masa.Utils.Development.Dapr.AspNetCore
-
打开
Program.cs，并添加DaprStarter（注意看有注释的那一行）using Masa.Utils.Development.Dapr.AspNetCore; var builder = WebApplication.CreateBuilder(args); builder.Services.AddDaprStarter();//添加DaprStarter即可 var app = builder.Build(); app.Map("/hello", () => Console.WriteLine("Hello World!")); app.Run(); -
使用命令行工具执行命令验证dapr是否启动成功
dapr invoke --app-id Assignment-Server-00D861D0C0B7 --method hello
此时会有小伙伴问了，为什么app-id是Assignment-Server-00D861D0C0B7？
查看文档后发现Masa.Utils.Development.Dapr.AspNetCore的app-id生成规则为：AppId + AppIdDelimiter + AppIdSuffix，其中
- AppId默认：项目名.Replace(".","-")
- AppIdSuffix默认：网卡地址
由于我们的项目名为Assignment.Server，当前电脑的网卡地址是00D861D0C0B7，所以dapr最终的appid为Assignment-Server-00D861D0C0B7，到这里，Masa.Utils.Development.Dapr.AspNetCore的使用讲解已经完成了
进阶冷知识，为什么 . 要换成 - ？
因为Dapr的AppId采用FQDN：(Fully Qualified Domain Name)全限定域名：同时带有主机名和域名的名称。（通过符号“.”）
为什么要加网卡地址作为后缀？
因为目前自托管默认采用mDNS，会导致局域网内用户的AppId互相污染。你的同事和你一起在开发，都启动了A应用，你俩就自动负载了，那后果自然就是请求也到处跑了。
如果我希望自己指定AppId而不是使用默认的规则怎么办呢？目前支持三种写法:
- 根据规则（配置默认装配）
- 根据规则 + 代码指定（配置自定义装配）
- 根据配置文件（根据IConfiguration配置生成）
修改Program.cs文件
// 省略上述代码
builder.Services.AddDaprStarter();
根据规则 + 代码指定（配置自定义装配）
修改Program.cs文件
// 省略上述代码
builder.Services.AddDaprStarter(opt =>
{
opt.AppId = "masa-dapr-test";
opt.AppPort = 5001;
opt.AppIdSuffix = "";
opt.DaprHttpPort = 8080;
opt.DaprGrpcPort = 8081;
});
根据IConfiguration配置生成基于默认装配的升级版，在默认装配基础上通过指定特殊参数完成特殊需求，未配置的参数将使用默认值
- 修改
appsettings.json
{
"DaprOptions": {
"AppId": "masa-dapr-test",
"AppPort": 5001,
"AppIdSuffix": "",
"DaprHttpPort": 8080,
"DaprGrpcPort": 8081
}
}
- 修改
Program.cs
builder.Services.AddDaprStarter(builder.Configuration.GetSection("DaprOptions"));
Masa.Utils.Development.Dapr.AspNetCore的设计思路优势：更改appsettings.json配置后，dapr sidecar会自动更新，项目无需重启
设计思路基于两个方面，其一本机自动启动dapr sidecar还可以正常调试.Net项目，其二简化配置
技术选型我们有两种启动dapr sidecar的方式：
- dapr run
- daprd
两者之间的差别如下所示：
完整的对比可查看：docs.dapr.io/reference/arguments-annotations-overview/
通过对比我们发现，我们的目标使用daprd与Dapr CLI都可以实现，那为什么Masa.Utils.Development.Dapr选择的是Dapr CLI，而不是daprd呢？
核心的原因是dapr可以通过dapr list命令很简单的就获取到当前运行的所有dapr程序，而daprd无法获取。如果使用daprd，那我们就需要使用C#代码通过操作dll获取具体执行的dapr命令，且多平台支持不好，所以暂时用了Dapr CLI
更优秀的Dapr管理需要做到什么？- 使用简单
- 参数可配置
- 功能支持选择性启动
- Dapr保活
- 配置支持动态更新
为了能更方便的使用，我们做了以下约定：
- 针对dapr的非必填项，默认关闭不启用，手动配置参数后开启
- 针对dapr的必填项: app-id、app-port、dapr-github.com/zhenlei520/dapr-study-room
开源地址
MASA.BuildingBlocks：github.com/masastack/MASA.BuildingBlocks
MASA.Contrib：github.com/masastack/MASA.Contrib
MASA.Utils：github.com/masastack/MASA.Utils
MASA.EShop：github.com/masalabs/MASA.EShop
MASA.Blazor：github.com/BlazorComponent/MASA.Blazor
如果你对我们的 MASA Framework 感兴趣，无论是代码贡献、使用、提 Issue，
本文共计1692个文字，预计阅读时间需要7分钟。
介绍Dapr简化了云原生开发，让开发者可以把焦点放在应用的业务逻辑上，从而使代码更简单、可移植。作为.NET开发者，我们也希望项目可以快速用上Dapr。那么，究竟应该如何做呢？
介绍Dapr简化了云原生开发，让开发可以把焦点放在应用的业务逻辑上，从而让代码简单、可移植，那作为一个.Net开发者，我们也希望项目可以快速用上dapr，那究竟应该如何做呢？
Dapr提出了Sidecar(边车)的概念，在启动项目时再额外启动一个Sidecar, 通过Sidecar可以解决进程间通信，为此官方提供了两种部署方式：
- 自托管方式下运行Dapr
- 在 Kubernetes 模式中部署和运行 Dapr
其中Kubernetes模式部署是通过Kubernetes来完成的，在开发中我们更多的是通过自托管模式使用Dapr，那自托管模式是怎么做的呢？
使用命令行工具，在项目根目录输入：
dapr run --app-id assignment-server --app-port 5038 dotnet run
详细文档参考：手把手教你学Dapr - 3. 使用Dapr运行第一个.Net程序
参考以上详细文档操作后，我们就可以在命令行工具中执行dapr invoke --app-id assignment-server --method hello或者Http请求来调用对应的应用的方法
看似好像也不是很复杂，但如果你需要调试dotnet项目呢？再复杂一点的需要启动多个项目进行调试呢？端口一多起来的确会显得很麻烦。
有没有什么办法可以解决呢？有，docker-compose。
但我还不想用这么重的东西，我想像平时开发项目一样直接在windows上运行可不可以？
Masa.Utils.Development.Dapr.AspNetCore 它来了协助管理dapr进程，用于开发时减少对docker compose的依赖
瞌睡了就有人送枕头，一句话让我们了解到了它的作用，正好解决了我们需要通过命令行来启动dapr的问题，那下面我们看看这个怎么用：
入门本着绝对不多写一行代码的心态，我们准备出发了……
-
从大佬doddgu的博客的链接中发现一份源码地址，为防止后期文档调整，先fork一份到自己仓库
git clone github.com/zhenlei520/dapr-study-room.git -
使用命令行工具打开目录dapr-study-room\Assignment03，然后执行命令
dotnet add package Masa.Utils.Development.Dapr.AspNetCore --version 0.4.0-preview.3或使用Visual Studio打开解决方案Assignment03，选中Assignment.Server并安装Masa.Utils.Development.Dapr.AspNetCore
-
打开
Program.cs，并添加DaprStarter（注意看有注释的那一行）using Masa.Utils.Development.Dapr.AspNetCore; var builder = WebApplication.CreateBuilder(args); builder.Services.AddDaprStarter();//添加DaprStarter即可 var app = builder.Build(); app.Map("/hello", () => Console.WriteLine("Hello World!")); app.Run(); -
使用命令行工具执行命令验证dapr是否启动成功
dapr invoke --app-id Assignment-Server-00D861D0C0B7 --method hello
此时会有小伙伴问了，为什么app-id是Assignment-Server-00D861D0C0B7？
查看文档后发现Masa.Utils.Development.Dapr.AspNetCore的app-id生成规则为：AppId + AppIdDelimiter + AppIdSuffix，其中
- AppId默认：项目名.Replace(".","-")
- AppIdSuffix默认：网卡地址
由于我们的项目名为Assignment.Server，当前电脑的网卡地址是00D861D0C0B7，所以dapr最终的appid为Assignment-Server-00D861D0C0B7，到这里，Masa.Utils.Development.Dapr.AspNetCore的使用讲解已经完成了
进阶冷知识，为什么 . 要换成 - ？
因为Dapr的AppId采用FQDN：(Fully Qualified Domain Name)全限定域名：同时带有主机名和域名的名称。（通过符号“.”）
为什么要加网卡地址作为后缀？
因为目前自托管默认采用mDNS，会导致局域网内用户的AppId互相污染。你的同事和你一起在开发，都启动了A应用，你俩就自动负载了，那后果自然就是请求也到处跑了。
如果我希望自己指定AppId而不是使用默认的规则怎么办呢？目前支持三种写法:
- 根据规则（配置默认装配）
- 根据规则 + 代码指定（配置自定义装配）
- 根据配置文件（根据IConfiguration配置生成）
修改Program.cs文件
// 省略上述代码
builder.Services.AddDaprStarter();
根据规则 + 代码指定（配置自定义装配）
修改Program.cs文件
// 省略上述代码
builder.Services.AddDaprStarter(opt =>
{
opt.AppId = "masa-dapr-test";
opt.AppPort = 5001;
opt.AppIdSuffix = "";
opt.DaprHttpPort = 8080;
opt.DaprGrpcPort = 8081;
});
根据IConfiguration配置生成基于默认装配的升级版，在默认装配基础上通过指定特殊参数完成特殊需求，未配置的参数将使用默认值
- 修改
appsettings.json
{
"DaprOptions": {
"AppId": "masa-dapr-test",
"AppPort": 5001,
"AppIdSuffix": "",
"DaprHttpPort": 8080,
"DaprGrpcPort": 8081
}
}
- 修改
Program.cs
builder.Services.AddDaprStarter(builder.Configuration.GetSection("DaprOptions"));
Masa.Utils.Development.Dapr.AspNetCore的设计思路优势：更改appsettings.json配置后，dapr sidecar会自动更新，项目无需重启
设计思路基于两个方面，其一本机自动启动dapr sidecar还可以正常调试.Net项目，其二简化配置
技术选型我们有两种启动dapr sidecar的方式：
- dapr run
- daprd
两者之间的差别如下所示：
完整的对比可查看：docs.dapr.io/reference/arguments-annotations-overview/
通过对比我们发现，我们的目标使用daprd与Dapr CLI都可以实现，那为什么Masa.Utils.Development.Dapr选择的是Dapr CLI，而不是daprd呢？
核心的原因是dapr可以通过dapr list命令很简单的就获取到当前运行的所有dapr程序，而daprd无法获取。如果使用daprd，那我们就需要使用C#代码通过操作dll获取具体执行的dapr命令，且多平台支持不好，所以暂时用了Dapr CLI
更优秀的Dapr管理需要做到什么？- 使用简单
- 参数可配置
- 功能支持选择性启动
- Dapr保活
- 配置支持动态更新
为了能更方便的使用，我们做了以下约定：
- 针对dapr的非必填项，默认关闭不启用，手动配置参数后开启
- 针对dapr的必填项: app-id、app-port、dapr-github.com/zhenlei520/dapr-study-room
开源地址
MASA.BuildingBlocks：github.com/masastack/MASA.BuildingBlocks
MASA.Contrib：github.com/masastack/MASA.Contrib
MASA.Utils：github.com/masastack/MASA.Utils
MASA.EShop：github.com/masalabs/MASA.EShop
MASA.Blazor：github.com/BlazorComponent/MASA.Blazor
如果你对我们的 MASA Framework 感兴趣，无论是代码贡献、使用、提 Issue，