使用 Dapr 客户端 Python SDK 入门

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

Dapr 客户端包使您能够从 Python 应用程序与其他 Dapr 应用程序进行交互。

注意

如果您还没有尝试过，请尝试其中一个快速入门，以快速了解如何使用 Dapr Python SDK 和 API 构建块。

准备工作

导入客户端包

dapr 包包含 DaprClient，用于创建和使用客户端。

from dapr.clients import DaprClient

初始化客户端

您可以通过多种方式初始化 Dapr 客户端：

默认值：

如果不提供参数初始化客户端，它将使用 Dapr sidecar 实例的默认值 (127.0.0.1:50001)。

from dapr.clients import DaprClient

with DaprClient() as d:
 # 使用客户端

在初始化时指定端点：

在构造函数中传递参数时，gRPC 端点优先于任何配置或环境变量。

from dapr.clients import DaprClient

with DaprClient("mydomain:50051?tls=true") as d:
 # 使用客户端

配置选项：

Dapr Sidecar 端点

您可以使用标准化的 DAPR_GRPC_ENDPOINT 环境变量来指定 gRPC 端点。当设置了此变量时，可以在没有任何参数的情况下初始化客户端：

export DAPR_GRPC_ENDPOINT="mydomain:50051?tls=true"

from dapr.clients import DaprClient

with DaprClient() as d:
 # 客户端将使用环境变量中指定的端点

旧的环境变量 DAPR_RUNTIME_HOST、DAPR_HTTP_PORT 和 DAPR_GRPC_PORT 也被支持，但 DAPR_GRPC_ENDPOINT 优先。

使用 Dapr actor Python SDK 入门

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

Dapr actor 包使您能够从 Python 应用程序与 Dapr 虚拟 actor 交互。

先决条件

已安装 Dapr CLI
已初始化 Dapr 环境
已安装 Python 3.8+
已安装 Dapr Python 包

actor 接口

接口定义了 actor 实现和调用 actor 的客户端之间共享的协议。由于客户端可能依赖于此协议，通常将其定义在与 actor 实现分开的模块中是有意义的。

from dapr.actor import ActorInterface, actormethod

class DemoActorInterface(ActorInterface):
 @actormethod(name="GetMyData")
 async def get_my_data(self) -> object:
 ...

actor 服务

actor 服务负责托管虚拟 actor。它是一个从基类 Actor 派生并实现 actor 接口中定义的类。

可以使用以下 Dapr actor 扩展之一创建 actor：

actor 客户端

actor 客户端用于实现调用 actor 接口中定义的方法。

import asyncio

from dapr.actor import ActorProxy, ActorId
from demo_actor_interface import DemoActorInterface

async def main():
 # 创建代理客户端
 proxy = ActorProxy.create('DemoActor', ActorId('1'), DemoActorInterface)

 # 在客户端上调用方法
 resp = await proxy.GetMyData()

示例

访问此页面获取可运行的 actor 示例。

Dapr Python SDK on Dapr 文档库