solid-queue-setup_skill

Overview

This skill configures Solid Queue as the Active Job backend for Rails 8 apps and guides background job setup, testing, and migration from Sidekiq. It provides installation steps, configuration examples, job patterns (retries, priorities, recurring jobs), and monitoring tips. Use it to get a robust, database-backed job system running with minimal external dependencies.

How this skill works

The skill installs and configures the solid_queue gem, creates the required database tables, and sets Solid Queue as Rails' active_job adapter. It generates a solid_queue.yml for dispatcher/worker tuning, shows how to create jobs with retries and priorities, and demonstrates enqueueing, recurring schedules, and how to run workers locally or in production. It also covers test helpers and Mission Control integration for observability.

When to use it

• Setting up background processing in a new Rails 8 app
• Creating jobs with retries, priorities, or custom error handling
• Configuring worker threads/processes and queue routing
• Migrating existing Sidekiq jobs to Solid Queue
• Adding recurring jobs and scheduling without Redis

Best practices

• Keep solid_queue.yml under source control and tune threads/processes per environment
• Use queue_as and explicit queue names for predictable routing
• Retry only on recoverable errors and use discard_on for not-found records
• Write RSpec job specs using ActiveJob::TestHelper and perform_enqueued_jobs for integration checks
• Monitor with Mission Control and periodically prune old completed jobs

Example use cases

• SendWelcomeEmailJob.perform_later(user.id) to enqueue user emails without Redis
• Define ProcessPaymentJob with retry_on to handle transient payment gateway failures
• Run bin/rails solid_queue:start in a worker process or via Procfile for production
• Create recurring tasks in config/recurring.yml for daily reports or cleanup jobs
• Migrate Sidekiq calls: replace perform_async with perform_later and sidekiq options with queue_as