ファーストビュー画像
ヘッダーロゴ
ホームアイコン
>
>
Rails7.1からRails7.2へのアップグレード
バックエンド

Rails7.1からRails7.2へのアップグレード

作成日2024/09/21
更新日2024/09/21
アイキャッチ
# Ruby on Rails

今回は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.rbload_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

問題なく立ち上がればアップグレードは完了です。

今回は環境構築のみ行なっているプロジェクトなのですぐに完了しましたが、実際に運用しているプロジェクトなどではテストが通り既存の機能に影響がないかなど確認しながらアップグレード作業を行う必要があります。

参考
https://railsguides.jp/upgrading_ruby_on_rails.html

share on
xアイコンfacebookアイコンlineアイコン