使用 Dapr .NET SDK 开发应用程序 on Dapr 文档库

使用 Dapr CLI 进行 Dapr .NET SDK 开发

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

Dapr CLI

可以将本文视为 Docker 自托管 Dapr 指南的 .NET 伴侣指南。

Dapr CLI 为您提供了一个良好的开发基础，它会初始化本地 Redis 容器、Zipkin 容器、placement 服务以及 Redis 的组件清单。这使您可以在全新安装且无需额外设置的情况下，使用以下构建块：

您可以使用 dapr run 来运行 .NET 服务，作为本地开发的策略。计划为每个服务运行以下命令之一以启动您的应用程序。

优点： 由于这是默认 Dapr 安装的一部分，因此设置起来很容易
缺点： 这会在您的机器上使用长时间运行的 Docker 容器，这可能并不理想
缺点： 这种方法的可扩展性较差，因为它需要为每个服务单独运行命令

使用 Dapr CLI

对于每个服务，您需要选择：

用于寻址的唯一 app-id（app-id）
用于 HTTP 的唯一监听端口（port）

您还应该决定在哪里存储组件（components-path）。

以下命令可以在多个终端中运行以启动每个服务，并将相应的值替换进去。

dapr run --app-id <app-id> --app-port <port> --components-path <components-path> -- dotnet run -p <project> --urls http://localhost:<port>

说明： 此命令将使用 dapr run 来启动每个服务及其边车。命令的前半部分（在 -- 之前）将所需的配置传递给 Dapr CLI。命令的后半部分（在 -- 之后）将所需的配置传递给 dotnet run 命令。

使用 Docker Compose 进行 Dapr .NET SDK 开发

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

Docker Compose

可将本文视为使用 Docker 自托管 Dapr 指南的 .NET 伴侣指南。

docker-compose 是随 Docker Desktop 附带的 CLI 工具，可用于同时运行多个容器。它是一种将多个容器的生命周期进行自动化的方式，并为面向 Kubernetes 的应用提供类似生产环境的开发体验。

优点： 由于 docker-compose 会为你管理容器，你可以将依赖项作为应用定义的一部分，并停止机器上长期运行的容器。
缺点： 投入成本最高，服务需要容器化才能开始使用。
缺点： 如果你不熟悉 Docker，可能会难以调试和排查故障。

使用 docker-compose

从 .NET 的角度来看，对于 Dapr 的 docker-compose 不需要专门的指导。docker-compose 运行容器，一旦你的服务进入容器中，其配置与任何其他编程技术类似。

💡 应用端口

在容器中，ASP.NET Core 应用默认监听端口 80。稍后配置 --app-port 时请记住这一点。

总结方法如下：

为每个服务创建一个 Dockerfile
创建一个 docker-compose.yaml 并将其签入源代码仓库

要了解如何编写 docker-compose.yaml，你应该从 Hello, docker-compose 示例开始。

与使用 dapr run 在本地运行的每个服务类似，你需要选择一个唯一的 app-id。选择容器名称作为 app-id 会更容易记忆。

compose 文件至少包含：

容器用于通信的网络
每个服务的容器
指定了服务端口和 app-id 的 <service>-daprd 边车容器
在容器中运行的其他依赖项（例如 redis）
可选：Dapr placement 容器（用于 Actor）

你还可以从 eShopOnContainers 示例应用中查看更大的示例。

使用 .NET Aspire 进行 Dapr .NET SDK 开发

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

.NET Aspire

.NET Aspire 是一种开发工具，旨在通过提供一个框架，使第三方服务能够与您自己的软件一起轻松集成、观察和配置，从而更轻松地将外部软件包含到 .NET 应用程序中。

Aspire 通过与流行的 IDE 提供丰富的集成来简化本地开发，包括 Microsoft Visual Studio、 Visual Studio Code、 JetBrains Rider 等，以便在启动调试器启动应用程序的同时，自动启动和配置对其他集成的访问，包括 Dapr。

虽然 Aspire 还协助将应用程序部署到各种云主机（如 Microsoft Azure 和 Amazon AWS），但部署目前超出了本指南的范围。更多信息可以在 Aspire 的文档这里找到。

可以在这里找到一个端到端演示，其中包含以下内容并演示了多个启用 Dapr 的服务之间的服务调用。

前提条件

Dapr .NET SDK 支持 .NET 8、 .NET 9 和 .NET 10。使用支持您选择的运行时的 .NET Aspire 版本。
符合 OCI 标准的容器运行时，例如 Docker Desktop 或 Podman
安装并初始化 Dapr v1.16 或更高版本

通过 CLI 使用 .NET Aspire

我们将首先创建一个全新的 .NET 应用程序。打开您喜欢的 CLI 并导航到您希望在其中创建新 .NET 解决方案的目录。首先使用以下命令安装一个模板，该模板将创建一个空的 Aspire 应用程序：

dotnet new install Aspire.ProjectTemplates

安装完成后，继续在当前目录中创建一个空的 .NET Aspire 应用程序。-n 参数允许您指定输出解决方案的名称。如果排除该参数，.NET CLI 将改为使用输出目录的名称，例如 C:\source\aspiredemo 将导致解决方案被命名为 aspiredemo。本教程的其余部分将假设解决方案名为 aspiredemo。