SecondBrain/99 System/Archive/Rails 8 Migration Guide (finreport-analyzer).md

status, type, tags, created, updated, aliases

status	type	tags	created	updated	aliases
seed	concept		2025-12-17	2026-05-31

Rails 8 Migration Guide (finreport-analyzer)

Дата: 31.05.2026

Основные изменения

1. Rails 8 Upgrade:

   • Обновлен Gemfile до gem "rails", "~> 8.0.0".
   • Запущен rails app:update.
   • Добавлен config/initializers/new_framework_defaults_8_0.rb.

2. Solid Queue (Замена Sidekiq):

   • Удален sidekiq, добавлен solid_queue.
   • Удален Redis (больше не требуется для фоновых задач).
   • Выполнены миграции: bin/rails generate solid_queue:install && bin/rails db:migrate.
   • Перенесены джобы: app/sidekiq/ -> app/jobs/.
   • Обновлен ActiveJob адаптер на :solid_queue.

3. Solid Cable (Замена Redis для Action Cable):

   • Добавлен solid_cable.
   • Выполнены миграции для таблиц Solid Cable.

4. Propshaft (Замена Sprockets):

   • Удален sprockets-rails, добавлен propshaft.
   • Удалены app/assets/config/manifest.js и config/initializers/assets.rb.
   • Assets теперь управляются проще, без лишних манифестов.

5. Deployment (Capistrano + Supervisor):

   • Обновлены конфиги Capistrano для работы с Rails 8.
   • Переход с capistrano-rvm на capistrano-rbenv (согласно текущему сетапу сервера).
   • Добавлены systemd-шаблоны в config/systemd/ для Puma и Solid Queue.
   • На сервере процессы управляются через Supervisor.

Команды для проверки

bundle exec rails db:migrate
bundle exec rails assets:precompile
bundle exec rails jobs:start # для локального запуска Solid Queue

Нюансы

• connection_pool зафиксирован на < 3.0 для совместимости с Ruby 3.3.0.
• puma-daemon удален, так как современные Rails/Puma лучше работают под управлением супервизоров (systemd/supervisor).