Dapr 官网:https://dapr.io/
实战 Dapr 的 Redis 发布/订阅应用
1. 创建项目
首先,我们将创建我们的项目根文件夹来托管我们将在后续步骤中创建的所有服务。
mkdir dapr-nestjs-redis-pub-sub
2. 创建 Dapr Placement 服务
由于我们将创建多个服务,我们将使用 docker-compose 来运行这些服务。
让我们在项目的根文件夹中创建 docker-compose.yml 文件
cd dapr-nestjs-redis-pub-sub
touch docker-compose.yml
version: "3.5"
services:
dapr-placement:
image: "daprio/dapr"
command: ["./placement", "-port", "50006"]
Dapr placement 服务将负责管理 Dapr actors(我们的服务)之间的所有通信。
简单来说,它负责将所有通信路由到假设接收通信的相应 actor。它充当 message broker(消息代理)。
3. 创建 Redis Publish 服务
让我们继续通过添加我们的 Redis 服务来修改我们的 docker-compose.yml 文件。
将以下代码添加到 docker-compose.yml 的服务部分:
redis-publisher:
image: redis
restart: always
depends_on:
- dapr-placement
4. 创建 Dapr Pub-Sub 组件
创建一个 dapr/components 文件夹。然后创建组件文件 redis-pubsub.yaml。
mkdir -p dapr/components
cd dapr/components
touch redis-pubsub.yaml
然后打开文件并插入我们的 Dapr pub/sub 组件的详细信息
apiVersion: dapr.io/v1alpha1
kind: Component
metadata:
name: redis-pubsub
namespace: default
spec:
type: pubsub.redis
version: v1
metadata:
- name: redisHost
value: redis-publisher:6379
- name: redisPassword
value: ""
redisHost 是我们的 Redis 服务 redis-pub 的名称,默认 Redis 端口为 6379。
5. 创建 Redis Dapr Sidecar
正如前面部分反复提到的,服务直接与 Dapr 通信,而不是直接与其他服务通信。Dapr 充当所有服务的中间人。
服务通过它们自己的 Dapr sidecar 直接与 Dapr 通信,Dapr sidecar 将通信传递给 Dapr placement,该 placement 再次将其传递给假设接收通信的服务的 Dapr sidecar。
将 redis-dapr-sidecar 服务添加到我们的 docker-compose.yml
redis-dapr-sidecar:
image: "daprio/daprd:edge"
command: [
"./daprd",
"-app-id",
"redis-publisher",
"-app-port",
"6379",
"-dapr-http-port",
"5000",
"-components-path",
"/components",
"-placement-host-address",
"dapr-placement:50006"
]
volumes:
- "./dapr/components/:/components"
depends_on:
- redis-publisher
network_mode: "service:redis-publisher"
在这里,我们使用 app-id 将 Dapr sidecar 分配给 redis-publisher,同时我们使用 redis 端口 6379。
我们还必须将 dapr/components(redis-pubsub.yaml) 文件夹挂载到 docker 容器中。
不要忘记声明 dapr-http-port。这是我们的 Dapr sidecar 的 api,允许我们调用各种 HTTP 方法。
定义您的 dapr-http-port 很重要,因为您将在此处调用各种 HTTP 调用/方法/请求。
最后,注意将 redis-dapr-sidecar 附加到 redis-publisher 网络命名空间。
6. 创建 NestJS Server
我们将使用 NestJS 作为我们的 node server 作为我们的 Redis subscriber(订阅者)。
进入到项目文件夹
cd dapr-nestjs-redis-pub-sub
然后执行以下命令设置一个 NestJS node server:
npm i -g @nestjs/cli
nest new nest-subscriber
对于这个项目,我们将选择 yarn 作为包管理器。
接下来,我们将设置一个 post API 端点。 Dapr 将调用这个端点,一旦它收到我们的 Redis 服务发布,它就被调用。
转到 nest-subscriber/src/app.controller.ts
将此文件中的代码替换为以下内容:
import { Controller, Post, Body } from '@nestjs/common';
import { AppService } from './app.service';
@Controller()
export class AppController {
constructor(private readonly appService: AppService) {}
@Post('/redis-publisher')
async postRedisPub(@Body() reqBody) {
console.log(`Redis 发布了 ${JSON.stringify(reqBody)} `);
return `NestJS 订阅者收到的 ${reqBody} 发布`;
}
}
7. 为 NestJS 订阅服务器创建 Dockerfile
我们将 NestJS 服务器作为 Docker 容器运行。需要创建一个 Dockerfile。
cd nest-subscriber
touch Dockerfile
然后打开文件并粘贴以下代码:
FROM node:16.13.0-alpine
WORKDIR "/app"
COPY ./nest-subscriber/package.json ./
RUN yarn install
COPY ./nest-subscriber .
RUN yarn run build
EXPOSE 3000
CMD ["yarn","start:prod"]
构建镜像:
docker build -f ./nest-subscriber/Dockerfile -t nest-subscriber:latest . --no-cache
8. 将 NestJS 订阅服务添加到 docker-compose 文件
在创建了我们的 NestJS 服务器和 Dockerfile 之后,我们创建了 nest-subscriber docker 服务。
将以下内容添加到 docker-compose.yml:
nest-subscriber:
image: "nest-subscriber:latest"
depends_on:
- redis-publisher
- dapr-placement
restart: always
9. 创建 Dapr 订阅
我们将为我们的 pub/sub 订阅定义配置。
创建一个 dapr/subscriptions 文件夹。然后创建组件文件 redis-subscription.yaml
mkdir -p dapr/subscriptions
cd dapr/subscriptions
touch redis-subscription.yaml
然后打开文件并插入我们的 Dapr 订阅组件的详细信息
apiVersion: dapr.io/v1alpha1
kind: Subscription
metadata:
name: nest-redis-sub
spec:
topic: nest-redis-pub-topic
route: /redis-publisher
pubsubname: redis-pubsub
scopes:
- nest-subscriber
路由是发布 topic 时 Dapr 将调用的 API
scope 是订阅该 topic 的服务。
pubsubname 是 redis-pubsub,它等于我们的 redis-pubsub.yaml 文件中定义的元数据名称。
在这个项目中,如果发布了一个 topic nest-redis-pub-topic,Dapr 将在我们的 nest-subscriber 服务中调用 API /redis-publisher。
10. 创建 NestJS 服务器 Dapr Sidecar
我们需要为我们的 NestJS 服务创建一个 sidecar,就像 redis-publisher 服务一样。
将 nest-subscriber-dapr-sidecar 服务添加到我们的 docker-compose.yml
nest-subscriber-dapr-sidecar:
image: "daprio/daprd:edge"
command: [
"./daprd",
"-app-id",
"nest-subscriber",
"-app-port",
"3000",
"-components-path",
"/components",
"-placement-host-address",
"dapr-placement:50006",
]
volumes:
- "./dapr/components/:/components"
depends_on:
- nest-subscriber
network_mode: "service:nest-subscriber"
11. 测试它是否有效
通常 Dapr Docker 容器会在 Docker 网络中进行通信。
但是为了我们做测试,我们将打开映射暴露端口 5000 到我们的本地机器 5001。
redis-publisher:
image: redis
depends_on:
- dapr-placement
restart: always
ports:
- 5001:5000
然后在您的终端中执行以下命令:
curl --location --request POST 'http://localhost:5001/v1.0/publish/redis-pubsub/nest-redis-pub-topic' \
--header 'Content-Type: application/json' \
--data-raw '{
"hello": "world"
}'
Dapr 的优点之一是它遵循特定的 URL 格式。这里我们只使用 Dapr sidecar HTTP 端口(5001),然后是版本号(v1.0),然后是 action(publish)。然后是我们 redis-pubsub.yaml 配置文件中定义的 pubsubname(redis-pubsub)和 topic(nest-redis-pub-topic)。
一旦发出 HTTP post 请求。我们的 NestJS 服务器应该在 /redis-publisher 收到一个 post 请求,这将导致以下日志:
我们可以看到它正在通过 Dapr 接收 Redis 发布。但是我们的 NestJS 服务器无法正确处理消息。
只有 {} 被发布,而不是我们发布的消息。
我们将在下一步中解决这个问题。
注意:我们通过 redis-dapr-sidecar 的 dapr-http-port 调用发布服务。通常会有一个单独的 Docker 服务(例如另一个服务器),它有自己的 Dapr sidecar,它将调用 redis 发布服务。在这种情况下,我们将使用该 Docker 服务的 Dapr sidecar http-port。该请求将由 sidecar 发送到 Dapr placement 服务,然后该服务将确定将请求转发到的正确 Dapr sidecar。
12. 允许 NestJS 解析 application/cloudevents+json
我们的 nest-subscriber-dapr-sidecar 向我们的 nest-subscriber 服务器发出的 post 请求的 Content-Type 将是 application/cloudevents+json 而不是 application/json
目前我们的 NestJS 服务器无法解析 application/cloudevents+json。
为了解决这个问题,我们首先需要安装 body-parser:
cd nest-subscriber
yarn add body-parser
接下来我们需要修改我们的 NestJS 服务器 main.ts:
import { NestFactory } from '@nestjs/core';
import { AppModule } from './app.module';
import * as bodyParser from 'body-parser';
async function bootstrap() {
const app = await NestFactory.create(AppModule);
app.use(bodyParser.json({ type: 'application/cloudevents+json' }));
app.use(bodyParser.json());
await app.listen(3000);
}
bootstrap();
当我们再次发送 post 请求时,我们的 NestJS 服务器将能够处理请求正文并显示以下日志:
好了,我们现在有一个基于 Dapr 工作的 Redis Pub/Sub 分布式应用。
13. 完整 docker-compose.yaml
version: "3.5"
services:
dapr-placement:
image: "daprio/dapr"
command: ["./placement", "-port", "50006"]
redis-publisher:
image: redis
depends_on:
- dapr-placement
restart: always
ports:
- 5001:5000
redis-dapr-sidecar:
image: "daprio/daprd:edge"
command: [
"./daprd",
"-app-id",
"redis-publisher",
"-app-port",
"6379",
"-dapr-http-port",
"5000",
"-components-path",
"/components",
"-placement-host-address",
"dapr-placement:50006"
]
volumes:
- "./dapr/components/:/components"
depends_on:
- redis-publisher
network_mode: "service:redis-publisher"
nest-subscriber:
image: "nest-subscriber:latest"
depends_on:
- redis-publisher
- dapr-placement
restart: always
nest-subscriber-dapr-sidecar:
image: "daprio/daprd:edge"
command: [
"./daprd",
"-app-id",
"nest-subscriber",
"-app-port",
"3000",
"-components-path",
"/components",
"-placement-host-address",
"dapr-placement:50006",
]
volumes:
- "./dapr/components/:/components"
depends_on:
- nest-subscriber
network_mode: "service:nest-subscriber"
14. 源码
https://github.com/Hacker-Linner/dapr-nestjs-redis-pub-sub.git