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バージョンを切り替える方法と、その際の注意点について解説しました。

関連記事:

お気軽にご相談ください

お見積りへ お問い合わせへ
▲