Rails7.1からRails7.2へのアップグレード
今回はRails7.1
のプロジェクトをRails7.2
へアップグレードする手順を説明します。
プロジェクトの構成はこちらの記事と同じく、PostgreSQL
, ESBuild
, Tailwind CSS
, Docker Compose
を利用しています。
バージョンアップはRailsガイドのRailsアップグレードガイドを参考に行なっていきます。
現状のバージョン
アップグレード前のRails
のバージョンは7.1.3.4
となっています。
$ docker compose run --rm web rails -v
Rails 7.1.3.4
Gemfileに記載のバージョンを変更
Gemfile
のRailsのバージョンを以下のように変更します。
gem "rails", "~> 7.2.1"
変更後、Rails
のアップデートコマンドを実行します。
$ docker compose run --rm web bundle update rails
実行後、Rails
のバージョンが上がっているか確認します。
$ docker compose run --rm web rails -v
Rails 7.2.1
7.2
以上に上がっていれば完了です。
アップデートタスクの実行
Rails
で提供されているapp:update
を実行します。
$ docker compose run --rm web rails app:update
config/application.rb
がコンフリクトしていて上書きされるか聞かれたのでY
で上書きをします。
$ docker compose run --rm web rails app:update
identical config/boot.rb
exist config
conflict config/application.rb
Overwrite /myapp/config/application.rb? (enter "h" for help) [Ynaqdhm] Y
その他のファイルも同様に聞かれるので全てY
として進みます。
完了後、config/application.rb
の差分を確認するとconfig.time_zone = "Tokyo"
が削除されたのみだったので元に戻しておきます。
デフォルト設定の変更
app:update
の実行によってconfig/initializers/new_framework_defaults_7_2.rb
というファイルが作成されています。
このファイルにはRails7.2
での新しいデフォルト設定の一覧が記載されており、ファイル内のコメントを解除して、1つずつ段階的に反映するといったことができます。
今回は特に段階的にせず、全て反映させるため、このファイルを削除し、config/application.rb
のload_defaults
の値を更新します。
require_relative "boot"
require "rails"
# Pick the frameworks you want:
require "active_model/railtie"
require "active_job/railtie"
require "active_record/railtie"
require "active_storage/engine"
require "action_controller/railtie"
require "action_mailer/railtie"
require "action_mailbox/engine"
require "action_text/engine"
require "action_view/railtie"
require "action_cable/engine"
# require "rails/test_unit/railtie"
# Require the gems listed in Gemfile, including any gems
# you've limited to :test, :development, or :production.
Bundler.require(*Rails.groups)
module AtsApp
class Application < Rails::Application
# Initialize configuration defaults for originally generated Rails version.
config.load_defaults 7.2 # 更新
# Please, add to the `ignore` list any other `lib` subdirectories that do
# not contain `.rb` files, or that should not be reloaded or eager loaded.
# Common ones are `templates`, `generators`, or `middleware`, for example.
config.autoload_lib(ignore: %w[assets tasks])
# Configuration for the application, engines, and railties goes here.
#
# These settings can be overridden in specific environments using the files
# in config/environments, which are processed later.
#
# config.time_zone = "Central Time (US & Canada)"
# config.eager_load_paths << Rails.root.join("extras")
# Don't generate system test files.
config.generators.system_tests = nil
config.time_zone = "Tokyo"
end
end
ここまでで正しく動作するか確認してみます。
新たにmigration
ファイルが作成されているのでmigrate
実行後、Railsアプリケーションを立ち上げます。
$ docker compose run --rm web rails db:migrate
$ docker compose up
問題なく立ち上がればアップグレードは完了です。
今回は環境構築のみ行なっているプロジェクトなのですぐに完了しましたが、実際に運用しているプロジェクトなどではテストが通り既存の機能に影響がないかなど確認しながらアップグレード作業を行う必要があります。