基本

Ruby on Railsのインストールとプロジェクト作成

Ruby on Railsは、Webアプリケーションを効率的に開発するためのフレームワークです。この記事では、Ruby on Railsの開発環境をセットアップし、最初のプロジェクトを作成するまでの手順を解説します。Railsを使えば、データベース連携やルーティング、テンプレートエンジンなどが最初から用意されているため、短期間でWebアプリケーションを構築できます。

前提条件

Railsを使用するには、まずRubyがインストールされている必要があります。ターミナルで以下のコマンドを実行して、Rubyがインストールされているか確認しましょう。

ターミナル
ruby -v

バージョン番号が表示されればRubyはインストール済みです。表示されない場合は、Ruby公式サイトからインストールしてください。

ポイント

Railsを快適に使うには、Ruby 3.0以上を推奨します。古いバージョンでは一部のgemが対応していない場合があります。

MSYS2のインストール(Windows環境の場合)

Windows環境でRailsを使用する場合、ネイティブ拡張のコンパイルに必要なMSYS2をインストールします。MSYS2公式サイトからインストーラーをダウンロードし、実行してください。

インストール完了後、Windowsのスタートメニューで「MSYS2」と検索し、「MSYS2 MSYS」を管理者として実行します。

基本的な使い方

MSYS2が起動したら、まずパッケージデータベースを最新の状態に更新します。

ターミナル
pacman -Syu

更新が完了したら、Railsの依存ライブラリであるlibyamlをインストールします。

ターミナル
pacman -S mingw-w64-ucrt-x86_64-libyaml

libyamlはYAMLファイルの解析に使用されるライブラリで、Railsの設定ファイル(database.ymlなど)の読み込みに必要です。インストールが完了したらMSYS2を閉じてかまいません。

RubyGemsとBundlerのアップデート

次に、Rubyのパッケージ管理ツールであるRubyGemsと、gem依存関係を管理するBundlerを最新版にアップデートします。コマンドプロンプトを管理者として実行し、以下のコマンドを順に実行してください。

ターミナル
gem update --system
gem install bundler

RubyGemsはRubyライブラリ(gem)のインストールや管理を行うツールで、BundlerはプロジェクトごとにGemfileに記載されたgemを一括管理するツールです。Railsプロジェクトでは必須のツールなので、必ずインストールしておきましょう。

Railsのインストール

RubyGemsが準備できたら、いよいよRailsをインストールします。

ターミナル
gem install rails

インストールが完了したら、バージョンを確認しましょう。

ターミナル
rails -v

バージョン番号が表示されればインストール成功です。

プロジェクトの作成

Railsプロジェクトを作成するには、ターミナルでプロジェクトを置きたいディレクトリに移動し、rails newコマンドを実行します。

ターミナル
rails new myapp

このコマンドにより、myappというディレクトリが作成され、Railsアプリケーションに必要なファイルやフォルダが自動生成されます。また、Gemfileに記載されたgemも自動的にインストールされます。

ポイント

エラーが発生した場合は、以下のコマンドを実行してから再度プロジェクトを作成してみてください。

ターミナル
gem install psych --platform=ruby -- --with-libyaml-dir=C:/msys64/mingw64

データベースにPostgreSQLを使いたい場合は、オプションを指定できます。

ターミナル
rails new myapp --database=postgresql

サーバーの起動

プロジェクトのディレクトリに移動し、開発サーバーを起動します。

ターミナル
cd myapp
rails server

サーバーが起動したら、ブラウザでhttp://127.0.0.1:3000にアクセスしてください。Railsのウェルカムページが表示されれば、環境構築は完了です。

ポイント

rails serverrails sと省略して実行することもできます。サーバーを停止するにはCtrl + Cを押してください。

注意

ポート3000が既に使用されている場合は、rails server -p 3001のように別のポート番号を指定してください。

まとめ

  • Ruby on Railsを使うにはRubyのインストールが前提条件
  • Windows環境ではMSYS2のセットアップが必要
  • gem install railsでRailsをインストール
  • rails new プロジェクト名で新規プロジェクトを作成
  • rails server(またはrails s)で開発サーバーを起動
  • ブラウザでhttp://127.0.0.1:3000にアクセスして動作確認