Dapr 快速入门 on Dapr 文档库

快速入门：服务调用

Mon, 01 Jan 0001 00:00:00 +0000

通过 Dapr 的服务调用模块，您的应用程序可以稳定且安全地与其他应用程序进行通信。

Dapr 提供了多种服务调用的方法，您可以根据具体需求进行选择。在本教程中，您将启用结账服务，通过 HTTP 代理调用订单处理服务中的方法，具体步骤如下：

在概述文章中了解更多关于 Dapr 服务调用方法的信息。

使用多应用程序运行

在继续本教程之前，请选择您偏好的编程语言。

步骤 1：准备工作

在此示例中，您需要：

快速入门：发布和订阅

Mon, 01 Jan 0001 00:00:00 +0000

我们来了解一下 Dapr 的发布和订阅 (Pub/sub) 构建块。在这个快速入门中，您将运行发布者和订阅者微服务，以演示 Dapr 如何实现 Pub/sub 模式。

使用发布者服务，开发者可以不断地将消息发布到某个主题。
Pub/sub 组件会对这些消息进行排队或代理。我们下面的示例使用 Redis，您也可以使用 RabbitMQ、Kafka 等。
订阅该主题的订阅者会从队列中获取消息并进行处理。

您可以通过以下两种方式尝试此 Pub/sub 快速入门：

使用多应用运行

在继续快速入门之前，请选择您偏好的 Dapr SDK 语言。

步骤 1：先决条件

对于此示例，您将需要：

快速入门：工作流

Mon, 01 Jan 0001 00:00:00 +0000

注意

在快速入门中，Redis 目前用作工作流的状态存储组件。然而，Redis 不支持事务回滚，因此不建议在生产环境中用作 actor 状态存储。

让我们来了解一下 Dapr 的工作流构建块。在这个快速入门中，您将创建一个简单的控制台应用程序，演示 Dapr 的工作流编程模型和管理 API。

在本指南中，您将：

运行 order-processor 应用程序。
启动工作流并观察工作流活动/任务的执行。
查看工作流逻辑和工作流活动，以及它们在代码中的表示。

在继续快速入门之前，请选择您偏好的 Dapr SDK 语言版本。

order-processor 控制台应用程序启动并管理 order_processing_workflow，该工作流模拟从商店购买商品。工作流由五个独特的工作流活动或任务组成：

快速入门：状态管理

Mon, 01 Jan 0001 00:00:00 +0000

本文将介绍 Dapr 的状态管理模块。在本快速入门指南中，您将学习如何使用 Redis 状态存储来保存、获取和删除状态。您可以选择以下两种方式之一：

虽然本示例使用了 Redis，您也可以替换为其他支持的状态存储。

使用多应用运行

在开始之前，请选择您偏好的编程语言对应的 Dapr SDK。

先决条件

您需要准备以下环境：

快速入门：输入和输出绑定

Mon, 01 Jan 0001 00:00:00 +0000

我们来了解一下 Dapr 的绑定构建块。通过使用绑定，您可以：

让您的应用程序响应来自外部系统的事件。
与外部系统进行交互。

在本快速入门中，您将使用输入 Cron 绑定每 10 秒调度一次批处理脚本。该脚本处理一个 JSON 文件，并使用 PostgreSQL Dapr 绑定将数据输出到 SQL 数据库。

在继续快速入门之前，请选择您偏好的 Dapr SDK 语言版本。

先决条件

您需要准备以下环境：

快速入门：Actors

Mon, 01 Jan 0001 00:00:00 +0000

我们来了解一下 Dapr 的 Actors 构建模块。在这个快速入门中，您将运行一个智能设备微服务和一个简单的控制台客户端，以演示 Dapr Actors 中的有状态对象模式。

目前，您可以通过 .NET SDK 体验这个 actors 快速入门。

以下是 .NET actors 快速入门的简要概述：

使用 SmartDevice.Service 微服务，您将托管：
- 两个 SmokeDetectorActor 烟雾报警对象
- 一个 ControllerActor 对象，用于指挥和控制智能设备
使用 SmartDevice.Client 控制台应用程序，客户端应用程序与每个 actor 或控制器交互，以执行聚合操作。
SmartDevice.Interfaces 包含服务和客户端应用程序使用的共享接口和数据类型。

先决条件

对于这个示例，您将需要：

Dapr CLI 和已初始化的环境。

Docker Desktop

安装 .NET 6、.NET 8 或 .NET 9

注意： .NET 6 是此版本中 Dapr .NET SDK 包的最低支持版本。只有 .NET 8 和 .NET 9 将在 Dapr v1.16 及更高版本中得到支持。

快速入门：机密管理

Mon, 01 Jan 0001 00:00:00 +0000

Dapr提供了一个专用的机密API，允许开发者从机密存储中检索机密。在本快速入门中，您将：

运行一个带有机密存储组件的微服务。
在应用程序代码中使用Dapr机密API检索机密。

在继续快速入门之前，请选择您偏好的编程语言对应的Dapr SDK。

前置条件

您需要准备以下环境：

Docker Desktop

步骤1：设置环境

克隆快速入门仓库中的示例。

快速入门：配置

Mon, 01 Jan 0001 00:00:00 +0000

接下来，我们将介绍 Dapr 的配置模块。配置项通常具有动态特性，并且与应用程序的需求紧密相关。配置项是包含配置信息的键/值对，例如：

应用程序 ID
分区键
数据库名称等

在本快速入门中，您将运行一个使用配置 API 的 order-processor 微服务。该服务将：

从配置存储中获取配置项。
订阅配置更新。

在继续快速入门之前，请选择您偏好的 Dapr SDK 语言版本。

前提条件

您需要准备以下环境：

快速入门：加密技术

Mon, 01 Jan 0001 00:00:00 +0000

Alpha

加密构建块目前处于初始阶段。

我们来了解一下 Dapr 的加密构建块。在这个快速入门中，您将创建一个应用程序，使用 Dapr 加密 API 来加密和解密数据。您将：

加密并解密一个短字符串（使用 RSA 密钥），在内存中读取结果，使用 Go 的字节切片格式。
加密并解密一个大文件（使用 AES 密钥），通过流的方式将加密和解密的数据存储到文件中。

注意

此示例使用 Dapr SDK，该 SDK 利用 gRPC，并在使用加密 API 加密和解密消息时强烈推荐使用。

目前，您可以使用 Go SDK 体验加密 API。

此快速入门包括一个名为 crypto-quickstart 的 JavaScript 应用程序。

前置条件

对于此示例，您将需要：

Docker Desktop

系统上可用的 OpenSSL

步骤 1：设置环境

克隆快速入门仓库中提供的示例

快速入门：作业

Mon, 01 Jan 0001 00:00:00 +0000

Alpha

作业构建块目前处于 alpha 阶段。

Dapr 作业构建块允许您在特定时间或间隔调度和运行作业。在本快速入门中，您将学习如何使用 Dapr 的作业 API 来调度、获取和删除作业。

您可以通过以下两种方式来体验此作业快速入门：

同时运行多个应用

在开始之前，请选择您偏好的 Dapr SDK 语言。目前，您可以使用 Go SDK 来试验作业 API。

本快速入门包含两个应用程序：

job-scheduler.go： 负责调度、检索和删除作业。
job-service.go： 负责处理已调度的作业。

步骤 1：准备工作

您需要以下工具：

Docker Desktop

步骤 2：设置环境

克隆快速入门仓库中的示例。

git clone https://github.com/dapr/quickstarts.git

cd jobs/go/sdk

步骤 3：调度作业

运行应用程序并调度作业：