Bull 项目教程

强海寒

于 2024-10-09 09:18:59 发布

阅读量398

点赞数 5

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00507/article/details/142776590

Bull 项目教程

bull Premium Queue package for handling distributed jobs and messages in NodeJS. 项目地址: https://gitcode.com/gh_mirrors/bu/bull

1. 项目介绍

Bull 是一个用于处理 Node.js 中分布式任务和消息的高级队列包。它基于 Redis，提供了可靠、高性能的任务队列解决方案。Bull 的设计旨在确保稳定性和原子性，适用于需要处理大量任务的场景。

主要特性

最小 CPU 使用率：由于采用了无轮询设计，Bull 在处理任务时 CPU 使用率极低。
延迟任务：支持延迟任务的调度。
定时任务：可以根据 cron 规范调度任务。
任务重试：支持任务的重试机制。
优先级：可以为任务设置优先级。
并发处理：支持任务的并发处理。
暂停/恢复：可以全局或局部暂停和恢复任务队列。

2. 项目快速启动

安装 Bull

首先，确保你已经安装了 Node.js 和 Redis。然后，使用 npm 或 yarn 安装 Bull：

npm install bull --save
# 或者
yarn add bull

基本使用

以下是一个简单的 Bull 队列示例，展示了如何创建队列、添加任务以及处理任务。

const Queue = require('bull');

// 创建一个视频转码队列，连接到本地的 Redis
const videoQueue = new Queue('video transcoding', 'redis://127.0.0.1:6379');

// 定义任务处理器
videoQueue.process(function (job, done) {
  // job.data 包含任务创建时传递的自定义数据
  // job.id 包含任务的 ID

  // 异步转码视频并报告进度
  job.progress(42);

  // 完成任务时调用 done
  done();

  // 或者在出错时传递错误
  done(new Error('error transcoding'));

  // 或者传递结果
  done(null, { framerate: 29.5 /* 其他结果 */ });

  // 如果任务抛出未处理的异常，也会被正确处理
  throw new Error('some unexpected error');
});

// 添加任务到队列
videoQueue.add({ video: 'http://example.com/video1.mov' });