在本地自托管模式下运行 Dapr on Dapr 文档库

Dapr 自托管模式概述

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

概述

Dapr 可以配置为在本地开发者机器或生产环境的虚拟机上运行自托管模式。每个服务都会有一个 Dapr 运行时进程（或称为 sidecar），该进程配置为使用状态存储、发布/订阅、绑定组件和其他构建块。

初始化

Dapr 可以通过 Docker（默认）或 slim-init 模式进行初始化。它也可以在离线或隔离环境中初始化和运行。

注意

您也可以使用 Podman 代替 Docker 作为容器运行时。请参阅使用 Podman 初始化 Dapr 以获取更多详细信息。在由于各种网络限制无法安装 Docker 的情况下，这可能会很有用。

默认的 Docker 设置提供了即用的功能，包含以下容器和配置：

一个 Redis 容器，配置为同时用于状态管理和发布/订阅的默认组件。
一个 Zipkin 容器，用于诊断和跟踪。
默认的 Dapr 配置和组件安装在 $HOME/.dapr/ (Mac/Linux) 或 %USERPROFILE%\.dapr\ (Windows)。

dapr-placement 服务负责管理 actor 的分布方案和键范围设置。此服务不作为容器启动，仅在您使用 Dapr actor 时才需要。有关 actor Placement 服务的更多信息，请阅读 actor 概述。

使用 Dapr 启动应用程序

您可以使用 dapr run CLI 命令启动 Dapr sidecar 进程和您的应用程序。其他参数和标志可以在这里找到。

名称解析

Dapr 使用名称解析组件在服务调用构建块中进行服务发现。默认情况下，Dapr 在自托管模式下使用 mDNS。

如何使用 Podman 在自托管模式下运行 Dapr

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

本文介绍了如何在 Windows/Linux/macOS 机器或虚拟机上使用 Podman 运行 Dapr。

准备工作

设置 Dapr 环境

要设置 Dapr 控制平面容器并创建默认配置文件，请执行以下命令：

dapr init --container-runtime podman

以进程方式运行应用程序和 sidecar

可以使用 dapr run CLI 命令启动 Dapr sidecar 和您的应用程序：

dapr run --app-id myapp --app-port 5000 -- dotnet run

此命令会启动 daprd sidecar 和您的应用程序。

以进程方式运行应用程序，sidecar 作为 Docker 容器运行

如果您希望在 Docker 容器中运行 Dapr，而应用程序在主机上以进程方式运行，则需要配置 Podman 使用主机网络，以便 Dapr 和应用程序可以共享 localhost 网络接口。

在 Linux 主机上运行 Podman 时，可以使用以下命令启动 Dapr：

podman run --network="host" --mount type=bind,source="$(pwd)"/components,target=/components daprio/daprd:edge ./daprd -app-id <my-app-id> -app-port <my-app-port>

然后，您可以在主机上运行您的应用程序，它们可以通过 localhost 网络接口进行连接。

如何使用 Docker 自托管 Dapr

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

本文介绍如何在 Windows/Linux/macOS 机器或虚拟机上使用 Docker 运行 Dapr。

前提条件

设置 Dapr 环境

运行以下命令以初始化 Dapr 控制平面并创建默认配置文件：

dapr init

以进程形式运行应用和 sidecar

使用 dapr run CLI 命令启动 Dapr sidecar 和您的应用程序：

dapr run --app-id myapp --app-port 5000 -- dotnet run

此命令将启动 daprd sidecar 并运行 dotnet run，从而启动您的应用程序。

应用以进程形式运行，sidecar 以 Docker 容器形式运行

如果您希望在 Docker 容器中运行 Dapr，而应用程序在主机上以进程形式运行，则需要配置 Docker 使用主机网络，以便 Dapr 和应用程序可以共享 localhost 网络接口。

注意

Docker 的 host 网络模式仅支持 Linux 主机。

在 Linux 主机上运行 Docker 守护进程时，可以使用以下命令启动 Dapr：

操作指南：在离线或隔离环境中运行Dapr

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

概述

通常情况下，Dapr初始化时会从网络下载二进制文件并拉取镜像来设置开发环境。然而，Dapr也支持使用预先下载的安装包进行离线或隔离安装，这可以通过Docker或精简模式来实现。每个Dapr版本的安装包都被构建成一个Dapr安装包，可以下载。通过使用这个安装包和Dapr CLI的init命令，你可以在没有网络访问的环境中安装Dapr。

设置

在进行隔离初始化之前，需要预先下载一个Dapr安装包，其中包含CLI、运行时和仪表板的内容。这避免了在本地初始化Dapr时需要下载二进制文件和Docker镜像。

下载特定版本的Dapr安装包。例如，daprbundle_linux_amd64.tar.gz，daprbundle_windows_amd64.zip。
解压缩安装包。
要安装Dapr CLI，将daprbundle/dapr (Windows为dapr.exe)二进制文件复制到合适的位置：
- 对于Linux/MacOS - /usr/local/bin
- 对于Windows，创建一个目录并将其添加到系统PATH。例如，创建一个名为c:\dapr的目录，并通过编辑系统环境变量将此目录添加到路径中。
注意：如果Dapr CLI没有移动到合适的位置，你可以直接使用包中的本地dapr CLI二进制文件。上述步骤是为了将其移动到常用位置并添加到路径中。

初始化Dapr环境

Dapr可以在有或没有Docker容器的隔离环境中初始化。

使用Docker初始化Dapr

（前提条件：环境中可用Docker）

进入安装包目录并运行以下命令：

dapr init --from-dir .

对于Linux用户，如果你使用sudo运行Docker命令，你需要使用“sudo dapr init”

如果你不是在安装包目录下运行上述命令，请提供安装包目录的完整路径。例如，假设安装包目录路径是$HOME/daprbundle，运行dapr init --from-dir $HOME/daprbundle以获得相同的效果。

输出应类似于以下内容：

 正在进行超空间跳跃...
ℹ️ 正在安装最新的运行时版本
↘ 正在提取二进制文件并设置组件... 已加载镜像：daprio/dapr:$version
✅ 提取二进制文件并设置组件完成。
✅ 二进制文件提取和组件设置已完成。
ℹ️ daprd二进制文件已安装到$HOME/.dapr/bin。
ℹ️ dapr_placement容器正在运行。
ℹ️ 使用`docker ps`检查正在运行的容器。
✅ 成功！Dapr已启动并运行。要开始使用，请访问：https://aka.ms/dapr-getting-started

注意：要模拟在线 Dapr初始化，使用dapr init，你也可以运行Redis和Zipkin容器，如下所示：

1. docker run --name "dapr_zipkin" --restart always -d -p 9411:9411 openzipkin/zipkin
2. docker run --name "dapr_redis" --restart always -d -p 6379:6379 redislabs/rejson

不使用Docker初始化Dapr

或者，为了让CLI不安装任何默认配置文件或运行任何Docker容器，可以使用init命令的--slim标志。这样只会安装Dapr的二进制文件。

如何在没有 Docker 的环境中以自托管模式运行 Dapr

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

前提条件

安装 Dapr CLI

初始化无容器的 Dapr

Dapr CLI 提供了一个选项，可以使用 slim init 初始化 Dapr，而无需依赖 Docker 来创建默认的开发环境。安装 Dapr CLI 后，使用以下命令进行 slim init 初始化：

dapr init --slim

这将安装两个不同的二进制文件：

daprd
placement

placement 二进制文件用于在 Dapr 自托管安装中启用 actor。

在 slim init 模式下，不会安装用于状态管理或消息发布/订阅的默认组件（如 Redis）。这意味着，除了服务调用外，安装时没有其他内置功能可用。您可以根据需要设置自己的环境和自定义组件。

如果配置了状态存储，则可以进行基于 actor 的服务调用，具体说明请参见以下章节。

执行服务调用

请参阅 Hello Dapr slim 示例，了解如何在 slim init 模式下执行服务调用。

启用状态管理或消息发布/订阅

请参阅在无 Docker 的自托管模式下配置 Redis 的文档，以启用本地状态存储或用于消息传递的发布/订阅代理。

启用 actor

要启用 actor placement：

在本地运行 placement 服务。
启用支持 ETags 的事务性状态存储以使用 actor。例如，在自托管模式下配置的 Redis。

默认情况下，placement 二进制文件安装在：

操作指南：持久化调度器作业

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

调度器服务负责将作业写入嵌入式数据库并进行调度执行。默认情况下，调度器服务会将数据写入本地卷dapr_scheduler，这意味着数据在重启时会被持久化。

此本地卷的主机文件位置通常位于/var/lib/docker/volumes/dapr_scheduler/_data或~/.local/share/containers/storage/volumes/dapr_scheduler/_data，具体取决于您的容器运行时。请注意，如果您使用的是Docker Desktop，此卷位于Docker Desktop虚拟机的文件系统中，可以通过以下命令访问：

docker run -it --privileged --pid=host debian nsenter -t 1 -m -u -n -i sh

调度器的持久卷可以通过使用预先存在的自定义卷进行修改，或者由Dapr自动创建。

注意

默认情况下，dapr init会在您的驱动器上创建一个名为dapr_scheduler的本地持久卷。如果Dapr已经安装，您需要完全卸载控制平面，然后才能使用新的持久卷重新创建调度器容器。

dapr init --scheduler-volume my-scheduler-volume

在自托管环境中升级 Dapr 的步骤

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

卸载当前的 Dapr 部署：

注意
这将删除默认的 $HOME/.dapr 目录、二进制文件和所有容器（dapr_redis、dapr_placement 和 dapr_zipkin）。如果在 Linux 上运行 docker 命令需要使用 sudo，请使用 sudo。
```
dapr uninstall --all
```
访问本指南以下载并安装最新版本的 CLI。
初始化 Dapr 运行时：
```
dapr init
```

确认您正在使用最新版本的 Dapr (v1.16.9)：

$ dapr --version

CLI version: 1.16
Runtime version: 1.16

在自托管环境中卸载 Dapr

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

以下 CLI 命令用于移除 Dapr sidecar 二进制文件和 placement 容器：

dapr uninstall

上述命令不会移除在 dapr init 时默认安装的 Redis 或 Zipkin 容器，以防您将它们用于其他用途。要移除 Redis、Zipkin、actor placement 容器，以及位于 $HOME/.dapr 或 %USERPROFILE%\.dapr\ 的默认 Dapr 目录，请运行以下命令：

dapr uninstall --all

注意

对于 Linux/MacOS 用户，如果您使用 sudo 运行 docker 命令，或者 Dapr 安装在 /usr/local/bin（默认安装路径），则需要使用 sudo dapr uninstall 来移除 Dapr 二进制文件和/或容器。