使用Vagrant配置Web开发环境

Web开发时无法回避的第一个问题就是开发环境的配置. 不同的平台(Mac OS X, *nix, Windows)在配置开发环境时具体流程繁简不一, 甚至面临开发与生产环境不一致的问题.
Vagrant提供了一种简单可移植的方式来配置虚拟开发环境, 开发环境可以被打包分发到不同的平台使用, 保证了开发环境的统一, 节约了开发者的生命.

"代码在我机子上运行没有问题" ("But it works on my machine")之类的说辞将成为历史.

• 本文所用平台与版本为 OS X 10.11, VirtualBox 5.0.6, Vagrant 1.7.4

安装

1. 安装VirtualBox
   Vagrant支持多种虚拟化方式, 包括: VirtualBox, VMware, Docker...
   本文将以VirtualBox为例
   下载地址: https://www.virtualbox.org/wiki/Downloads

2. 安装Vagrant
   根据不同的平台选择安装包
   下载地址: https://www.vagrantup.com/downloads.html

3. 下载镜像
   Vagrant为开发者提供了许多官方镜像, 无需手动下载.
   但是考虑到国内的下载速度, 还是建议各位开发者自己选择镜像手动下载.
   (如果选择使用Vagrant自动下载官方镜像, 可以跳过本部分第3 4步)
   官方镜像: https://atlas.hashicorp.com/boxes/search
   更多镜像: http://www.vagrantbox.es/

4. 添加下载的镜像到Vagrant
   如果我们将镜像保存到了路径~/Downloads/trusty64.box
   运行以下命令将添加镜像到Vagrant

$ vagrant box add myimage ~/Downloads/trusty64.box

myimage是我们为该box指定的名称, ~/Downloads/trusty64.box是我们存放box的路径
添加成功后运行以下命令, 将列出本机上所有镜像

$ vagrant box list
myimage (virtualbox, 0)

5. 初始化环境
   运行以下命令将初始化环境

$ mkdir ~/myapp
$ cd ~/myapp
$ vagrant init myimage

~/myapp是工作目录, myimage是上一步中添加的镜像
运行以上命令后, 终端会有以下结果, ~/myapp目录会得到一个配置文件Vagrantfile

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.

如果想要直接使用官方镜像(如 Ubuntu 14.04), 可以运行

$ vagrant init ubuntu/trusty64

ubuntu/trusty64是官方提供的Ubuntu 14.04镜像, 启动Vagrant之后, 将会自动从官方源下载该镜像.

6. 启动Vagrant
   运行以下命令将启动vagrant

$ vagrant up

终端中将会显示启动的各种信息, 稍等半分钟之后, 启动完成. 可以通过SSH的方式登录Vagrant虚拟机

$ vagrant ssh

随即进入到了Ubuntu虚拟机的终端
~/myapp在虚拟机中对应的路径是/vagrant
本文使用的平台是 OS X, 但是也在许多其他博文中看到因为Windows不支持SSH, 在Windows平台下运行vagrant ssh会失败, 需要安装第三方SSH客户端, 如Putty, Cygwin.
有关Windows配置SSH的参考文章:

• http://stackoverflow.com/questions/9885108/ssh-to-vagrant-box-in-windows
• http://blog.smdcn.net/article/1308.html

配置

可以通过对Vagrantfile的修改以满足不同的需求

端口映射

将虚拟机的端口映射至宿主机
修改Vagrantfile文件, 将下面这行注释去掉(删去#), 并保存

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

重启虚拟机之后, 访问宿主机的8080端口则会访问到虚拟机的80端口

私有网络

修改Vagrantfile文件, 将下面这行注释去掉(删去#), 并保存

config.vm.network "private_network", ip: "192.168.33.10"

虚拟机将的ip将被指定为192.168.33.10, 可以通过访问该ip的方式来访问虚拟机

打包

关闭虚拟机后运行如下命令将打包

$ vagrant package --output myimage.box --vagrantfile Vagrantfile

当前目录下的虚拟机将包含Vagrantfile一同被打包为myimage.box
如果将myimage.box复制给其他安装有满足条件的Vagrant与VirtualBox的用户, 并初始化, 就可以得到完全相同的开发环境

常用命令

$ vagrant init  # 初始化
$ vagrant up  # 启动虚拟机
$ vagrant halt  # 关闭虚拟机
$ vagrant reload  # 重启虚拟机
$ vagrant ssh  # SSH 至虚拟机
$ vagrant status  # 查看虚拟机运行状态
$ vagrant destroy  # 销毁当前虚拟机

更多命令请查阅官方文档: https://docs.vagrantup.com/v2/cli/index.html

常见问题

• Apache2/Nginx共享目录静态文件被缓存: http://stackoverflow.com/questions/9479117/vagrant-virtualbox-apache2-strange-cache-behaviour

参考文章

• 更多内容请查阅官方文档: https://docs.vagrantup.com/v2/
• 个人Github: https://github.com/Silence-WWT