rabbit-slide-nishidayuya-2025-07-25-redmine_japan_vol4-redmine_meets_solid_queue 2025.7.25.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: e3e5a5e0ff9f15d36711a7ce7ced626b639a020b2fda2d8972330d120ec2ebe5
+  data.tar.gz: b2ecb50e4d1b958e6fc43993bd6a65ed36149625f26d4673ccf2bab2530bff09
+SHA512:
+  metadata.gz: 173e3fb6ab2e1d43027b99497e9632981a7bbd5e7e9940b29a002862fa235f5fb096fe05ec06517c8f789e9d9d0e2b0fcac37b505456ca962f6082d29a0400ba
+  data.tar.gz: 4bd16ce89acbea2fadabc597998fdc81d497462458dc0b45bdf6bdfcd7a1ab70448e7e503794472d68ff9225b333e2c5da6068b6a0f8d808ab70e4896ee0c915

data/.rabbit

@@ -0,0 +1,2 @@
+--size 1368,768
+redmine_meets_solid_queue.md

data/README.md

@@ -0,0 +1,24 @@
+# Redmine × Solid Queue: 安心簡単キュー構成
+
+2025-07-25に開催された[REDMINE JAPAN vol.4](https://redmine-japan.org/vol-4/time-table/#a07-3)の発表資料
+
+## 作者向け
+
+### 表示
+
+    rake
+
+### 公開
+
+    rake publish
+
+## 閲覧者向け
+
+### インストール
+
+    gem install rabbit-slide-nishidayuya-2025-07-25-redmine_japan_vol4-redmine_meets_solid_queue
+
+### 表示
+
+    rabbit rabbit-slide-nishidayuya-2025-07-25-redmine_japan_vol4-redmine_meets_solid_queue.gem
+

data/Rakefile

@@ -0,0 +1,17 @@
+require "rabbit/task/slide"
+
+# Edit ./config.yaml to customize meta data
+
+spec = nil
+Rabbit::Task::Slide.new do |task|
+  spec = task.spec
+  # spec.files += Dir.glob("doc/**/*.*")
+  # spec.files -= Dir.glob("private/**/*.*")
+  # spec.add_runtime_dependency("rabbit-theme-YOUR-THEME")
+end
+
+desc "Tag #{spec.version}"
+task :tag do
+  sh("git", "tag", "-a", spec.version.to_s, "-m", "Publish #{spec.version}")
+  sh("git", "push", "--tags")
+end

data/config.yaml

@@ -0,0 +1,26 @@
+---
+id: 2025-07-25-redmine_japan_vol4-redmine_meets_solid_queue
+base_name: redmine_meets_solid_queue
+tags:
+- redmine
+- redminejapan
+presentation_date: '2025-07-25'
+presentation_start_time:
+presentation_end_time:
+version: 2025.7.25.0
+licenses:
+- CC-BY-4.0
+slideshare_id:
+speaker_deck_id:
+vimeo_id:
+youtube_id:
+width: 1368
+height: 768
+source_code_uri:
+author:
+  markup_language: :markdown
+  name: Yuya.Nishida.
+  email:
+  rubygems_user: nishidayuya
+  slideshare_user:
+  speaker_deck_user: nishidayuya

data/redmine_meets_solid_queue.md

@@ -0,0 +1,140 @@
+# Redmine × Solid Queue: 安心簡単キュー構成
+
+author
+:   西田雄也
+
+date
+:   2025-07-25
+    REDMINE JAPAN vol.4
+
+allotted-time
+:   7m
+
+theme
+:   local_theme
+
+start-time
+:   2025-07-25
+
+end-time
+:   2025-07-25
+
+# 背景: キューアダプター
+
+- https://www.redmine.org/projects/redmine/wiki/RedmineInstall#Queues-adapter より，
+
+```
+Redmine uses ActiveJob::QueueAdapters::AsyncAdapter
+as default queue adapter which is not recommended
+for production environment. Recommended adapter is
+Sidekiq which uses Redis for persistance.
+```
+
+- RedmineはAsyncAdapterをデフォルトのキューアダプターとして使うが，本番環境では推奨しない．
+- 推奨するアダプターはRedisを永続化に使うSidekiqである．
+
+# 背景: どういうことか
+
+- Redmineはチケットの追加や更新をメイル通知するのにデフォルトではキューアダプターにAsyncAdapterを使っている．
+- AsyncAdapterはスレッドベースのため，Redmineが終了するとそのジョブが失われる．具体的にはメイルが失われる．
+
+![](images/async_queue_adapter.png){:relative_height='30'}
+
+↓
+
+- 実運用の設定例としてジョブの保存先にRedisを使うSidekiqAdapterの設定がredmine.orgで紹介されている．
+
+# 背景: キューアダプターあれこれ
+
+- RDBMSをバックエンドにするキューアダプター: DelayedJob, GoodJob, Solid Queue
+- RDBMSで済むならSidekiqと違ってRedisが不要になる
+    - ただしパフォーマンス面はRedisの方が良い
+- Rails 8からSolid Queueがデフォルトのキューアダプターになった
+
+↓
+
+- Redmineでも使って楽しよう！
+
+# 手順: 準備
+
+1. Gemfile.localに`gem "solid_queue"`
+1. 実行: `bundle && bin/rails solid_queue:install`
+1. db/migrate/年月日時分秒_add_solid_queue_tables.rbにdb/queue_schema.rbの内容を書く
+     - 楽するためにシングルデータベースにしてます
+1. 実行: `bin/rails db:migrate`
+1. config/additional_environment.rbに`config.active_job.queue_adapter = :solid_queue`
+
+# 手順: ジョブ処理プロセス実行
+
+- 以下のようにしてスーパーバイザー（ジョブ処理のためのもろもろのプロセス実行するもの）起動
+
+```console
+$ bin/jobs start
+```
+
+- Pumaを使っている場合はRedmine起動時に合わせて起動することも可能
+
+```ruby
+# config/puma.rb
+plugin :solid_queue
+```
+
+# できた
+
+![](images/solid_queue_adapter.png){:relative_height='100'}
+
+# めでたしめでたし
+
+# 手順多い
+
+# もっと簡単にできないのか？
+
+# そうだ
+
+# 我らがRedmineは
+
+# プラグイン機能がある
+
+# ということで
+
+# プラグインを書きました
+
+- redmine_solid_queueプラグインを入れて，
+
+```console
+$ git clone \
+    https://github.com/nishidayuya/redmine_solid_queue \
+    plugins/redmine_solid_queue &&
+  bin/rails redmine:plugins
+```
+
+- スーパーバイザーを起動するだけ
+
+```console
+$ plugins/redmine_solid_queue/bin/jobs start
+```
+
+- Pumaを使っている場合は↑も不要という親切設計
+    - 別ノードにしたいから余計なお世話な場合は環境変数でdisable
+
+# まとめ
+
+- Solid Queueは安心簡単
+- メイル通知の頻度によってはこれだけで十分
+- ↓のプラグインを使えば2コマンド実行だけで導入可能
+- https://github.com/nishidayuya/redmine_solid_queue
+
+![](images/qrcode_github.com.png){:relative_height='130'}
+
+# 時間が余ったら
+
+# 自己紹介: 西田雄也 @nishidayuya
+
+- ネットワーク応用通信研究所所属プログラマ
+- 作ったことがあるRedmineプラグイン
+    - redmine_text_format_converter: TextileからMarkdownへ変換
+    - redmine_ruby_wasm: Redmine上でRubyのコードを実行
+    - The Never Deleting Story a.k.a. 絶対削除させないマン
+    - redmine_solid_queue (new!)
+
+![](images/qrcode_github.com.png){:height='230'}

metadata

@@ -0,0 +1,64 @@
+--- !ruby/object:Gem::Specification
+name: rabbit-slide-nishidayuya-2025-07-25-redmine_japan_vol4-redmine_meets_solid_queue
+version: !ruby/object:Gem::Version
+  version: 2025.7.25.0
+platform: ruby
+authors:
+- Yuya.Nishida.
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rabbit
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.0.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.0.2
+description: 2025-07-25に開催された[REDMINE JAPAN vol.4](https://redmine-japan.org/vol-4/time-table/#a07-3)の発表資料
+email:
+-
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rabbit"
+- README.md
+- Rakefile
+- config.yaml
+- images/async_queue_adapter.png
+- images/async_queue_adapter_all.png
+- images/qrcode_github.com.png
+- images/solid_queue_adapter.png
+- pdf/2025-07-25-redmine_japan_vol4-redmine_meets_solid_queue-redmine_meets_solid_queue.pdf
+- redmine_meets_solid_queue.md
+homepage: https://slide.rabbit-shocker.org/authors/nishidayuya/2025-07-25-redmine_japan_vol4-redmine_meets_solid_queue/
+licenses:
+- CC-BY-4.0
+metadata: {}
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: 'Redmine × Solid Queue: 安心簡単キュー構成'
+test_files: []