2026年9月29日
2026年9月29日
VPSにrbenvでRubyのバージョンを管理する方法
はじめに
本記事では、VPS上でrbenvを使用してRubyのバージョンを効率的に管理する方法について説明します。rbenvは、個々のプロジェクトに対して異なるRubyバージョンをインストールし、切り替えることができる便利なツールです。これにより、複数のウェブアプリケーションをVPS上で同時運転することが可能となります。
症状・背景
このテーマが必要になる主な場面:
- 1つのVPS上で異なるプロジェクト間で互換性のないRubyバージョンを使用する必要がある場合
- 複数のウェブアプリケーションをVPS上で運営し、それぞれに異なるRubyバージョンが必要とする場合
- Ruby環境を迅速かつ簡単に行き来できるようにしたい場合
手順・設定方法
ステップ1: rbenvとruby-buildのインストール
# rbenvとruby-buildをインストールします。
sudo apt-get update
sudo apt-get install -y curl git
git clone https://github.com/rbenv/rbenv.git ~/.rbenv
echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc
echo 'eval "$(rbenv init -)"' >> ~/.bashrc
exec $SHELL
# ruby-buildをインストールします。
git clone https://github.com/rbenv/ruby-build.git $(~/.rbenv/plugins/ruby-build)
ステップ2: Rubyのバージョン管理と設定
# 公開鍵認証でSSH接続するための設定
ssh-keygen -t rsa -b 4096 -C "your_email@example.com"
cat ~/.ssh/id_rsa.pub | ssh user@vps 'mkdir -p .ssh && cat >> .ssh/authorized_keys'
# バージョンをインストールします。
rbenv install 2.7.5
rbenv global 2.7.5
# インストールしたRubyバージョンの確認
ruby -v
ステップ3: rbenv用にNginxとPassengerの設定
# Passengerをインストールします。
gem install passenger
# NginxとPassengerをセットアップします。
passenger-install-nginx-module
sudo cp /path/to/nginx/passenger.conf /etc/nginx/conf.d/
ステップ4: 実践/トラブルシュート/監視
# rbenvのインストール済みRubyバージョンを一覧表示します。
rbenv versions
# プロジェクトディレクトリ内での Ruby バージョン切り替え
cd /path/to/rails/project
rbenv local 2.7.5
bundle install
注意事項
- SSH接続の認証鍵は適切な管理が必要です。
- インストールしたRubyバージョンがプロジェクトに適しているか確認してください。
- Nginxの設定ファイルを修正する際は、セキュリティ上の考慮が必要です。
まとめ
1. rbenvとruby-buildのインストール: VPS上で複数のRuby環境を効率的に管理するために必要なツールをインストールします。
2. Rubyバージョンの設定: 必要なRubyバージョンをインストールし、グローバルに設定します。
3. NginxとPassengerのセットアップ: Passengerをインストールし、Nginxで使用する設定ファイルを作成します。
4. 実践/トラブルシュート: 実際のプロジェクトでRubyバージョンを切り替える方法と、その際の注意点について解説しました。
関連記事: