Debian 12にRuby on Railsをインストールする方法

Ruby on Rails（RoR）は、Rubyで書かれ、MITライセンスの下でリリースされた無料のオープンソースのWebアプリケーションフレームワークです。Railsは、エンタープライズグレードのアプリケーションを簡単に構築するためのフルスタックWebフレームワークです。Railsには、開発者がフロントエンドとバックエンドのアプリケーションを簡単に作成できるさまざまなツールが付属しています。Ruby on Railsには、SQLインジェクション、XSS、CSRFなどの一般的な攻撃からの保護など、組み込みのセキュリティ機能もあります。

Ruby on Railsは、データベース、HTMLテンプレートのレンダリング、Webサービス、Webページのためのデフォルトの構造を提供します。モデル-ビュー-コントローラー（MVC）アーキテクチャに従い、Don’t Repeat Yourself（DRY）、Convention over Configuration（CoC）、アクティブレコードパターンなどのよく知られたデザイン哲学を使用しています。Ruby on Railsは、迅速で使いやすく、学びやすいように設計されています。Twitch、Airbnb、Github、Soundcloudなど、Railsで開発された注目すべきサイトがあります。

このガイドでは、Debian 12サーバーにRuby on Railsをインストールする手順を説明します。PostgreSQLデータベースサーバーとRbenv Rubyバージョンマネージャーを使用してRuby on Railsをインストールします。また、Railsプロジェクトの基本構造であるスキャフォールドを作成します。

前提条件

開始する前に、以下を確認してください：

Debian 12サーバー。
sudo管理者権限を持つ非rootユーザー。

依存関係のインストール

最初のステップでは、Debianサーバーにいくつかの基本的な依存関係をインストールします。これには、Railsプロジェクトのデータベースとして使用されるPostgreSQLデータベースサーバー、Node.js、およびRailsが静的アセットをコンパイルするために使用するYarnパッケージマネージャーが含まれます。

まず、以下のapt updateコマンドを実行して、パッケージインデックスを更新およびリフレッシュします。

sudo apt update

次に、以下のapt installコマンドを使用して依存関係をインストールします。これには、PostgreSQLデータベースサーバー、libpqドライバー、Node.js、Yarn、Git、およびいくつかのシステムライブラリとツールが含まれます。

sudo apt install postgresql libpq-dev nodejs yarnpkg git zlib1g-dev build-essential libssl-dev libreadline-dev libyaml-dev libsqlite3-dev sqlite3 libxml2-dev libxslt1-dev libcurl4-openssl-dev software-properties-common libffi-dev

インストールを確認するためにyを入力します。

依存関係がインストールされたら、以下のコマンドを使用してPostgreSQLサーバーのステータスを確認します。これにより、PostgreSQLがDebianマシンで実行され、有効になっていることが確認されます。

sudo systemctl is-enabled postgresql  
sudo systemctl status postgresql

PostgreSQLが有効になっている場合は、出力に「enabled」と表示されます。PostgreSQLが実行中の場合は、出力に「active(running)」または「active(exited)」と表示されます。

checking postgresql

最後に、以下のコマンドを実行してNode.jsとYarnパッケージマネージャーを確認します。

node --version  
yarnpkg --version

この例では、Node.js 18とYarn 1.22がインストールされています。

Rbenvのインストール

パッケージ依存関係をインストールした後、次のステップはUnix系オペレーティングシステム用のRubyバージョンマネージャーであるRbenvをインストールすることです。Rbenvを使用すると、Rubyアプリケーションの環境を簡単に管理でき、システムに複数のRubyバージョンをインストールできます。

以下のコマンドを使用してユーザーにログインします。

su - user

以下のgitコマンドを使用して、rbenvソースコードとruby-buildプラグインをダウンロードします。

git clone https://github.com/rbenv/rbenv.git ~/.rbenv  
git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build

次に、以下のコマンドを実行してシェルにカスタムPATHを追加します。

echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc  
echo 'eval "$(rbenv init -)"' >> ~/.bashrc  
echo 'export PATH="$HOME/.rbenv/plugins/ruby-build/bin:$PATH"' >> ~/.bashrc

変更を適用するために~/.bashrc構成を再読み込みします。コマンドを実行した後、rbenvインストールが有効になります。

source ~/.bashrc

以下のrbenvコマンドを実行してrbenvを確認します。rbenvのインストールが成功していれば、利用可能なrbenvコマンド/オプションが表示されます。

rbenv commands

install rbenv

Rbenv経由でRubyをインストール

Rbenvがインストールされたので、システムにRubyをインストールできます。Rbenvを使用すると、現在の環境にのみRubyをインストールでき、システム全体には影響しません。Ruby 3.2.2を現在のユーザー環境にインストールします。

以下のrbenv installコマンドを実行して、Ruby 3.2.2をシステムにインストールします。

rbenv install 3.2.2

インストール中に、次のような表示がされるはずです。

install ruby via rbenv

Rubyがインストールされたら、以下のコマンドを実行してデフォルトのRubyバージョンを3.2.2に設定します。

rbenv global 3.2.2

最後に、以下のコマンドを使用してシステムのRubyバージョンを確認します。

ruby -v

すべてが正常に進めば、Ruby 3.2.2がインストールされていることが表示されます。

setup and verify ruby

Ruby on Railsのインストール

この時点で、システムは設定され、DebianマシンにRuby on Railsをインストールする準備が整いました。この例では、Ruby on Rails 7.0をインストールし、公式サイトで利用可能なRailsのバージョンのリストを確認します。

以下のgemコマンドを実行してbundlerをインストールし、その後Ruby on Rails 7.0.7.2をインストールします。

gem install bundler  
gem install rails -v 7.0.7.2

インストール中に、次のような出力が表示されるはずです。

install bundler

install rails 7.0

次に、以下のrbenvコマンドを実行して、現在の環境を再ハッシュおよびリロードします。

rbenv rehash

最後に、以下のrailsコマンドを実行してRuby on Railsがインストールされていることを確認します。

rails version  
rails -h

インストールが成功すれば、現在のRailsバージョンとrailsコマンドのヘルプページが表示されます。

checking rails

最初のRailsプロジェクトの作成

このセクションでは、Ruby on Railsで最初のプロジェクトを作成する方法を学びます。RailsプロジェクトのデフォルトデータベースとしてPostgreSQLを使用します。そのためには、以下の手順を完了する必要があります：

アプリケーション用のPostgreSQLユーザーの準備。
最初のRailsプロジェクトの作成。

データベースユーザーの準備

まず、Railsアプリケーションで使用する新しいPostgreSQLユーザーを作成する必要があります。このユーザーは、データベースとユーザーを作成する権限を持っている必要があります。

ユーザーアカウントに戻り、以下のコマンドを使用してPostgreSQLサーバーにログインします。

sudo su  
sudo -u postgres psql

次に、パスワードp4sswordbobで新しいユーザーbobを作成します。その後、ユーザーbobにデータベースとロールを作成するための新しい権限を付与します。

CREATE USER bob WITH PASSWORD 'p4sswordbob';  
ALTER USER bob CREATEDB CREATEROLE;

create postgresql role

以下のコマンドを使用して、PostgreSQLサーバー上のユーザーと権限のリストを確認します。

du

ユーザーbobがCREATEDBおよびCREATEROLEの権限を持っていることが表示されます。

list users

\qを入力してPostgreSQLサーバーからログアウトします。

最後に、ユーザーにログインし、以下のpsqlコマンドを実行して新しいユーザーbobとしてPostgreSQLサーバーにログインします。

su - user  
psql -U bob -h 127.0.0.1 -d postgres

PostgreSQLサーバーに接続したら、以下のクエリを実行して接続情報を確認します。

\conninfo

ユーザーbobとしてPostgreSQLサーバーに接続していることが表示されます。

check connections

\qを入力してPostgreSQLサーバーを終了します。

Railsプロジェクトの作成

PostgreSQLユーザーを作成した後、railsコマンドラインユーティリティを使用して新しいRailsプロジェクトを作成できます。

新しいRailsプロジェクトを作成するには、以下のrailsコマンドを実行します。この例では、デフォルトデータベースPostgreSQLを使用して新しいプロジェクトtestappを作成します。

rails new testapp -d postgresql

コマンドの出力は次のようになります。

create rails project

プロジェクトが作成されると、新しいディレクトリ~/testappも作成されます。~/testappディレクトリに移動し、好みのテキストエディタを使用してデータベース設定config/database.ymlを開きます。

cd testapp/  
nano config/database.yml

開発、テスト、および本番のデフォルトデータベース設定を変更します。PostgreSQLのユーザー名とパスワードを入力してください。

development:  
  <<: *default  
  database: testapp_development  
  
  # 指定されたデータベースロールはpostgresに接続するために使用されています。  
  # postgresで追加のロールを作成するには、$ createuser --helpを参照してください。  
  # 空白のままにすると、postgresはデフォルトのロールを使用します。  
  # これはRailsを実行しているオペレーティングシステムユーザーと同じ名前です。  
  username: bob  
  
  # postgresロール（ユーザー名）に関連付けられたパスワード。  
  password: p4sswordbob  
  
  # TCPソケットで接続します。デフォルトでは、クライアントは構成を必要としないドメインソケットを使用します。Windowsにはドメインソケットがないため、これらの行のコメントを解除します。  
  host: localhost  
  
  # サーバーがリッスンするTCPポート。デフォルトは5432です。  
  # サーバーが異なるポート番号で実行されている場合は、適宜変更してください。  
  port: 5432

完了したら、ファイルを保存して終了します。

次に、以下のrailsコマンドを実行してデータベースをマイグレーションします。これにより、testappプロジェクトの新しいデータベースが自動的に作成されます。

rails db:setup  
rails db:migrate

以下に、testappプロジェクトのデータベースマイグレーション中の出力が表示されます。

migrate the database

データベースがマイグレーションされた後、以下のrailsコマンドを実行してtestappプロジェクトを実行します。これにより、IPアドレスのポート3000でtestappが実行されます。

rails server -b 192.168.10.15

次の出力に、testappが実行中であることが表示されます。

running rails

お気に入りのWebブラウザを起動し、サーバーのIPアドレスにポート3000を追加してアクセスします。たとえば、http://192.168.10.15:3000/です。インストールが成功していれば、Ruby on Railsのデフォルトのindex.htmlページが表示されます。

rails index

Ctrl+cを押してRailsアプリケーションを終了します。

スターターキットのためのRailsスキャフォールディング

スキャフォールドは、コントローラー、モデル、ビューを含むRailsプロジェクトの基本構造を自動的に生成する方法です。

以下のrailsコマンドを実行して、3つのフィールドtitle、author、publication_yearを持つスキャフォールドbooksを作成します。

rails g scaffold books title:string author:string publication_year:integer

generate scaffold

次に、以下のrailsコマンドを実行してデータベースをマイグレーションし、変更を適用します。

rails db:migrate

migrate the database

次に、以下のrails serverコマンドを実行してRailsプロジェクトを実行します。

rails server -b 192.168.10.15

run raikls project

testappが実行中になったら、URLパス/booksを介してbooksスキャフォールドを確認します。たとえば、http://192.168.10.15:3000/booksです。すべてが正常に進めば、次のように生成されたスキャフォールドが表示されます。

scaffold rails

新しいデータをbooksスキャフォールドに挿入できます。次のように表示されます。

scaffoled input data

結論

結論として、Debian 12サーバーにPostgreSQLデータベースサーバーとRbenvを使用してRuby on Railsのインストールを完了しました。また、Railsプロジェクトの基本構造のためのスキャフォールドを生成する方法も学びました。