Dapr Python SDK 插件 on Dapr 文档库

开始使用 Dapr Python gRPC 服务扩展

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

Dapr Python SDK 提供了一个用于创建 Dapr 服务的内置 gRPC 服务器扩展 dapr.ext.grpc。

安装

您可以通过以下命令下载并安装 Dapr gRPC 服务器扩展：

pip install dapr-ext-grpc

注意

开发包包含与 Dapr 运行时预发布版本兼容的功能和行为。在安装 <code>dapr-dev</code> 包之前，请确保卸载任何稳定版本的 Python SDK 扩展。

pip3 install dapr-ext-grpc-dev

示例

您可以使用 App 对象来创建一个服务器。

监听服务调用请求

可以使用 InvokeMethodRequest 和 InvokeMethodResponse 对象来处理传入的请求。

以下是一个简单的服务示例，它会监听并响应请求：

from dapr.ext.grpc import App, InvokeMethodRequest, InvokeMethodResponse

app = App()

@app.method(name='my-method')
def mymethod(request: InvokeMethodRequest) -> InvokeMethodResponse:
 print(request.metadata, flush=True)
 print(request.text(), flush=True)

 return InvokeMethodResponse(b'INVOKE_RECEIVED', "text/plain; charset=UTF-8")

app.run(50051)

完整示例可以在这里找到。

Dapr Python SDK 与 FastAPI 集成指南

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

Dapr Python SDK 通过 dapr-ext-fastapi 扩展实现与 FastAPI 的集成。

安装

您可以通过以下命令下载并安装 Dapr FastAPI 扩展：

pip install dapr-ext-fastapi

注意

开发版包含与 Dapr 运行时预发布版本兼容的功能。在安装 <code>dapr-dev</code> 包之前，请先卸载任何稳定版本的 Python SDK 扩展。

pip install dapr-ext-fastapi-dev

示例

订阅不同类型的事件

import uvicorn
from fastapi import Body, FastAPI
from dapr.ext.fastapi import DaprApp
from pydantic import BaseModel

class RawEventModel(BaseModel):
 body: str

class User(BaseModel):
 id: int
 name = 'Jane Doe'

class CloudEventModel(BaseModel):
 data: User
 datacontenttype: str
 id: str
 pubsubname: str
 source: str
 specversion: str
 topic: str
 traceid: str
 traceparent: str
 tracestate: str
 type: str 
 
app = FastAPI()
dapr_app = DaprApp(app)

# 处理任意结构的事件（简单但不够可靠）
# dapr publish --publish-app-id sample --topic any_topic --pubsub pubsub --data '{"id":"7", "desc": "good", "size":"small"}'
@dapr_app.subscribe(pubsub='pubsub', topic='any_topic')
def any_event_handler(event_data = Body()):
 print(event_data) 

# 为了更稳健，根据发布者是否使用 CloudEvents 选择以下之一

# 处理使用 CloudEvents 发送的事件
# dapr publish --publish-app-id sample --topic cloud_topic --pubsub pubsub --data '{"id":"7", "name":"Bob Jones"}'
@dapr_app.subscribe(pubsub='pubsub', topic='cloud_topic')
def cloud_event_handler(event_data: CloudEventModel):
 print(event_data) 

# 处理未使用 CloudEvents 发送的原始事件
# curl -X "POST" http://localhost:3500/v1.0/publish/pubsub/raw_topic?metadata.rawPayload=true -H "Content-Type: application/json" -d '{"body": "345"}'
@dapr_app.subscribe(pubsub='pubsub', topic='raw_topic')
def raw_event_handler(event_data: RawEventModel):
 print(event_data) 

if __name__ == "__main__":
 uvicorn.run(app, host="0.0.0.0", port=30212)

创建一个 actor

from fastapi import FastAPI
from dapr.ext.fastapi import DaprActor
from demo_actor import DemoActor

app = FastAPI(title=f'{DemoActor.__name__}服务')

# 添加 Dapr actor 扩展
actor = DaprActor(app)

@app.on_event("startup")
async def startup_event():
 # 注册 DemoActor
 await actor.register_actor(DemoActor)

@app.get("/GetMyData")
def get_my_data():
 return "{'message': 'myData'}"

Dapr Python SDK 与 Flask 集成

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

Dapr Python SDK 使用 flask-dapr 扩展来实现与 Flask 的集成。

安装

您可以通过以下命令下载并安装 Dapr Flask 扩展：

pip install flask-dapr

注意

开发版包含与 Dapr 运行时预发布版本兼容的功能和行为。在安装 <code>dapr-dev</code> 包之前，请确保卸载任何已安装的稳定版 Python SDK 扩展。

pip install flask-dapr-dev

示例

from flask import Flask
from flask_dapr.actor import DaprActor

from dapr.conf import settings
from demo_actor import DemoActor

app = Flask(f'{DemoActor.__name__}Service')

# 启用 DaprActor Flask 扩展
actor = DaprActor(app)

# 注册 DemoActor
actor.register_actor(DemoActor)

# 设置方法路由
@app.route('/GetMyData', methods=['GET'])
def get_my_data():
 return {'message': 'myData'}, 200

# 运行应用程序
if __name__ == '__main__':
 app.run(port=settings.HTTP_APP_PORT)