在 Rails 项目中使用 Sidekiq 处理异步任务

Sidekiq 是一个提供了执行 定时/异步 任务的后台任务处理系统,它可以集成在 Rails 项目中使用,也可以单独的使用。在本篇文章中,我们将对如何在 Rails 中使用 Sidekiq 进行介绍和分析。

添加依赖

目前 Sidekiq 已经更新到 6.0 版本了,这里我们使用最新的版本

1
2
3
4
5
gem 'sidekiq', '~> 6.0', '>= 6.0.3'  ### bundle install
 
or
 
$ gem install sidekiq

配置文件,添加 config/sidekiq.yml 文件

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
# 最大并发数
concurrency: 5
 
# 进程和日志的输出位置
pidfile: tmp/pids/sidekiq.pid
logfile: log/sidekiq.log
 
# 任务队列
queues:
  - default
  - schedule
 
development:
  concurrency: 5
 
staging:
  concurrency: 10
 
production:
  concurrency: 20

添加 config/initializers/sidekiq.rb 文件

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
# 设置 sidekiq cron 每秒钟检查一次任务,默认是 15 秒钟检查一次任务
Sidekiq.options[:poll_interval]                   = 1
Sidekiq.options[:poll_interval_average]           = 1
 
# 设置 sidekiq 服务端
Sidekiq.configure_server do |config|
 
  # 配置 redis 连接
  config.redis = { url: "redis://localhost:6379/0" }
 
  # 设置 sidekiq 每秒钟都会检查一次作业(默认每5秒检查一次)
  config.average_scheduled_poll_interval = 1
 
  # 从配置文件中读取定时任务
  schedule_file = 'config/sidekiq_schedule.yml'
  if File.exists?(schedule_file)
    Sidekiq::Cron::Job.load_from_hash YAML.load_file(schedule_file)
  end
end
 
Sidekiq.configure_client do |config|
  config.redis = { url: "redis://localhost:6379/0" }
end

在 config/application.rb 中设置配置项:

1
config.active_job.queue_adapter = :sidekiq # 使用 sidekiq 作为异步任务的适配器

异步任务

使用生成器来创建一个发送消息的任务:

1
$ rails g job SendMessage

上面的命令将会创建 app/jobs/send_message_job.rb

1
2
3
4
5
6
class SendMessageJob < ActiveJob::Base
  queue_as :default
  def perform(*args)
    Rails.logger.info "send message..."
  end
end

如何使用

1
2
3
SendMessageJob.perform_async(xxx, xxx, xxx) # 创建异步作业
SendMessageJob.perform_in(1.minutes, xxx, xxx) # 创建延时异步作业
SendMessageJob.perform_at(1.minutes.from_now, xxx, xxx) # 指定时间创建异步作业

定时任务

添加 app/worker/send_message_worker.rb 文件

1
2
3
4
5
6
7
8
9
class SendMessageWorker
  include Sidekiq::Worker
  sidekiq_options queue: :schedule, backtrace: true, retry: false
  # 无需显示调用,sidekiq 运行后会自动执行
  # 传入参数和执行周期在 config/sidekiq_schedule.yml 中配置
  def perform(*args)
      Rails.logger.info 'every second execution...'
  end
end

添加 config/sidekiq_schedule.yml 配置文件

1
2
3
SendMessageWorker:
  cron: '* * * * * *'
  class: SendMessageWorker

通过 sidekiq -C config/sidekiq 命令启动,定时任务将会周期的执行

配置监控

sidekiq 在 4.2 以上版本已经内置了一套监控页面,在 4.2 以前的版本需要添加额外的依赖:

1
gem 'sinatra', '~> 2.0', '>= 2.0.7'

在 config/router.rb 文件中挂载 WebUI 页面的路由。

1
2
3
4
require 'sidekiq/web'
Rails.application.routes.draw do
  mount Sidekiq::Web => '/sidekiq'
end

rails s 启动项目 sidekiq -C config/sidekiq.yml 启动 sidekiq,访问 http://localhost:3000/sidekiq 

  




 
 

  

  

  

  

  

  

  

  

 

 

 

 

 

 

posted @   鞋带松了  阅读(295)  评论(0编辑  收藏  举报
相关博文:
阅读排行:
· 分享一个免费、快速、无限量使用的满血 DeepSeek R1 模型,支持深度思考和联网搜索!
· 基于 Docker 搭建 FRP 内网穿透开源项目(很简单哒)
· ollama系列01:轻松3步本地部署deepseek,普通电脑可用
· 按钮权限的设计及实现
· 25岁的心里话
点击右上角即可分享
微信分享提示