Skip to content

Latest commit

 

History

History
724 lines (524 loc) · 31.1 KB

vagrant.md

File metadata and controls

724 lines (524 loc) · 31.1 KB

諸注意

この資料はMac OS Xユーザを対象として書かれています. その他のOSを利用している場合, 適宜読み替えをお願い致します.

Vagrant

Vagrant(ベイグラント)は, Rubyで開発されたオープンソースの仮想環境開発構築ソフトウェアです. VirtualBoxなどの仮想化ソフトウェアを利用して, マシン上で動いているOS(ホストOS)の上で仮想化マシン(Virtual Machine, VM)と呼ばれる｢仮想的なマシン｣を構築し, その上で別のOS(ゲストOS)を動かすことができます.

Vagrantを利用すれば, 例えばMac OS X上でUbuntuやCentOSを動かす事が出来ますので, プロダクトの本番環境と同じOSを使いながら開発を進めることが出来ます. また, 仮想マシンは起動も削除も数分で終わりますので, 新しいツールやミドルウェアを試したくなった時に, 仮想マシン上で試してみて, 終わったら仮想マシンごと削除することも出来ます. このように, 仮想マシンをうまく活用することが出来れば, プロダクト開発の作業効率を大幅に向上することが出来るでしょう.

ここでは, Vagrantの導入方法と使い方について説明しながら, 簡単なPerlのWebアプリケーションが動く環境を, 仮想マシン上に構築する所まで挑戦していきます.

Vagrantのインストール

もし, Homebrew Caskを導入済みであれば, 次のコマンドでインストールすることが出来ます.

$ brew cask install vagrant

Homebrew Caskを利用していないのであれば(或いはMac OS X以外のOSを利用しているのであれば), 次の手順に従ってVagrantをインストールしましょう.

  • ダウンロードしたディスクイメージをダブルクリックすると, 次のような画面が表示されます.

  • ｢Vagrant.pkg｣をダブルクリックすると, インストーラが起動します.

  • 後は, 指示に従いながら｢続ける｣ボタンを押し続けると, インストールが完了します.

VirtualBoxのインストール

続いて, Vagrantが仮想環境を構築するために利用する, VirtualBoxをインストールします. VirtualBoxは, もしHomebrew Caskを導入済みであれば, 次のコマンドでインストールすることが出来ます.

$ brew cask install virtualbox

Homebrew Caskを利用していないのであれば, 次の手順に従ってVagrantをインストールしましょう.

  • ダウンロードしたディスクイメージをダブルクリックすると, 次のような画面が表示されます.

  • 後は, Vagrantのインストール時と同じく, 指示に従いながら｢続ける｣ボタンを押し続けると, インストールが完了します.

vagrantコマンド

Vagrantのインストールが無事終わっていれば, コマンドラインからvagrantコマンドが利用できるようになっているはずです.

$ which vagrant
/usr/bin/vagrant
$ vagrant --version
Vagrant 1.8.1

...それでは, Vagrantを利用して開発環境となる仮想マシンを立ち上げていきましょう.

Boxの取得

Vagrantでは, ｢Box｣と呼ばれる仮想マシンのベースイメージ(雛形)から仮想マシンを構築します. 通常, VirtualBoxやVMwareで仮想マシンを立ち上げた場合, そこから更にOSのインストールなどを実施していく必要があります. Vagrantでは, OSや必要なアプリケーションが既に導入されているBoxから仮想マシンを構築することで, これらの導入と設定にかかる時間を節約することができます.

Vagrantが利用するBoxは, 後述するPackerなどで準備することも出来ますが, Discover Vagrant Boxesから検索し, 入手することもできます. 今回は, ここからUbuntu Server 14.04 LTSの64bit版のBoxを入手し, このボックスからローカル環境に仮想マシンを立ち上げることにします.

丁度, Discovery Vagrant Boxesのトップに該当のBoxがあったので, これをVagrantに登録します. 他のOSのBox, 例えばCentOSやDebianが導入済みのBoxが欲しければ, ページ上部の検索ボックスから検索するようにしましょう.

vagrantコマンドからは, Discovery Vagrant Boxesに登録されているBoxの名前を使って, 入手(ダウンロード)することが出来ます. Boxの名称ですが, 上記の画像の青矢印の先, リンクになっている部分のテキストが, Boxの名称になっています. 手元のBoxを追加するためのvagrant box addコマンドを使ってこのBoxを登録してみます.

$ vagrant box add ubuntu/trusty64
==> box: Loading metadata for box 'ubuntu/trusty64'
    box: URL: https://atlas.hashicorp.com/ubuntu/trusty64
==> box: Adding box 'ubuntu/trusty64' (v14.04) for provider: virtualbox
    box: Downloading: https://vagrantcloud.com/ubuntu/boxes/trusty64/versions/14.04/providers/virtualbox.box
==> box: Successfully added box 'ubuntu/trusty64' (v14.04) for 'virtualbox'!

成功しました. 既に取得済みのBoxを確認出来る, vagrant box listコマンドで確認してみます.

$ vagrant box list
ubuntu/trusty64 (virtualbox, 14.04)

練習問題

Discovery Vagrant Boxesから, CentOS 6.6のBoxを検索し, 取得してみよう.

Vagrantfileの準備

それでは, 先程取得したBoxから, 仮想マシンを構築していきます. そのために, vagrant initコマンドで｢Vagrantfile｣と呼ばれるVagrant用の設定ファイルを生成します. Vagrantは, このVagrantfileに記述された設定を元に, 仮想マシンを構築します.

$ vagrant init ubuntu/trusty64
A `Vagrantfile` has been placed in this directory. You are now
ready to `vagrant up` your first virtual environment! Please read
the comments in the Vagrantfile as well as documentation on
`vagrantup.com` for more information on using Vagrant.

この際, 上記のようにvagrant initの後にBox名を指定すると, そのBoxを利用するようなVagrantfileが生成されます.

さて, Vagrantfileの中身を確認してみます. コメント部分を除くと, 次のようになっています.

# -*- mode: ruby -*-
# vi: set ft=ruby :

Vagrant.configure(2) do |config|
  config.vm.box = "ubuntu/trusty64"
end

VagrantfileはRubyで書かれており, ここでは起動するBox(config.vm.box)に先程取得し, vagrant init時に指定した｢ubuntu/trusty64｣を代入しています. ここでは省略しますが, Vagrantfileに設定を書く事で, 様々なパターンの仮想マシンを構築することが出来ます(例えば, 仮想マシンに割り振るIPを指定したり, 一度に複数の仮想マシンを用意したりすることもできます).

これで, Vagrantで仮想マシンを立ち上げる準備が出来ました!

仮想マシンの起動

Vagrantによる仮想マシンの起動は, Vagrantfileがあるディレクトリでvagrant upすればOKです.

$ ls
Vagrantfile

$ vagrant up
Bringing machine 'default' up with 'virtualbox' provider...
==> default: Importing base box 'ubuntu/trusty64'...
==> default: Matching MAC address for NAT networking...
==> default: Checking if box 'ubuntu/trusty64' is up to date...
==> default: Setting the name of the VM: vagrant_default_1462843924383_21190
==> default: Clearing any previously set forwarded ports...
==> default: Clearing any previously set network interfaces...
==> default: Preparing network interfaces based on configuration...
    default: Adapter 1: nat
==> default: Forwarding ports...
    default: 22 (guest) => 2222 (host) (adapter 1)
==> default: Booting VM...
==> default: Waiting for machine to boot. This may take a few minutes...
    default: SSH address: 127.0.0.1:2222
    default: SSH username: vagrant
    default: SSH auth method: private key
    default:
    default: Vagrant insecure key detected. Vagrant will automatically replace
    default: this with a newly generated keypair for better security.
    default:
    default: Inserting generated public key within guest...
    default: Removing insecure key from the guest if it's present...
    default: Key inserted! Disconnecting and reconnecting using new SSH key...
==> default: Machine booted and ready!
==> default: Checking for guest additions in VM...
    default: The guest additions on this VM do not match the installed version of
    default: VirtualBox! In most cases this is fine, but in rare cases it can
    default: prevent things such as shared folders from working properly. If you see
    default: shared folder errors, please make sure the guest additions within the
    default: virtual machine match the version of VirtualBox you have installed on
    default: your host and reload your VM.
    default:
    default: Guest Additions Version: 4.3.36
    default: VirtualBox Version: 5.0
==> default: Mounting shared folders...
    default: /vagrant => /Users/takayuki.fukumoto/Dropbox/sandbox/vagrant

現在の仮想マシンの様子は, vagrant statusで確認できます.

$ vagrant status
Current machine states:

default                   running (virtualbox)

The VM is running. To stop this VM, you can run `vagrant halt` to
shut it down forcefully, or you can run `vagrant suspend` to simply
suspend the virtual machine. In either case, to restart it again,
simply run `vagrant up`.

runningになっており, 問題なく動いている事がわかります. それでは引き続き, Vagrantが用意した仮想マシンに接続してみましょう.

コラム: Vagrantfileの共有

チームで開発を進めている場合, 開発環境を構築するためのVagrantfileはリポジトリに含めておくようにしましょう. 他の開発メンバーも, そのVagrantfileを利用して, 開発環境を構築出来るようになります.

もし, リポジトリで共有したVagrantfileからvagrant upした際, Vagrantfile内で指定しているBoxが追加されていない場合, Vagrantは自動的にDiscovery Vagrant Boxesから該当するBoxを検索し, あればそのBoxを追加してから仮想マシンの構築をスタートします.

仮想マシンへの接続

Vagrantで立ち上げた仮想マシンへの接続方法はいくつかあります. ひとつは, Vagrantfileがあるディレクトリでvagrant sshと入力する方法です.

$ vagrant ssh
Welcome to Ubuntu 14.04.4 LTS (GNU/Linux 3.13.0-85-generic x86_64)

 * Documentation:  https://help.ubuntu.com/

 System information disabled due to load higher than 1.0

  Get cloud support with Ubuntu Advantage Cloud Guest:
    http://www.ubuntu.com/business/services/cloud


vagrant@vagrant-ubuntu-trusty-64:~$

この方法は, Vagrantfileがあるディレクトリでしか使えませんが, 特にそれ以外の設定をすることなく, Vagrantで立ち上げた仮想マシンに接続することができます.

もう1つは, vagrant ssh-configコマンドで生成できるSSHの設定を~/.ssh/configに追加し, SSHで接続する方法です. この方法を利用すると, 仮想マシンが起動していればVagrantfileがないディレクトリからでも, 仮想マシンに接続することができます.

$ vagrant ssh-config
Host default
  HostName 127.0.0.1
  User vagrant
  Port 2222
  UserKnownHostsFile /dev/null
  StrictHostKeyChecking no
  PasswordAuthentication no
  IdentityFile "/path/to/vagrant/.vagrant/machines/default/virtualbox/private_key"
  IdentitiesOnly yes
  LogLevel FATAL

ホスト名は, vagrant ssh-configに--hostオプションを与えることで指定できます. 今回は, ｢vagrant-tutorial｣という名前で登録することにしましょう.

$ vagrant ssh-config --host vagrant-tutorial
Host vagrant-tutorial
  HostName 127.0.0.1
  User vagrant
  Port 2222
  UserKnownHostsFile /dev/null
  StrictHostKeyChecking no
  PasswordAuthentication no
  IdentityFile "/path/to/vagrant/.vagrant/machines/default/virtualbox/private_key"
  IdentitiesOnly yes
  LogLevel FATAL

この設定を, ~/.ssh/configに追記します.

$ vagrant ssh-config --host vagrant-tutorial >> ~/.ssh/config

後は, sshコマンドでvagrant-tutorialを指定すれば, 仮想マシンに接続できます.

$ ssh vagrant-tutorial

コラム: 複数の仮想マシンの立ち上げ

Vagrantfileを上手く設定すれば, プロダクトに必要な開発環境を, 柔軟に構築することが出来ます. 例えば, 例としてアプリケーション用とデータベース用の2つの仮想マシンを立ち上げる為のVagrantfileを紹介します.

Vagrant.configure(2) do |config|
  config.vm.define :"app" do |app|
    app.vm.box      = "ubuntu/trusty64"
    app.vm.hostname = "app"
    app.vm.network :private_network, ip: "192.168.33.10"
    app.vm.provider "virtualbox" do |vb|
      vb.name = "app"
    end
  end

  config.vm.define :"db" do |db|
    db.vm.box      = "ubuntu/trusty64"
    db.vm.hostname = "db"
    db.vm.network :private_network, ip: "192.168.33.11"
    db.vm.provider "virtualbox" do |vb|
      vb.name = "db"
    end
  end
end

このように記載すると, ｢192.168.33.10｣というIPで｢app｣という名前の仮想マシンを, ｢192.168.33.11｣というIPで｢db｣という名前の仮想マシンを構築することができます.

vagrant upした後, vagrant statusで状況を確認すると,

$ vagrant status
Current machine states:

app                       running (virtualbox)
db                        running (virtualbox)

This environment represents multiple VMs. The VMs are all listed
above with their current state. For more information about a specific
VM, run `vagrant status NAME`.

このように, ｢app｣と｢db｣の2台が同時に動いていることが確認出来ます. 同様に, vagrant ssh-configについても｢app｣と｢db｣の2台分の設定が出力されるので, これを~/.ssh/configに記述すればsshコマンドから仮想マシンにログインすることが出来るようになります.

また, Vagrant用のSSH公開鍵は/path/to/vagrantfile/.vagrant/machines/[hostname]/virtualbox/private_keyに設置されていますので, 例えば｢app｣に接続したいのであれば,

$ ssh vagrant@192.168.33.10 -i /path/to/vagrantfile/.vagrant/machines/app/virtualbox/private_key
Welcome to Ubuntu 14.04.4 LTS (GNU/Linux 3.13.0-85-generic x86_64)

 * Documentation:  https://help.ubuntu.com/

 System information disabled due to load higher than 1.0

  Get cloud support with Ubuntu Advantage Cloud Guest:
    http://www.ubuntu.com/business/services/cloud


vagrant@app:~$

このように直接利用する鍵を指定することで, sshコマンドで接続することもできます.

その他, Vagrantfileで設定できる項目については, 公式ドキュメント(日本語版)に記載があります.

仮想マシンの停止

では次に, 立ち上げた仮想マシンを停止してみましょう. 仮想マシンは, 動いている限りマシンのリソースを使い続けます. そのため, 使わない仮想マシンは極力停止しておく事が望まれます.

なお, 仮想マシンに保存したデータは, 仮想マシンそのものを削除しない限り残り続けます. 今回は, 適当なファイルを保存してから仮想マシンを停止することで, 本当にデータが消えないかを確認してみましょう.

vagrant@vagrant-ubuntu-trusty-64:~$ touch data.txt
vagrant@vagrant-ubuntu-trusty-64:~$ ls
data.txt

仮想マシンの中で, touchコマンドで適当なファイルを生成します. 仮想マシンからローカルに戻る場合は, 仮想マシンの中でexitなどを実行すればよいです.

vagrant@vagrant-ubuntu-trusty-64:~$ exit
logout
Connection to 127.0.0.1 closed.

exitは仮想マシンから切断するだけなので, vagrant statusで確認すると, まだ仮想マシンは動き続けています.

$ vagrant status
Current machine states:

default                   running (virtualbox)

The VM is running. To stop this VM, you can run `vagrant halt` to
shut it down forcefully, or you can run `vagrant suspend` to simply
suspend the virtual machine. In either case, to restart it again,
simply run `vagrant up`.

それでは, vagrant haltで仮想マシンを停止してみましょう.

$ vagrant halt
==> default: Attempting graceful shutdown of VM...

vagrant statusで状況を確認してみます.

$ vagrant status
Current machine states:

default                   poweroff (virtualbox)

The VM is powered off. To restart the VM, simply run `vagrant up`

｢poweroff｣になっていますね. 実際, vagrant sshで再度接続しようとしても, 仮想マシンが停止しているので接続出来ません.

$ vagrant ssh
VM must be running to open SSH connection. Run `vagrant up`
to start the virtual machine.

停止した仮想マシンは, vagrant upで再度起動できます.

$ vagrant up
Bringing machine 'default' up with 'virtualbox' provider...
==> default: Checking if box 'ubuntu/trusty64' is up to date...
==> default: Clearing any previously set forwarded ports...
==> default: Clearing any previously set network interfaces...
==> default: Preparing network interfaces based on configuration...
    default: Adapter 1: nat

    ... 中略 ...

==> default: Checking for guest additions in VM...
==> default: Mounting shared folders...
    default: /vagrant => /path/to/vagrantfile
==> default: Machine already provisioned. Run `vagrant provision` or use the `--provision`
==> default: to force provisioning. Provisioners marked to run always will still run.

再度仮想マシンに接続してから, lsコマンドで先程作成したdata.txtというファイルがあるか確認してみましょう.

$ vagrant ssh-config

    ... 中略 ...

vagrant@vagrant-ubuntu-trusty-64:~$ ls
data.txt

先程作成したdata.txtが残っていますね!

仮想マシンの削除

それでは最後に, 仮想マシンを削除しましょう. 停止している仮想マシンは, メモリやCPUなどのリソースは消費しませんが, ディスク容量は消費し続けます. 使わなくなった仮想マシンは, 適度なタイミングで整理し, 削除するようにしましょう.

仮想マシンは, vagrant destroyコマンドで削除することができます.

$ vagrant destroy
    default: Are you sure you want to destroy the 'default' VM? [y/N] y
==> default: Forcing shutdown of VM...
==> default: Destroying VM and associated drives...

仮想マシンを停止していない状態で削除したので, ｢Forcing shutdown｣ということで, 強制的に仮想マシンを停止してから仮想マシンを削除しています.

$ vagrant status
Current machine states:

default                   not created (virtualbox)

The environment has not yet been created. Run `vagrant up` to
create the environment. If a machine is not created, only the
default provider will be shown. So if a provider is not listed,
then the machine is not created for that environment.

vagrant statusで確認すると, Vagrantfileはあるが仮想マシンがないということで, ｢not created｣になっています.

ここから, 再度vagrant upすれば仮想マシンを作成することができます. ただ, 当然ではありますが, 新しい仮想マシンを立ち上げたのと同じ状態ですので, 削除前の仮想マシンで作ったdata.txtは残っていません.

コラム: vagrantディレクトリの共有

vagrant up時に, このような出力が出ているはずです.

==> default: Mounting shared folders...
    default: /vagrant => /path/to/vagrantfile

これは, ローカル環境のVagrantfileがあるディレクトリを, 仮想マシンの/vagrantにマウントしている, ということを指します.

vagrant@app:/vagrant$ cd /vagrant/
vagrant@app:/vagrant$ ls
Vagrantfile

このように, Vagrantを動かしているローカル環境のファイルを, /vagrantディレクトリを通して仮想マシン側でも利用することができます.

プロダクトのルートディレクトリにVagrantfileを設置してvagrant upをすれば, プロダクトのコードが全て/vagrantディレクトリにマウントされるので, 別途GitHubやBitBucketからプロダクトのコードを取得する必要がなくなり, 非常に便利です.

練習問題

次に示す手順に従って, 適当なAmon2アプリケーションを, NginxとSupervisorを利用してVagrant上で動かせるように, 環境構築をしてみましょう.

アプリケーションの用意

amon2-setup.plで適当なAmon2アプリケーションを用意します.

$ cpanm Amon2 Amon2::Lite
$ amon2-setup.pl SampleApp --flavor=Lite
$ ls
SampleApp

Amon2のLite flavorにはcpanfileが用意されていないので, 別途用意します.

$ vi SampleApp/cpanfile
+ requires 'Amon2';
+ requires 'Amon2::Lite';
+ requires 'Starlet';

Vagrantfileの用意と仮想マシンの起動

今回は, 予めいくつか設定しておきたい項目があるので, vagrant initではなく手動でVagrantfileを生成します.

$ vi Vagrantfile
+ Vagrant.configure(2) do |config|
+   config.vm.box = "ubuntu/trusty64"
+
+   config.vm.provider "virtualbox" do |v|
+     v.customize [
+       "modifyvm", :id,
+       "--memory", 1024,
+     ]
+   end
+
+   config.vm.network :private_network, ip: "192.168.30.10"
+ end

config.vm.provider以下の部分で, 仮想マシンにメモリを1024MB割り当てるよう設定しています. また, config.vm.networkでは, この仮想マシンに192.168.30.10というIPを割り振るように設定しています.

$ vagrant up

問題なく起動出来れば, カレントディレクトリが仮想マシンの/vagrantにマウントされているはずなので, 先程生成したSampleAppディレクトリも仮想マシンから参照出来るようになっています.

$ vagrant ssh
vagrant@vagrant-ubuntu-trusty-64:~$ ls /vagrant
SampleApp  Vagrantfile

Perlのインストール

xbuildを使って仮想マシンにPerlをインストールします. まず, apt-getでgitをインストールしてから, xbuildのリポジトリを/tmp/xbuildにcloneします.

vagrant@vagrant-ubuntu-trusty-64:~$ sudo apt-get install git
vagrant@vagrant-ubuntu-trusty-64:~$ git clone https://github.com/tagomoris/xbuild.git /tmp/xbuild

続いて, xbuildでPerl 5.20.1を/opt/perl-5.20にインストールします(この際, 同時にパッケージ管理モジュールのApp::cpanminusとCartonもインストールしてくれます). 少し時間がかかるので, 気長に待ちましょう.

vagrant@vagrant-ubuntu-trusty-64:~$ sudo /tmp/xbuild/perl-install 5.20.1 /opt/perl-5.20
Start to build perl 5.20.1 ...
perl 5.20.1 (and cpanm/carton) successfully installed on /opt/perl-5.20
To use this perl, do 'export PATH=/opt/perl-5.20/bin:$PATH'.

続いて, 先程インストールしたCartonを利用して, SampleAppの起動に必要なモジュールをインストールしておきます. この作業には, Perlのビルド以上に時間がかかります(手元の環境では15分近くかかりました). こちらも気長に待ちましょう.

vagrant@vagrant-ubuntu-trusty-64:~$ cd /vagrant/SampleApp
vagrant@vagrant-ubuntu-trusty-64:/vagrant/SampleApp# PATH=/opt/perl-5.20/bin:$PATH carton install
Installing modules using /vagrant/SampleApp/cpanfile
Successfully installed File-ShareDir-Install-0.10
Successfully installed Class-Inspector-1.28
Successfully installed File-ShareDir-1.102
    ... 中略 ...
Successfully installed Data-Section-Simple-0.07
Successfully installed Amon2-Lite-0.13
71 distributions installed
Complete! Modules were installed into /vagrant/SampleApp/local

さて, これ以降は基本的に管理者権限で作業していきます. そのため, sudo su -を利用して, vagrantユーザからrootユーザに昇格しておきます.

vagrant@vagrant-ubuntu-trusty-64:~$ sudo su -
root@vagrant-ubuntu-trusty-64:~#

コラム: スーパーユーザと管理者権限

OSには, 管理者が利用する｢スーパーユーザ｣と呼ばれるアカウントがあります. ｢スーパーユーザ｣はOSの持つ全ての権限を持っており, 例えばファイルパーミッションを無視してファイルを操作したり, 1024番以下のポートを操作したりといった作業が可能です(このような権限を, ｢管理者権限｣と呼びます).

例えば, 先程apt-getコマンドを利用してGitをインストールする際, apt-getの前にsudoを付けていました. これは, apt-getでパッケージをインストールする場合に管理者権限が必要になるので, sudoを利用して一時的に現在のvagrantユーザを管理者権限に昇格しているのです.

直前の操作ではsudo su -を利用してrootユーザになっていましたが, このようにsuコマンドを利用することによってユーザアカウントを切り替え, 永続的に管理者権限(を持つrootアカウント)になることが出来ます. suは｢スイッチユーザ｣のコマンドで, 任意のユーザアカウントに切り替えることが可能ですが, ユーザを指定しない場合は管理者権限(rootユーザ)に切り替わることになります.

前述の通り, 管理者権限は｢何でも出来てしまう｣ので, オペミスをしてしまった際の影響が大きいです. 基本的に管理者権限を持たないアカウントで操作を行い, 必要に応じてsudoで管理者権限に一時的に昇格する, という運用が理想的だと思います.

なお, 管理者権限を持たないアカウントから管理者権限に昇格する際, 場合によってはrootユーザのパスワードの入力が求められる場合があります. また, アカウントによっては管理者権限への昇格が認められない場合もあります.

Nginxのインストール

apt-getを利用して, Nginxを導入します. SampleAppディレクトリ内のアプリケーションはPSGIサーバのStarletで立ち上げるので, nginxはそのリバースプロキシとして利用します.

root@vagrant-ubuntu-trusty-64:~# apt-get install nginx

Nginx用の設定ファイルを用意します.

root@vagrant-ubuntu-trusty-64:~# vi /etc/nginx/conf.d/app.conf
+ server {
+     listen      80;
+
+     location / {
+         proxy_pass http://127.0.0.1:5000;
+     }
+ }

また, /etc/nginx/nginx.confのinclude /etc/nginx/sites-enabled/*;の部分を, #でコメントアウトします.

root@vagrant-ubuntu-trusty-64:~# vi /etc/nginx/nginx.conf

      include /etc/nginx/conf.d/*.conf;
-     include /etc/nginx/sites-enabled/*;
+     #include /etc/nginx/sites-enabled/*;
  }

Supervisorのインストール

続いて, apt-getでプロセス管理ツールのSupervisorを導入します.

root@vagrant-ubuntu-trusty-64:~# apt-get install supervisor

Supervisor用の設定ファイルを用意します.

root@vagrant-ubuntu-trusty-64:~# vi /etc/supervisor/conf.d/app.conf
+ [program:app]
+ command=bash -lc '/opt/perl-5.20/bin/carton exec -- start_server --port 5000 -- plackup app.psgi -E production -s Starlet'
+ numprocs=1
+ autostart=true
+ autorestart=true
+ startsecs=1
+ user=root
+ redirect_stderr=true
+ stdout_logfile=/var/log/app.log
+ stdout_logfile_maxbytes=0
+ stdout_logfile_backups=0
+ environment=home="/root",user="root"
+ directory=/vagrant/SampleApp

アプリケーションの起動

serviceコマンドで, NginxとSupervisorを再起動します.

root@vagrant-ubuntu-trusty-64:~# service nginx restart
root@vagrant-ubuntu-trusty-64:~# service supervisor restart

動作確認

手元のブラウザから, 192.168.30.10にアクセスしてみましょう.

ここまで問題なく進めることができていれば, このような画面が表示されるはずです! これにてアプリケーションの環境構築は終了です. お疲れ様でした!

トラブルシューティング

もし正常に動作していない場合, その問題の原因になりそう理由の1つは, NginxやSupervisorの設定関連でしょう.

こういう場合は, 闇雲に原因を探すのではなく, まずログなどの情報から原因を探るのが大切です. Nginxのログは/var/log/nginx/access.log及び/var/log/nginx/error.log, Supervisorのログは/var/log/supervisor/supervisord.logにあるので, エラーが起きていないか確認してみましょう.

また, アプリケーションのログは/var/log/app.logに設置されています. ｢アプリケーションが起動しているが, エラーが出ている｣という場合には, ここを見てみましょう.

コラム: Vagrantのplugin

Vagrantには, プラグインシステムが用意されています. プラグインを利用することで, Vagrantを更に便利に使う事が出来るようになります.

ここでは詳しく紹介しませんが, saharaや, VirtualBoxを利用している際に利用可能なvagrant-vbox-snapshotを利用すれば, 仮想マシンの任意の時点のスナップショットを保存し, いつでもロールバック(スナップショットを保存した時点の状態に戻る)することができます.

スナップショットの保存とロールバックを使いこなせば, 先程挑戦したような環境構築を行う際, トライアンドエラーを繰り返しやすくなるので, 非常に取り組みやすくなります.