概要
ApacheにPhusion Passengerを組み込む手順についての記事です。
はじめに
Railsを動かすためのWebサーバーを構築する場合、WebサーバーにNginxを採用すれば、アプリケーションサーバーにはUnicornが使われることが多いようです。Apacheを採用した場合は、ApacheにPhusion Passengerという拡張モジュールを組み込むことで、アプリケーションサーバーを立てることなく、ApacheだけでRailsを動作させることができるようになります。
RailsとApacheの組み合わせのであれば、Phusion Passengerが用いられることが多いようです。
拡張モジュールの組込みは、Apacheのコンフィグファイルに LoadModule という、モジュールを読み込むためのディレクティブを記述することで、Apacheをコンパイルすることなく実現することができます。
環境
Apache2.4.41
Ubuntu20.4 + Vagrant
インストール
Phusion PassengerはRubyのGemとして提供されています。Phusion Passengerをインストールする場合、gem install passengerをしてインストールすることができますが、RailsでWebアプリを構築する場合は、Gemfileに次の１行を追加して、bundle installすることになります。
gem 'passenger'
Phusion Passengerをインストールした後、次は、ApacheにPhusion Passengerを組み込みます。
$passenger-install-apache2-modules
Gemfileにgemを組み込んでインストールした場合、インストールしたgemのパスが切れていないため、上記のコマンドを入力しても「そのようなコマンドは存在しません」といったエラーが表示されます。そのため、パスを指定してコマンドを実行する必要があります。コマンドが存在する場所については、次のコマンドで検索して見つける必要があります。
$sudo find / -name "passenger-install-apache*"
/home/vagrant/.rbenv/versions/2.6.0/lib/ruby/gems/2.6.0/gems/passenger-6.0.18/bin/passenger-install-apache2-module
/home/vagrant/.rbenv/versions/2.6.0/bin/passenger-install-apache2-module
検索したところ、コマンドが存在するパスが２ヶ所見つかりました。恐らく、どちらを指定しても同じはずです。
$cd /home/vagrant/.rbenv/versions/2.6.0/bin/
$./passenger-install-apache2-module
コマンドを実行すると、次のようなウィザードが表示されるため、Enterで進めます。
This installer will guide you through the entire installation process. It
shouldn't take more than 3 minutes in total.
Here's what you can expect from the installation process:
1. The Apache 2 module will be installed for you.
2. You'll learn how to configure Apache.
3. You'll learn how to deploy a Ruby on Rails application.
Don't worry if anything goes wrong. This installer will advise you on how to
solve any problems.
Press Enter to continue, or Ctrl-C to abort.
Rubyが選択されていることを確認してEnterを押します。
Which languages are you interested in?
Use <space> to select.
If the menu doesn't display correctly, press '!'
‣ ⬢ Ruby
⬡ Python
⬢ Node.js
⬡ Meteor
「SSLを利用するのであれば、別途、追加のライブラリをインストールしてください」というメッセージです。SSLは使わなくてもインストールする必要があります。この時点ではPassengerのモジュールの組込みは完了していません。
Installation instructions for required software
* To install Curl development headers with SSL support:
Please run apt-get install libcurl4-openssl-dev or libcurl4-gnutls-dev, whichever you prefer.
If the aforementioned instructions didn't solve your problem, then please take
a look at our documentation for troubleshooting tips:
https://www.phusionpassenger.com/library/install/apache/
https://www.phusionpassenger.com/library/admin/apache/troubleshooting/
SSLのライブラリをAPTでインストールします。
$apt-get install libcurl4-openssl-dev
再度、仕切り直しをします。インストール作業は、環境にもよりますが５分程度かかりました。
$cd /home/vagrant/.rbenv/versions/2.6.0/bin/
$./passenger-install-apache2-module
次のメッセージが表示されれば、モジュールの組み込みは完了です。「Apacheのコンフィグファイルに、下記のメッセージを追加してください」といったメッセージです。
Almost there!
Please edit your Apache configuration file, and add these lines:
LoadModule passenger_module /home/vagrant/.rbenv/versions/2.6.0/lib/ruby/gems/2.6.0/gems/passenger-6.0.18/buildout/apache2/mod_passenger.so
<IfModule mod_passenger.c>
PassengerRoot /home/vagrant/.rbenv/versions/2.6.0/lib/ruby/gems/2.6.0/gems/passenger-6.0.18
PassengerDefaultRuby /home/vagrant/.rbenv/versions/2.6.0/bin/ruby
</IfModule>
After you restart Apache, you are ready to deploy any number of web
applications on Apache, with a minimum amount of configuration!
Press ENTER when you are done editing.
Validating installation...
* Checking whether this Passenger install is in PATH... ✓
* Checking whether there are no other Passenger installations... ✓
* Checking whether Apache is installed... ✓
* Checking whether the Passenger module is correctly configured in Apache... (!)
You did not specify 'LoadModule passenger_module' in any of your Apache
configuration files. Please paste the configuration snippet that this
installer printed earlier, into one of your Apache configuration files, such
as /etc/apache2/apache2.conf.
Detected 0 error(s), 1 warning(s).
Press ENTER to continue.
Deploying a web application
To learn how to deploy a web app on Passenger, please follow the deployment
guide:
https://www.phusionpassenger.com/library/deploy/apache/deploy/
Enjoy Phusion Passenger, a product of Phusion® (www.phusion.nl) :-)
https://www.phusionpassenger.com
Passenger® is a registered trademark of Phusion Holding B.V.
下記のコマンドを実行して、Apache2のコンフィグファイルをエディタで開いて、Passengerのモジュールを読み込む設定をします。apache2.confはルート権限でしか書き込みができないようになっています。
$sudo vi /etc/apaceh2/apache2.conf
ViでPassengerのモジュールを読み込んむ記述を追加した画面です。
Apacheは再起動して、コンフィグファイルの変更を反映させます。
$systemctl restart apache2
備考
Passengerがインストールされているかどうかを確認するコマンドです。
$gem list passenger
Passengerをインストールした後、コンフィグに組込む行を再表示するコマンドです。
$passenger-install-apache2-module --snippet
Apacheのコンフィグファイルを編集した後、/etc/apache2配下にある各コンフィグファイルに対し、構文チェックを行うツールです。
$acpchectl -t
参考
https://www.petitmonte.com/ruby/passenger.html
https://weblabo.oscasierra.net/install-phusion-passenger-to-redhat/
DocumentRootの所有者を変更する
RailsからPassengerにアクセスする場合、ApacheのDocumentRootディテクティブで設定したディレクトリの所有者を、Railsの所有者と合わせる必要があります。
ApacheのDocumentRootディテクティブで設定するディレクトリを、mkdirコマンドで作成した場合、ディレクトリの所有者はrootになっているはずです。所有者がrootになっている状態でRailsを動かすと、Passengerはrootではなくnobodyユーザーで動かそうとします。nobodyユーザーとは、OSがデフォルト持っているユーザーで、数あるユーザーの中で一番低い権限が与えられているユーザーのことです。システム的な使われ方しかされません。nobodyユーザーには、/temp、/logへの書き込み権限がありません。そのため、permission errorになってしまい、Passengerが正常に動作しなくなります。
RailsからPassengerを動かすには、所有者をRailsを動かすユーザーに合わせる必要があります。Railsを動かすユーザーとは、Railsプロジェクトを作成したときのユーザーのことで、Railsのファイルから調べることもできます。Railsのプロジェクトがあるルートの直下にあるconfig.ruファイルの所有者が、Railsを動かすユーザーになります。
所有者の変更は次のコマンドで行います。
$chown -R user:user /var/www/html/hoge