『実践Ruby on Rails 4』環境構築手順 for macOS（2017年版）

ある読者より拙著『実践Ruby on Rails 4』のChapter 2「開発環境の構築」に関して相談を受けました。書いてあるとおりに進めたけどうまく行かなかった、と。

私としては丁寧に書いたつもりだったのですが、改めて読み返してみると確かに曖昧なところがあります。それに、2年半余りの歳月が流れる間に（この本は2014年5月刊行）掲載したURLやバージョン番号が変わっていたりします。

そこで、環境構築手順を簡潔かつ明瞭にまとめ直してみようと思い立ちました。

『実践Ruby on Rails 4』はWindowsとmacOSの両方に対応していますが、これはmacOS編です。Windowsユーザーの方はWindows編をどうぞ。

準備作業

VirtualBoxのインストール

• ブラウザで https://www.virtualbox.org/wiki/Downloads を開きます。
• 「VirtualBox binaries」セクションにある「OS X hosts」リンクをクリックして .dmg ファイルをダウンロードします。
• ダウンロードしたファイルをダブルクリックしてインストールします。

Vagrantのインストール

• ブラウザで https://www.vagrantup.com/downloads.html を開きます。
• 「MAC OS X」セクションにある「Universal (32 and 64-bit)」リンクをクリックして .dmg ファイルをダウンロードします。
• ダウンロードしたファイルをダブルクリックしてインストールします。

vagrant-vbguest プラグインのインストール New

ターミナルで次のコマンドを実行してください。

vagrant plugin install vagrant-vbguest

Vagrantfileの入手と設置

ゲストOSにCentOSを採用する場合

• http://pub.oiax.jp/jissen_rails/vagrant-rails-centos6-1.0.5.zip をデスクトップにダウンロードします。
• 以下のコマンドを順に実行します。

mkdir -p ~/projects
rm -rf ~/projects/baukis
cd ~/projects
mv ~/Desktop/vagrant-rails-centos6-1.0.5.zip .
unzip vagrant-rails-centos6-1.0.5.zip
mv vagrant-rails-centos6-1.0.5 baukis
cd baukis
vagrant up

ゲストOSにUbuntuを採用する場合

• http://pub.oiax.jp/jissen_rails/vagrant-rails-trusty64-1.0.4.zip をデスクトップにダウンロードします。
• 以下のコマンドを順に実行します。

mkdir -p ~/projects
rm -rf ~/projects/baukis
cd ~/projects
mv ~/Desktop/vagrant-rails-trusty64-1.0.4.zip .
unzip vagrant-rails-trusty64-1.0.4.zip
mv vagrant-rails-trusty64-1.0.4 baukis
cd baukis
vagrant up

動作確認

• vagrant ssh コマンドでSSHでゲストOSにログインします。
• 以下のコマンドを順に実行して、Ruby、Rails、MySQL、PostgreSQLがインストールされていることを確認します。

ruby -v
rails -v
mysql --version
psql --version

• exit コマンドを入力して、ゲストOSからログアウトします。

その他の注意事項 New

ゲスト OS として CentOS を利用する場合

• 書籍の p.47 で Gemfile の末尾に記述を加える際、最初の gem 'therubyracer', platform: :ruby という行を除いてください。

MySQL を利用する場合

• 書籍の p.48 で bin/bundle コマンドを実行する前に、テキストエディタで Gemfile を開き、gem 'mysql2' を gem 'mysql2', '~> 0.3.13' に書き換え、bin/bundle update mysql2 tzinfo コマンドを実行してください。

PostgreSQL を利用する場合

• 書籍の p.48 で bin/bundle コマンドを実行する前に、テキストエディタで Gemfile を開き、gem 'rails', '4.1.0' を gem 'rails', '~> 4.1.16' に書き換え、bin/bundle update rails tzinfo コマンドを実行してください。