vagrant-awsを日本で一番詳しく解説

こんにちは。ランチコンダクターです。

先日、第8回若手Webエンジニア交流会 #wakatewebにて「vagrant-awsにプルリしたらマージされた話」をさせていただきました。

wakateweb vagrant aws from Yuma Iwasaki

今回は、vagrant-awsの具体的な使い方をまとめてみます。

vagrant-awsとは

通常、VagrantはVirtualBoxのコントローラーとして使われていると思いますが、バージョン1.1からプラグインを使用することにより、様々な仮想化技術に対応した仮想マシンのコントローラーとなりました。
vagrant-awsは、VagrantでAWSを操作することができるようになるプラグインです。図で表すと以下のような感じになります。

AWSにて準備事項

事前準備としてAWS側での準備が必要なのですが、ここでは省略します。
とりあえず、以下を行っておけば最低限は大丈夫だと思います。

access_key_idをメモっておく
secret_access_keyをメモっておく
keypairを作成し、名前をメモっておく
指定するsecurity_group名をメモっておく
sshのprivate_keyのダウンロードを行い、保持

aws.access_key_id：AWSから取得したアクセスキーに変更、もしくは環境変数に設定※1
aws.secret_access_key：AWSから取得したシークレットアクセスキーに変更、もしくは環境変数に設定※1
aws.keypair_name：AWSにて作成したキーペア名に変更※1
aws.instance_type：任意のインスタンスに変更（試すだけならt1.microで問題無し）※1
aws.region：任意のリージョンを指定※1
aws.availability_zone：任意のアベイラビリティゾーンを指定※1
aws.ami：任意のAMIを指定※1
aws.security_groups：AWSにて作成したセキュリティグループを指定※1
aws.tags：タグを指定（タグに意味はありません）
aws.block_device_mapping：マッピングを行うデバイスを指定（EBSなど）
aws.subnet_id：VPCを使用する場合は指定
aws.private_id_address：VPCを使用する場合は指定
aws.elastic_ip：固定IPが必要な時に指定
override.ssh.username：OS毎に指定※1
override.ssh.private_key_path：プライベートKeyを配置しているローカルのPathを指定※1

※1：必須

実行

以下にて起動、破棄が行えます。

# EC2インスタンスの起動
$ vagrant up --provider=aws
# EC2インスタンスの破棄
$ vagrant destroy

vagrant実行時にデバッグログの出力を行う方法

以下のように、VAGRANT_LOG=debugをとすることにより、ログが多く出力されるので、問題が起こった際の解決がしやすくなります。

# vagrant up時にデバッグログを出力
$ VAGRANT_LOG=debug vagrant up
# vagrant destroy時にデバッグログを出力
$ VAGRANT_LOG=debug vagrant destroy

vagrant-awsをソースから実行するための手順

ソースを取得

$ git clone https://github.com/mitchellh/vagrant-aws
$ cd vagrant-aws

Gemfileを以下のように変更

source "https://rubygems.org"

gemspec

group :development do
  # We depend on Vagrant for development, but we don't add it as a
  # gem dependency because we expect to be installed within the
  # Vagrant environment itself using `vagrant plugin`.
  gem "vagrant", :git =&gt; "git://github.com/mitchellh/vagrant.git"
end

group :plugins do
  gem "vagrant-aws", path: "."
end

Gemのインストール

$ bundle
$ bundle exec rake

あとは先ほどのVagrantfileを配置し、「bundle exec vagrant up --provider=aws」を行えばec2インスタンスが起動されます。

# 起動
$ bundle exec vagrant up --provider=aws
# ターミネート
$ bundle exec vagrant destroy

ソースコードから実行した時のコマンド一覧（bundle execつけただけ）

# 起動
$ bundle exec vagrant up --provider=aws
# 終了
$ bundle exec vagrant destroy
# rsync（ローカルからEC2への一方通行のため、注意）
$ bundle exec vagrant rsync
# provision（rsyncしてからShellやChef等を実行）
$ bundle exec vagrant provision
# 再起動
$ bundle exec vagrant reload
# 停止
$ bundle exec vagrant halt

vagrant-awsのAWSの操作はfogを使用しています。fogだけを使いたいときもvagrant-awsのコードはかなり参考になるとおもいます。
ちなみにvagrant-google（Google Compute Engineを操作）というプラグインもあります。vagrant-googleもfogを使用しているのでコードベースはかなり似ています（作者が同じなので当然ですが）。

Tips

AWSのインスタンスIDを取得

# ※vagrant-awsにてvagrant up後
$ cat .vagrant/machines/default/aws/id
i-4ed31657

vagrant-awsを使う時にあると便利なプラグイン

vagrant-ami

このプラグインを使用することにより、vagrant-awsで作成したインスタンスのami化ができるようになります。

# インストール
$ vagrant plugin install vagrant-ami

# インスタンスをAMI化
$ vagrant create-ami --name my-ami-name --desc "My AMI" --tags role=test,environment=dev

最後に

Infrastructure as CodeとAWSを使ったImmutable Infrastructureを実現するためには、
AWSのインスタンス起動 → Chef or Puppet or Ansibleを実行 → serverspecにてテストというフローを繰り返し実行していくことになりますが、このフローを自作するのはそれなりの手間がかかります。
vagrant-awsや、その他のvagrant プラグインを組み合わせると、このフローをVagrantfileで管理でき、かつ簡単に自動化できます。
また、インターフェイスが同じなので、Vagrantさえ知っていれば学習コストをある程度抑えられるのも導入コストを抑えられるので良いですね。
機能の便利さの割に使われていないのが勿体無いと思っているので、皆さん、どんどん使いましょう！