Windows环境下Dapr入门

DaprDistributed 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的应用开发。这将包含以下步骤:

  1. 启动一个Redis容器实例来作为本地状态存储和消息代理;
  2. 启动一个Zipkin容器实例(一个分布式追踪系统)
  3. 创建一个上述组件的默认文件夹
  4. 启动一个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/v1alpha1

kind: Component

metadata:

 name: my-secret-store

 namespace: default

spec:

 type: secretstores.local.file

 version: v1

 metadata:

 \- name: secretsFile

  value: C:/Edward/mysecrets.json

 \- name: nestedSeparator

  value: ":"

第三步:运行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提供的相关功能。

posted @ 2021-03-20 00:08  Endward  阅读(1008)  评论(0编辑  收藏  举报