Vagrant1.6のDocker provider

Feature Preview: Docker-Based Development Environments

Vagrant 1.6からDocker providerがサポートされた．つまり，VagrantでVMだけでなくコンテナも管理できるようになった．

この機能はネイティブでDockerをサポートしてないOSXでも使え，この場合は裏側でProxy VM（boot2docker box）が勝手に立ち上がって，その上でコンテナが立ち上がる．つまり，以下のようになる．

OSX -> (Proxy VM) -> Docker Container

OSXの場合，これは今までboot2dockerを使ってやってきたのと変わらない．ただ，Docker providerを使うと，boot2dockerの立ち上げまで面倒を見てくれる．

何が嬉しいのか

VagrantでDockerコンテナを立ち上げる利点はかなりあると思う，

  • vagrant upだけで環境を立ち上げられる
  • 同様のインターフェースでLinuxでもOSXでも動かせる
  • コンテナの立ち上げの設定をVagrantfileに書ける
  • Proxy VMの設定をVagranfileに書ける
  • Vagrantの機能（syncd folder，ネットワーク設定，vagrant ssh，provisioner，vagrant share）が使える
  • プラグインが書ける

これはそのままVagrantの利点だけど，それをDockerコンテナに持ち込めるのがよい．つまり，Vagrant道をDockerコンテナを使った開発にも適用できるようになる．

自分的には，Vagrantfileにコンテナの設定などを再現可能な状態で簡単に残せるのがよい．今までOSXでDocker使うときは，boot2docker initして，VBoxManage modifyvmでポートフォワードして，export DOCKER_HOSTして，などなど一手間あったが，vagrant upだけになる．それだけでも嬉しい．

また，v1.6から任意のディレクトリからVagrantのVMを操作できるようになった（Global Status and Control）ので，ほとんどDockerを扱うような感覚で扱える．

使ってみた

OSX上でざっと触ってみた．最新版(1.6.1)をインストールしておく．

$ vagrant -v
Vagrant 1.6.1

Dockerfile

まずDockerfileの準備．ここでは例としてApacheコンテナを立ち上げる．

FROM ubuntu:12.04

RUN apt-get update
RUN apt-get install -y apache2

ENV APACHE_RUN_USER www-data
ENV APACHE_RUN_GROUP www-data
ENV APACHE_LOG_DIR /var/log/apache2

RUN echo 'Hello, vagrant docker provider' > /var/www/index.html

EXPOSE 80
ENTRYPOINT ["/usr/sbin/apache2"]
CMD ["-D", "FOREGROUND"]

Vagrantfile

次にコンテナ用のVagrantfileを準備する．

Vagrant.configure("2") do |config|
    config.vm.provider "docker" do |d|
        d.build_dir = "."
    end
    config.vm.network :forwarded_port, guest: 80, host: 8080
end

やっているのは，

  • カレントディレクトリ（.）のDockerfileをもとにイメージをビルド
  • そのイメージからコンテナの立ち上げ

コンテナの立ち上げの際は，Proxy VMの8080ポートをコンテナの80ポートにフォワードする．

Linuxの場合は得に意識する必要はないけど，OSXの場合は，このVagrantfileはProxy VMから見たコンテナというのを意識しないといけない．ポートフォワードは，Proxy VMからコンテナへのポートフォーワードで，OSXからではない．

後述するがOSXからコンテナに直接アクセスするには，Proxy VMのためのVagrantfileが必要になる．

vagrant up

あとは，いつも通りに立ち上げるだけ．

$ vagrant up --provider=docker

これを実行すると，VagrantはProxy VM（boot2docker box）のインストールと起動，Dockerイメージのビルド，コンテナの起動までをよしなにやってくれる．

global statusを見てみると，VMとコンテナの両方が起動しているのが確認できる．

$ vagrant global-status
2bb2281  default virtualbox running   /Users/deeeet/.vagrant.d/data/docker-host
4f5f9d8  default docker     preparing /Users/deeeet/dev/sample/

コンテナの操作には，以下のコマンドが使える．

  • vagrant reloadでDockerfileの再ビルドを実行する
  • vagrant docker-logsで立ち上がったコンテナのログを確認する

また，ホスト（OSX）の4243ポートはProxy VMの4243ポートへフォワードされているので，tcp://localhost:4243を介してDockerコマンドを直接叩くこともできる．

Vagrantfile (Proxy VM)

上の例は，コンテナの起動まではちゃんと動作する．しかし，OSXからコンテナにアクセスするといったことができない．というのもOSXからProxy VMのポートフォワードが設定されていないので，そもそも到達しない．

このようにデフォルトのProxy VMにはまだまだ不都合がありそうなので，自分で設定を触れるようにしておく．Docker providerでは，Proxy VMのためのVagrantfileを指定することができる．以下のようにvagrant_vagrantfileを使う．

Vagrant.configure("2") do |config|
    config.vm.provider "docker" do |d|
        d.vagrant_vagrantfile = "proxy-vm/Vagrantfile"
        d.build_dir = "."
    end
    config.vm.network :forwarded_port, guest: 80, host: 8080
end

デフォルトのProxy VMには，以下のVagrantfileが使われいる．

# https://github.com/mitchellh/vagrant/blob/master/plugins/providers/docker/hostmachine/Vagrantfile

Vagrant.configure("2") do |config|
    config.vm.box = "mitchellh/boot2docker"

    config.vm.provider "virtualbox" do |v|
        # On VirtualBox, we don't have guest additions or a functional vboxsf
        # in TinyCore Linux, so tell Vagrant that so it can be smarter.
        v.check_guest_additions = false
        v.functional_vboxsf     = false
    end

    # b2d doesn't support NFS
    config.nfs.functional = false
end

基本は，このVagrantfileを利用し，設定したい内容を追記する．そして，vagrant_vagrantfileでこのVagrantfile指定する形にする．

上の例の場合は，このVagranfileに以下のポートフォワードの設定を追記して起動し直せば，OSXからコンテナのindex.htmlにアクセスすることができるようになる．

config.vm.network :forwarded_port, guest: 8080, host: 8080

雑感

他にもvagrant sshやsyncd folderも使えそう．sshできれば，chefやpuppetのprovisionerをコンテナに流せるし，syncd folderは，Dockerのvolume機能と相性が良さそう．

ただDockerを普通に操作するのと比べて，少し意識を変えないといけない．その辺，もう少し触ってみて様子をみたい．