Dapr是Distributed Application Runtime(分布式应用运行时)的缩写。它是一个可移植的、事件驱动的运行时。
下面介绍如何在Windows平台安装Dapr:
安装Dapr CLI
Dapr CLI是使用Dapr相关功能的主要工具,您可以使用它来以Dapr Sidecar的方式启动应用程序,以及查看Sidecar日志,列出正在运行的服务以及运行Dapr仪表板。
在Powershell中运行以下命令可以将最新的Dapr cli安装到C:\dapr目录下,并将此目录添加到User PATH环境变量:
powershell -Command "iwr -useb https://raw.githubusercontent.com/dapr/cli/master/install/install.ps1 | iex"
注:国内执行这条命令可能会因为网络问题无法访问raw.githubusercontent.com导致安装失败,可以直接使用浏览器代理下载此powershell文件到xx目录,然后使用以下命令安装(xx为本地ps1文件所在目录):
powershell -Command "iwr -useb C:\xx\dapr.ps1 | iex"
首次执行此命令时可能会提示需要更改执行策略来加载不信任的脚本:
Set-ExecutionPolicy RemoteSigned -scope CurrentUser
拷贝这条命令执行,并选择[Y]确认执行更改。执行策略更改后再次运行上面的powershell命令,完成安装。
安装成功后可以运行dapr命令查看是否安装成功。
初始化Dapr
安装好Dapr CLI后现在可以通过Dapr CLI初始化Dapr。初始化Dapr将会获取Dapr Sidecar二进制文件并安装到本地。
此外,默认的初始化过程还会创建一个开发环境,来帮助简化Dapr的应用开发。这将包含以下步骤:
启动一个Redis容器实例来作为本地状态存储和消息代理;
启动一个Zipkin容器实例(一个分布式追踪系统)
创建一个上述组件的默认文件夹
启动一个Dapr placement service容器实例以获取本地Actor支持
在拥有管理员权限的命令行(实测不用管理员权限也可以)中执行:
dapr init
注:如果你当前没有安装并启动Docker for Windows是无法继续初始化的,启动Docker后再次执行init命令:
以上说明Dapr已经初始化成功,我们可以执行dapr --version查看当前版本情况:
执行成功后我们可以查看当前docker容器的启动情况:
可以看到分别启动了三个容器:dapr、redis、zipkin
如上述步骤所述,除了启动这三个容器外还会生成一个文件夹来存放一系列YMAL文件,用来定义状态存储、订阅 以及 zipkin。这些文件将会被Dapr Sidecar读取,告诉Sidecar使用Redis容器来进行状态管理和消息传递,并使用Zipkin容器来追踪信息。Windows环境下此文件夹目录为:%USERPROFILE%.dapr\
使用Dapr API
完成Dapr初始化工作后就可以通过运行sidecar然后可以直接调用Dapr API
第一步:运行Dapr Sidecar
运行以下命令以启动Dapr Sidecar,它将在端口5000上侦听名为DaprDemoApp的空应用程序:
dapr run --app-id DaprDemoApp --dapr-http-port 5000
第二步:测试保存状态
使用curl命令来向http://localhost:5000/v1.0/state/statestore地址post一个json数据:
curl -X POST -H "Content-Type: application/json" -d '[{ "key": "name", "value": "Edward"}]' http://localhost:5000/v1.0/state/statestore
使用以下命令来查看刚才提交的数据:
curl http://localhost:3500/v1.0/state/statestore/name
这些状态值都存储在redis容器里,我们可以进入redis容器查看刚才提交的内容:
或直接使用RDM查看写入情况:
定义组件
刚才的例子中我们通过Dapr API将数据保存到redis中。Dapr知道使用Redis是因为初始化Dapr时我们使用了默认的组件定义文件。当创建一个应用时,我们大概率会根据实际需求(所需组件)来创建自己的组件定义文件,下面的例子演示如何使用JSON文件作为密钥管理的组件存储密钥。
第一步:创建一个JSON文件来存储密钥:
Dapr支持许多密钥存储,此处使用最简单的JSON文件来保存我们的密钥(注意,此密钥存储仅用于开发目的,不建议生产环境使用)。
C:/Edward/mysecrets.json:
{"my-secret" : "I'm Batman"
}
第二步:创建一个Dapr密钥存储组件
首先创建一个新的目录(my-components)来存放组件文件localSecretStore.yaml:
apiVersion: dapr.io/v1alpha1kind: Componentmetadata:name: my-secret-storenamespace: defaultspec:type: secretstores.local.fileversion: v1metadata:\- name: secretsFilevalue: C:/Edward/mysecrets.json\- name: nestedSeparatorvalue: ":"
第三步:运行Dapr sidecar同时指定新创建的组件文件:localSecretStore.yaml:
dapr run --app-id DaprDemoApp --dapr-http-port 5000 --components-path C:\Edward\my-components
第四步:测试从本地JSON文件中获取密钥:
curl http://localhost:5000/v1.0/secrets/my-secret-store/my-secret
以上就是Windows平台安装Dapr的简易入门教程,后续我会继续测试.NET 5应用如何使用Dapr提供的相关功能。
作者:Endward
出处:https://www.cnblogs.com/yrz1994
相关文章:
Dapr能否引领云原生中间件的未来?
云原生 | 阿里巴巴的Dapr实践与探索
Dapr 可视化指南
Dapr 知多少 | 分布式应用运行时
Dapr 正式发布 1.0
Dapr 交通流量控制示例
Dapr是如何简化微服务的开发和部署
微软开源微服务运行时Dapr,赋能云原生应用开发
Dapr微服务应用开发系列0:概述
Dapr微服务应用开发系列1:环境配置
Dapr微服务应用开发系列2:Hello World与SDK初接触
Dapr微服务应用开发系列3:服务调用构件块
Dapr微服务应用开发系列4:状态管理构件块