Ruby on Rails
Railsを始める

1. Ruby 1.8.2がインストールされているかを確認

Railsは最新版のRubyを必要としますので、試みを続ける前にRuby 1.8.2をダウンロードしてください。Rails v0.10とそれ以降のバージョンはRuby 1.8.2を必要とします。

CentOS RailsOnCentOSを参照してください。
Debian RailsOnDebianを参照してください。
Gentoo emerge railsか、the Gentoo Wiki entryを参照してください。
Fedora Core RailsOnFedoraを参照してください。Rubyをソースからインストールできない場合は、rubyの対話型シェルであるirbがインストールされているか確認してください。( yum install irb )とするのがよいでしょう。そうでなければ、ブレークポイントが正しく機能していません。
Fedora Core 3 Rails on Spike?も利用することができます。これは、SpikeSource.が作成した統合LAMPスタック + Ruby on Railsです。
Redhat 9 Ruby and Rails on Red Hat Linux 9を参照してください。(おそらくFast CGI and Apache2 for Red Hat Linux 9も).
FreeBSD RailsOnFreeBSDを参照してください。
OpenBSD RailsOnOpenBSDを参照してください。
OSX RailsOnOsxを参照してください。インストーラDarwinPortsを利用することができます。
Windows RailsOnWindowsを参照してください。

Rubyのインストール後、必ず‘ruby -v’を実行して、バージョンをチェックしてください。特に、多くのOS Xユーザは、AppleがバンドルしたRuby 1.6がインストールした1.8を隠す、ということでつまずきます。Pathの設定を参照してください。

2. Ruby on Railsの取得

Ruby Gemsを利用してRuby on Railsを取得するには、GemRailsを参照してください。

gem update
gem install rails 

(これはしばらく時間がかかるので、我慢してください。)

3. Rails アプリケーションの作成

準備ができたら、Railsは始めるのに必要なすべてのディレクトリを作成し、そのうえいくつかのパーミッションをセットします。すべてやり終えたら、すなわちがRailsがインストールされたら、アプリケーションを作成したい任意の場所(Webサーバがアクセスできるディレクトリでない方が良い)railsコマンドを打ってください:

rails /usr/myapp
ln -s /usr/myapp/public /var/www/myapp

その次のステップで、publicディレクトリをこの新しいアプリケーションディレクトリの中に配置します。

4. Rubyの適切なパスの利用 (she-bang行!)

※訳注:スクリプトの先頭に書かれるスクリプト実行パスの宣言

Railsは/usr/local/bin/rubyにあるRubyを参照するようにあらかじめ設定されています。この場所はソースからRubyをインストールした人が通常Rubyを保持している場所です。しかし、使用しているディストリビューションのパッケージシステムを利用してRubyをインストールした場合、その場所を変更する必要があるかもしれません。public/dispatch.cgipublic/dispatch.rbpublic/dispatch.fcgiscript/breakpointerscript/consolescript/generatescript/serverの最初にある次の行を変更してください:

#!/usr/local/bin/ruby

必要なファイルを変更するためのコマンドラインスクリプトがいくつかあります。ShebangChangeScriptsを参照してください。

あるいは、何も変更しない方法についてはLinuxWindowsDevelopment (リンク切れ)を見てください。

5. Apacheがセットアップされているかを確認

Railsを実行するためにCGIファイルが実行できるようにApacheが設定されている必要があります。Apacheの設定ファイル中のどこかにAddHandler cgi-script .cgiがあるか確認してください。

  1. Railsアプリケーション用にApacheをセットアップしてください。バーチャルホストのDocumentRoot(もしかしたらWebサイト全体)でアプリケーションを動かすことを計画している場合、以下の“Example for Apache conf”を参照してください。別の場所で動かしたい場合は、
    HowToSetTheBaseURLsOfYourRailsAppsを参照してください。
  2. rails/ (またはServerName)に隠せすし、“Congratulations, you’re on Rails!”画面が表示されるかチェックしてください。
  3. “Congratulations, you’re on Rails!”画面のガイドラインに従ってください。

Apacheの設定例

与えられたApacheの設定の中の/path/applicationをtar.gzを展開したrailsディレクトリのフルパスに置き換えてください。そして、以下で示すようにpubliclogディレクトリを付け加えてください。 CGIも有効にし、以下で示すようにいくつかのアクセス資格をセットしてください。AllowOverride lineは重要です。– 内部的に、Railsはpublicフォルダに置かれた.htaccessファイルで発生するリダイレクションを使用します。(Suse 9.1のApacheは相当厳しくロックダウンされています。)

Railsはmod_rewriteモジュールも必要です。

LoadModule rewrite_module modules/mod_rewrite.so
LoadModule env_module modules/mod_env.so

<VirtualHost *:80>
   SetEnv RAILS_ENV development
   ServerName rails
   DocumentRoot /path/application/public/
   ErrorLog /path/application/log/apache.log

   <Directory /path/application/public/>
      Options ExecCGI FollowSymLinks
      AddHandler cgi-script .cgi
      AllowOverride all
      Order allow,deny
      Allow from all
   </Directory>
</VirtualHost>

6. 手がかりのためのログのチェック

RailsはApacheからのエラーをlog/apache.logに、Rubyコードからのエラーをlog/development.logに、それぞれ報告します。もし、問題があればこれらのログに書かれていることを見てみましょう。

UnixとMac OS Xでは、別の端末でtail -f log/development.logを実行して、アプリケーションの実行をモニタできるでしょう。

7. チュートリアル

上記のチュートリアルをつかって、行われていることの基本的な考え方が理解できたら、オープンソースプロジェクトのセクションを見ることをお勧めします。あなたが他の人のソースから学ぶのが一番良いタイプのなら特にお勧めします。

8. リアルタイム・ヘルプの取得

基本的な実行に問題がありますか? IRCの#rubyonrailsにいるRailersに質問してみましょう (IRC|IRCの参加方法)。
この良いサイトの管理者に感謝します。


翻訳: