Ruby on Rails環境構築の諸確認【公式ドキュメントリンク集まとめ】

1. エラーメッセージを確認する

インストール時にターミナルやコマンドプロンプトに表示されるエラーメッセージを確認します。
エラーメッセージの最下部に問題の原因やヒントが書かれていることが多いです。

例：ERROR: Error installing rails:
ERROR: Failed to build gem native extension.

このようなメッセージが出た場合、関連するライブラリや依存関係が不足している可能性があります。

2. RubyとGemのバージョン確認

RailsはRubyやRubygemsのバージョンと互換性があるため、以下のコマンドでバージョンを確認してください。

対応バージョンの確認：
Railsの公式ドキュメントで、インストールしようとしているRailsのバージョンに必要なRubyのバージョンを確認します。

https://railsdoc.com/　（参考）

3. Railsのインストールコマンドを再実行

以下のコマンドを使ってRailsをインストールします。

バージョンを指定する場合：
gem install rails -v '6.1.4' # Rails 6.1.4をインストール

エラーメッセージが再度表示される場合、次の手順に進みます。

4. 必要な依存関係の確認

Railsのインストール時には、システムにいくつかの依存パッケージが必要です。
OSごとに必要なパッケージが異なるので、以下を参考にインストールしてください。

Macの場合

Homebrewを使用して必要なパッケージをインストールします。

Linux (Ubuntu) の場合

Windowsの場合

Windowsでは、WSL (Windows Subsystem for Linux) の導入が推奨されます。
RubyInstallerを使う場合、Devkit（開発ツールキット）を一緒にインストールします。

5. Gemの更新

Gemが古い場合、依存関係の解決でエラーが発生することがあります。
次のコマンドで更新します。：gem update --system

（以下入出力例）
C:\Users\user\techgym_rails\techgym_rails_course01>gem update –system
Updating rubygems-update
ERROR: Error installing rubygems-update:
rubygems-update-3.5.23 requires Ruby version >= 3.0.0. The current ruby version is 2.6.3.62.
Installing RubyGems 3.2.3
Successfully built RubyGem
Name: bundler
Version: 2.2.3
File: bundler-2.2.3.gem
Bundler 2.2.3 installed
RubyGems 3.2.3 installed
Regenerating binstubs
Regenerating plugins
Parsing documentation for rubygems-3.2.3

このエラーメッセージは、gem update --systemコマンドを実行した際にRubyのバージョンが古いため、最新のrubygems-updateがインストールできなかったことを意味しています。

（エラーメッセージの解説）

1. rubygems-update-3.5.23 requires Ruby version >= 3.0.0
   • 最新のrubygems-update（バージョン3.5.23）をインストールしようとしましたが、Ruby 3.0.0以上が必要です。
   • 現在使用しているRubyのバージョンは2.6.3のため、条件を満たしていません。
2. Installing RubyGems 3.2.3
   • Rubyのバージョンが古いため、システムはrubygems-updateの代わりに、互換性のあるRubyGems 3.2.3をインストールしました。
3. Successfully built RubyGem
   • RubyGems 3.2.3のインストールが正常に完了しました。
4. Bundler 2.2.3 installed
   • Bundlerもバージョン2.2.3にインストール・更新されています。
5. Parsing documentation for rubygems-3.2.3
   • RubyGems 3.2.3に関するドキュメントを生成しています。

意味のまとめ

• あなたのRubyバージョン（2.6.3）は古いため、最新のRubyGems（3.5.23）がインストールできませんでした。
• 代わりに互換性のあるバージョン（RubyGems 3.2.3）がインストールされました。
• Bundler（2.2.3）も正常にインストールされました。

6. Bundlerの確認

Railsプロジェクトではbundlerが必要です。
次のコマンドで確認・インストールします。：gem install bundler

7. ネイティブ拡張のエラー対応

エラーメッセージに「Failed to build gem native extension.」と表示された場合、ネイティブ拡張をビルドするためのツールが不足しています。

• Mac/Linux: Xcodeやbuild-essentialをインストール
  # Mac
xcode-select --install# Linux
  sudo apt install -y build-essential
• Windows: Devkitのインストールを確認します。

8. インストール後の動作確認

Railsが正しくインストールされたか確認します。
rails -v

正しくインストールされていれば、バージョンが表示されます：

http://localhost:3000/でサーバーが起動しない問題の原因として、いくつかの可能性を確認する必要があります。以下の手順を試してみてください。

1. サーバーが正しく起動しているか確認

• サーバーを起動するためのコマンド（例：npm startやyarn start）を実行した際に、エラーメッセージが出ていないか確認してください。
• 正常に起動している場合、ターミナルに「Listening on port 3000」や「Server is running on localhost:3000」といったメッセージが表示されるはずです。

2. ポートが既に使用中か確認

• 他のプロセスがポート3000を使用している可能性があります。
• 以下のコマンドで確認できます：
  • Windows:
    netstat -ano | findstr :3000

  • Mac/Linux:
    lsof -i :3000

• ポート3000を使用しているプロセスがあれば、タスクマネージャーやkillコマンドでプロセスを終了させてください：
  • Mac/Linux:
    kill -9 [PID]

  • Windows:
    taskkill /PID [PID] /F


3. プロキシ設定の確認

• プロキシをOFFにしたとありますが、ブラウザやOSレベルのプロキシ設定を再確認してください。
• また、package.jsonにproxy設定がある場合、正しい設定になっているか確認してください。

4. ファイアウォールやセキュリティソフトの確認

• ファイアウォールやセキュリティソフトがポート3000の通信をブロックしていないか確認してください。

5. ブラウザキャッシュのクリア

• ブラウザが古い情報を保持している場合、キャッシュをクリアして再度アクセスしてください。

6. 他のポートで試す

• ポート3000が使えない場合、他のポートで起動できるか試してみてください。
• コマンド例：
  PORT=4000 npm start


  その後、http://localhost:4000/でアクセスします。

7. ログの確認

• エラーログが出力されていないか確認してください。
  • Node.jsアプリの場合、console.logやconsole.errorで出力される情報が役立つことがあります。

8. 開発サーバーの再インストール

• Node.js関連の依存関係が壊れている可能性があります。以下の手順で再インストールを試してください：
  bash

  rm -rf node_modules
npm install
npm start


1. コマンドプロンプトやターミナルを開く

• Windowsの場合：
  • スタートメニューで「cmd」と検索して「コマンドプロンプト」を開く。
  • もしくは、「Windows PowerShell」や「Windows Terminal」を使用することも可能です。
• MacまたはLinuxの場合：
  • 「ターミナル」を開きます（Spotlightで「Terminal」と検索するか、アプリケーションから選択）。

2. プロジェクトフォルダに移動する

サーバーを起動するためのプロジェクトフォルダに移動します。

• フォルダの場所が「C:\myproject」の場合（Windows）：
  cd C:\myproject

• フォルダの場所が「/Users/username/myproject」の場合（Mac/Linux）：
  cd /Users/username/myproject


3. 必要なコマンドを入力する

フォルダ内で以下のコマンドを入力します：

npmを使う場合：

yarnを使う場合：

• プロジェクトによっては別のコマンドが指定されている場合もあるため、package.jsonの"scripts"セクションを確認すると良いです。

4. サーバーが起動するか確認

• 正しく起動すれば、ターミナルにログメッセージが表示されます（例：「Server is running on port 3000」など）。
• ブラウザでhttp://localhost:3000/にアクセスして動作を確認します。

5. エラーが出る場合

• エラーメッセージをよく読み、問題を特定します。（この繰り返しです）

「マイグレーションを追加する」作業