【Rails6対応】Railsアプリのデプロイ方法

はじめに

Railsアプリのデプロイ方法はこちらの手順を参考にさせてもらっています。しかし上記手順では一部、Rails6に対応していない部分があるため、ここで差分としてまとめたいと思います。
基本的に上記手順に沿って進めていき、手順を変更したほうがいい章についてはここに記載されている差分の手順で進めていくことを想定しています。
章立ても上記手順に則っているためここでは飛び飛びになっていますがご了承ください。

1 Conohaの契約

OSは「CentOS 7.7」を選択。
※「CentOS 8.0」など最新のイメージを選択すると、インストールされているコマンドの差異により思わぬエラーが出るため。

2-6 秘密鍵をローカルのsshに登録

ローカルのSSH設定ファイル名が間違っている。こちらの記事を参照。

3-6 Rubyのインストール

Rubyのインストールが完了しても標準出力が戻ってこない?
VPS接続が自動切断された時点でインストールが完了しているため、標準出力が戻ってこないからといって待ち続ける必要はない。

3-7 bundleのインストール

bundleのインストールだけではデプロイ時に以下のエラーが出力される。

SSHKit::Command::Failed: bundle exit status: 1
bundle stdout: Nothing written
bundle stderr: /home/user/.rbenv/versions/2.6.3/lib/ruby/2.6.0/rubygems.rb:283:in `find_spec_for_exe': Could not find 'bundler' (2.0.2) required by your /var/www/app/releases/20200103015156/Gemfile.lock. (Gem::GemNotFoundException)
To update to the latest version installed on your system, run `bundle update --bundler`.
To install the missing version, run `gem install bundler:2.0.2`

bundlerのインストールもここで行っておく。

# rbenv exec gem install bundler

bundleとbundlerの違いをご存知の方がいらっしゃましたら教えて下さい…

4 node.jsのインストール

上記手順でインストールしたnode.jsではバージョンが古いというエラーが出力される。

error shallow-clone@3.0.1: The engine "node" is incompatible with this module. Expected version ">=8". Got "6.17.1"
error Found incompatible module.

そのため、以下のコマンドでnode.jsのインストールを行う。

# curl -sL https://rpm.nodesource.com/setup_11.x | bash -
# yum -y install nodejs

既にnode.jsをインストールしてしまっている場合は以下のコマンドでアンインストールを行う。

# yum -y remove nodejs

また、デプロイ時に以下のエラーが出力されます。

Caused by:
SSHKit::Command::Failed: bundle exit status: 5
Gem::Ext::BuildError: ERROR: Failed to build gem native extension.

...

compiling ./libsass/src/utf8_string.cpp
make: g++: コマンドが見つかりませんでした
make: *** [utf8_string.o] エラー 127

これはRails6から追加されたWebpackerの依存パッケージであるsassc内でg++コマンド(C++のコンパイラコマンド)が実行できないというエラーです。
以下のコマンドでg++コマンドをインストールします。

$ sudo yum -y install gcc-c++

5-4 time-zoneを設定

上記手順でタイムゾーンを設定すると、MySQLコンソールにログインしようとしたところで以下のエラーが出力される。

$ mysql -u root -p
mysql: unknown variable 'default-time-zone=Asia/Tokyo'

タイムゾーンの設定は以下の通り行う。

symbolic-links=0                   # 既存の行

default-time-zone = 'Asia/Tokyo'   # ここに挿入

log-error=/var/log/mysqld.log      # 既存の行

6 Nginxの設定

Nginxの設定はこちらの記事を参照。

7 Githubの公開鍵登録

設定についてはこちらの記事も参照。

2-4 productionの環境設定

config/deploy.rbのシンボリック設定を以下のように変更する。

# シンボリックリンクをはるファイル
set :linked_files, fetch(:linked_files, []).push('config/secrets.yml')

↓

# シンボリックリンクをはるファイル
set :linked_files, fetch(:linked_files, []).push('config/master.key')

2-5 環境変数の設定(サーバー側)

secrets.ymlの代わりにmaster.keyを作成する。

まとめ

上記手順を合わせてこの差分を行うことでエラーなくデプロイができるはずです。一発でデプロイ完了してみたいですね。

関連記事

【Rails】Paranoiaを使用した論理削除(ソフトデリート)
# はじめに Paranoiaは、Railsアプリケーションで論理削除(ソフトデリート)を実現するためのGemです。 論理削除は、データベースのレコードを物理的に削除するのではなく、削除フラグを設定することで「削除済み」とみなす方法です。こ [...]
2024年7月20日 21:33
【Rails】activerecord-multi-tenantを使用したマルチテナントアプリケーションの作成
# はじめに マルチテナントアプリケーションでは、複数の顧客(テナント)が同じアプリケーションを利用するため、データの分離が必要です。 activerecord-multi-tenantは、このようなマルチテナント環境をサポートするための便 [...]
2024年7月18日 16:50
【Rails】RubyとRailsにおけるattr_reader, attr_writer, attr_accessorの概念と使用方法
# はじめに RubyとRailsの開発において、`attr_reader`,`attr_writer`,`attr_accessor`は非常に便利なメソッドです。これらは、クラス内でインスタンス変数に対するゲッターおよびセッターメソッドを簡単に [...]
2024年7月17日 18:11
【Rails】RubyとRailsにおけるyieldの概念と使用方法
# はじめに RubyとRailsにおける`yield`は、メソッドやテンプレートの中で動的にコードブロックを実行する能力を提供し、これによってコードの再利用性と拡張性が大幅に向上します。本記事では、RubyとRailsにおける`yield`の概 [...]
2024年7月17日 13:15
【Rails】AASMを使用してオブジェクトの状態遷移を効率的に管理
# はじめに Railsアプリケーションにおいて、オブジェクトの状態管理は重要な課題の一つです。AASM (Acts As State Machine) gemは、複雑な状態遷移を効率的に管理します。本記事では、AASMの基本的な使い方を解説して [...]
2024年7月16日 18:00
【Rails】RSpec + Swagger + rswagでアプリケーションのAPIをテストおよびドキュメント化する方法
# はじめに Railsアプリケーションの開発において、APIのテストとドキュメント化は重要な要素です。 RSpecはテストフレームワークとして広く利用されており、SwaggerはAPIの設計とドキュメント化を支援します。これらを統合するr [...]
2024年7月16日 14:27
【Rails】mailcatcherを使用して開発環境でメール送信をテストする方法
# はじめに mailcatcherは、開発環境でのメール送信をキャプチャするためのツールです。ローカルで送信されたメールをブラウザ上で簡単に確認できるようにします。mailcatcherをRailsアプリケーションで使用する方法について説明しま [...]
2024年7月15日 16:37
【Rails】impressionistを使用してページビューやクリック数を追跡する方法
# はじめに impressionist Gemを使用してRailsアプリケーションでページビューやクリック数を追跡する方法について説明します。 # 実装方法 ## impressionist Gemのインストール まず、impre [...]
2024年7月15日 14:18