Vagrant を開発用 Web サーバとして利用するときの注意点

2015/03/25

この記事は書かれてから1年以上が経過しており、最新の情報とは異なる可能性があります

罠があるのでまとめておきます。（体験談）なお、box ファイルは CentOS6 ベースのもの、Web サーバは apache です。（本番環境を想定した開発環境なので、nginx は別のところで使っています）

レシピを適用しても上手く表示されない

レシピ適用した後で、 vagrant up や vagrant reload などで VM を起動したとしても、Web サーバがうまく動かなかったケースとかありませんでしたか？私はありました。

/var/www を synced folder に指定しているとはまります。

なんともならなかったので、毎回 ssh でログインして sudo service httpd restart してごまかしてましたが、なんだかはまる人多そうだなーと思ったのでこちらにまとめておきます。

Vagrant の動作順おさらい

レシピの指定を Vagrantfile に書いているケース、knife コマンドを使うケースのいずれにおいても、 vagrant up --provision もしくは vagrant provision 時に以下のような順序で動作します。（ログ見れば分かりますが）

box ファイルの設定、仮想マシンの電源ON（ブート処理）
Vagrant が使う SSH のポートフォワーディング周りの設定
synced folder の設定
（Vagrantfile 内に記述があれば）レシピの適用

なお、古いバージョンの Vagrant では、vagrant up とするだけで up した後に vagrant provision を実行した時の処理が毎回走っていましたが、最近のやつは vagrant up するだけでは Vagrantfile 内に書かれたレシピは適用されなくなりました。（こちらが通常だと思います）

なぜ synced folder を Web サーバのドキュメントルートにしてしまった場合にうまく動かないかというと、 1.の段階で Web サービスが起動してしまい（chkconfig など）、3.で行われるはずの synced folder の設定がこの段階では行われておらず、/var/www が無いために Web サービスがうまく動かない、といったことが起きています。

この動作順はどうしようもないので、別の方法を考えなくてはいけません。

Upstart の仕組みを利用する

Upstart というワードをよくご存知の方は、なんとなく予想がつくかと思いますが、システム起動時に特定のイベントが起きた際、予め指定されたジョブを実行するという仕組みがあります。

Linux は起動時に色々なサービスを立ち上げていますが、 /etc/init 以下に設定ファイルを設置することで、それらを行っています。

今回は、/etc/init/httpd.conf というファイルを作成し、以下のような内容を記述します。

# start apache on vagrant mounted
start on vagrant-mounted
exec sudo service httpd start

この2行目の vagrant-mounted というのが、先ほどの Vagrant の動作順の 3. である synced folder の設定に相当するので、こちらのマウントが行われたら、sudo service httpd start を行う設定です。ちなみに、/var/www が無い状態では httpd は起動してないので、restart ではなく start で問題無いようです。

こうすることで、1.の段階で Web サービスの起動に失敗したとしても、3.の直後に Upstart の仕組みによって Web サービスが起動するので、手動で Web サービスの起動などをしなくとも良くなりますね。

Upstart に関してはこちらに詳細あります。