Ruby on Rails の環境構築 for Windows10 ～ RubyMine + WSL

17483 ワード
WSL Rails Windows10 RubyMine WindowsSubsystemForLinux Rails テキストリンク

はじめに

Windows10 における Ruby on Rails 開発環境の構築記事です。

RubyMine + WSL で環境構築する際、様々な記事を参考にさせていただいたのですが、
RubyMine の設定や日本語化、またアプリケーションの作成とブラウザでの確認方法まで
全てまとまっている記事ってなかったなぁと思い、記事作成に至りました。

参考になれば幸いです。

目次

ツールの紹介

WSL とは

正式名称は「Windows Subsystem for Linux」。
Windows10 で Linux プログラムを利用可能にするアプリケーションです。

詳しく知りたい方はぜひ調べてみてください（当記事最下部にも参考文献を掲載していますので、ぜひ御覧ください）。

注意

WSL は、『Windows10 Fall Creators Update』以降のバージョンでのみ利用することが可能です。
「Fall Creators Update」とは、2017年秋（Fall)に Windows10 向けに提供開始された大型アップデートです。
このアップデートを導入していないと、WSL を利用することが出来ません。

Fall Creator Update の適応状態（Windows10 のバージョン）確認方法

  1. Windowsキーを押し、設定ボタンを押下する
  2. 《システム》を押下する
  3. 《バージョン情報》を押下する
  4. 「Windows の仕様」の「バージョン」項目の数値を確認：1709以上であればOK



※アップデートの方法（Fall Creator Update の適応方法）に関しては、申し訳ございませんが本記事では触れません。
　次の記事を参考にしてみてください。
　Windows 10 Fall Creators Updateの手順を確認してみた

RubyMine とは

JetBrains が提供している基本有償のIDE（統合開発環境）です。
色々と調べてみましたが、Ruby開発のIDEの中で最も評価が高いように思います。

公式ページ

初めの一ヶ月は無償試用出来ます。
またオープンソース開発ならば無料での利用申請が可能です。

WSL の準備

WSL の有効化

コントロールパネルから操作します。


WSL のインストール

Microsoft Store からインストールします。


WSL の起動

ターミナルが起動します。
初回起動時にはユーザ名とパスワードの設定を求められますので、入力してください。

各種パッケージのアップデートおよびインストール

初期設定

初期設定
# パッケージ情報の更新
sudo apt update
# パッケージの更新
sudo apt upgrade

# 各種開発ツールパッケージのインストール
sudo apt install -y build-essential
sudo apt-get install -y libssl-dev libreadline-dev zlib1g-dev libsqlite3-dev

rbenv

まずは、Ruby の複数バージョン管理を簡単にしてくれる rbenv を導入します。

rbenvの導入
#gitからインストール（clone）する
git clone https://github.com/sstephenson/rbenv.git ~/.rbenv
git clone https://github.com/sstephenson/ruby-build.git ~/.rbenv/plugins/ruby-build

#環境設定：PATHに設定する
echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bash_profile
#環境設定：.bash_profile に追加
echo 'eval "$(rbenv init -)"' >> ~/.bash_profile

#環境設定を反映する
source ~/.bash_profile
rbenv導入確認
rbenv --version
# → rbenv のバージョンが表示されればOK

Ruby

rbenv を利用して Ruby をインストールします。

Ruby導入
# インストールできるものリストを表示
rbenv install --list
# バージョンを指定してインストール（最新の安定版とかを選べばいいと思う）
rbenv install 2.5.1
# 確認
rbenv versions
# 利用するバージョンの設定
rbenv global 2.5.1

WSL 側の準備は以上です。

RubyMine の準備

RubyMine のインストール

JetBrainsの公式ダウンロードページ

ダウンロードしたインストーラを実行してください。

※インストールには結構時間がかかります。

初回起動時の設定

※各種設定の選択は Skip することも可能です。


※ライセンスを購入する場合は「Buy RubyMine」を、すでにアカウントを持っている場合は「Activate」を選択してください。

この後、MaterialThemaなどをインストールした場合には追加の設定画面が表示されます。
設定を終えると、以下の画面が表示されます。

WSL（リモート）の Ruby を読み込ませる

RubyMine の設定から、WSL にインストール済みの Ruby を指定します。

以下の手順で設定を行います。

③のパス確認方法

  1. WSL 上で which ruby と入力する

  2. WSL 上で ruby -v と入力する

  3. which rubyで出力されたパスのうち、【shims】という文字列を【versions/？？/bin】に置き換える

  4. 【versions/？？/bin】の？？を、ruby -vで出力されたルビーのバージョン（上記の例だと 2.5.1 ）で置き換える

↓↓↓

結果：/root/.rbenv/versions/2.5.1/bin/ruby

最後に「OK」ボタンを押して設定を終了すれば、完了。

日本語化

RubyMine はデフォルトでは全て英語表記です。
日本語化したい場合には、以下の手順で日本語化プラグインのセットアップを行います。

Pleiades - 日本語化プラグイン

ダウンロードされたZIPを解凍して、中の【Setup.exe】を実行してください。

フォルダ参照のダイアログが表示されるので、RubyMineの実行ファイル（rubymine64.exe）を選択してください。
※私の環境では、デフォルトのインストールで【C:\Program Files\JetBrains\RubyMine 2018.2\bin】に配置されていました。

以上でセットアップは終了です。
RubyMine を起動し、次のように日本語化されていれば正常にセットアップが完了しています。

プロジェクトの作成および実行

WSL 側からプロジェクトを作成し、実行します。
ブラウザでの確認はローカル側で可能です。

プロジェクトの作成（2018/8/5 更新）

※更新内容：
　Ubuntuからコマンドを打ち込んでプロジェクト作成する方式を削除し、RubyMineから作成する方式に変更。

RubyMineを起動し、新規プロジェクトを作成します。

以上で新規のプロジェクトが作成されます。

プロジェクトの実行～ブラウザでの確認

プロジェクトの実行

RubyMine にて先程のプロジェクトを開き、以下のように選択します。

ターミナルが起動して、問題なければ完了と表示されます。

ブラウザでの確認

ブラウザのアドレス欄に、localhost:3000 と入力します。

このようにサンプルの実行結果が表示されていれば成功です。

参考文献

WSL に関して

RubyMine に関して

全般

その他