Valkey/Redis 互換性テスト用ミニアプリ

Sidekiq と 2種類のクライアント（redis gem / redis-client）で、Valkey と Redis の互換性を検証する最小構成の Rails アプリです。

前提

• Ruby 3.4.4 / Rails 7.1
• REDIS_URL（未指定時は redis://127.0.0.1:6379/0）

セットアップ

bundle install

実行

別ターミナルでサーバを起動:

# Redis または Valkey のどちらかを起動
# 例: Redis (Docker)
docker run -p 6379:6379 redis:7.0.7
# 例: Valkey (Docker)
docker run -p 6379:6379 valkey/valkey:8.1

# Sidekiq を起動
bundle exec sidekiq -r ./config/environment -C config/sidekiq.yml

テスト

単発（任意のバックエンド）

REDIS_URL=redis://127.0.0.1:6379/0 bundle exec rspec --format documentation

一度で Redis と Valkey の両方を検証（Docker が必要）

bin/test_backends

• spec/redis_client_compat_spec.rb … redis-client による基本操作
• spec/sidekiq_compat_spec.rb … Sidekiq のジョブ実行と DeadSet 移行

GitHub Actions

.github/workflows/ci.yml で Redis/Valkey のマトリクスを利用し、両方に対してテストを実行します。