Gush 项目教程

Gush 项目教程

gush Fast and distributed workflow runner using ActiveJob and Redis 项目地址: https://gitcode.com/gh_mirrors/gu/gush

1. 项目介绍

Gush 是一个快速且分布式的任务流运行器，使用 ActiveJob 和 Redis 作为存储。它依赖于有向无环图（DAG）来存储任务之间的依赖关系。Gush 的设计灵感来自于 Stephen Toub 的文章《Parallelizing Operations With Dependencies》。

Gush 的主要特点包括：

• 使用 Redis 作为存储，确保任务的分布式执行。
• 通过 ActiveJob 进行任务调度和执行。
• 支持复杂的任务依赖关系，通过 DAG 来管理任务的执行顺序。

2. 项目快速启动

安装 Gush

1. 在 Gemfile 中添加 Gush：

   gem 'gush', '~> 3.0'
   

2. 创建 Gushfile：

   # Gushfile
   require_relative '../config/environment'
   

定义工作流

以下是一个简单的示例工作流：

# app/workflows/sample_workflow.rb
class SampleWorkflow < Gush::Workflow
  def configure(url_to_fetch_from)
    run FetchJob1, params: { url: url_to_fetch_from }
    run FetchJob2, params: { some_flag: true, url: 'http://url.com' }
    run PersistJob1, after: FetchJob1
    run PersistJob2, after: FetchJob2
    run Normalize, after: [PersistJob1, PersistJob2], before: Index
    run Index
  end
end

启动工作流

1. 启动后台工作进程：

   bundle exec sidekiq -q gush
   

2. 创建并启动工作流：

   flow = SampleWorkflow.create("http://example.com")
   flow.start
   

3. 应用案例和最佳实践

应用案例

Gush 可以用于处理复杂的任务依赖关系，例如：

• 数据处理管道：从多个数据源获取数据，进行处理和存储。
• 批量任务处理：在多个任务之间建立依赖关系，确保任务按顺序执行。

最佳实践

• 合理定义任务依赖关系：使用 after 和 before 属性来定义任务之间的依赖关系，确保任务按正确的顺序执行。
• 使用全局参数：通过 globals 参数传递全局参数，简化任务的配置。
• 监控任务状态：使用 flow.reload 和 flow.status 来监控任务的执行状态。

4. 典型生态项目

Gush 可以与其他 Ruby 生态项目结合使用，例如：

• ActiveJob：用于任务的调度和执行。
• Redis：作为任务存储和状态管理的存储后端。
• Sidekiq：作为任务执行的后台工作进程。

通过这些生态项目的结合，Gush 可以构建出高效且可靠的任务处理系统。

gush Fast and distributed workflow runner using ActiveJob and Redis 项目地址: https://gitcode.com/gh_mirrors/gu/gush