Vagrant 是一款用来构建虚拟开发环境的工具,非常适合 php/python/ruby/java 这类语言开发 web 应用,“代码在我机子上运行没有问题”这种说辞将成为历史。

我们可以通过 Vagrant 封装一个 Linux 的开发环境,分发给团队成员。成员可以在自己喜欢的桌面系统(Mac/Windows/Linux)上开发程序,代码却能统一在封装好的环境里运行,非常霸气。

安装步骤

1. 安装 VirtualBox

虚拟机还是得依靠 VirtualBox 来搭建,免费小巧。
下载地址:https://www.virtualbox.org/wi...

提示:虽然 Vagrant 也支持 VMware,不过 VMware 是收费的,对应的 Vagrant 版本也是收费的

2. 安装 Vagrant 并添加镜像

下载地址:https://www.vagrantup.com/dow... 根据提示一步步安装。

装好以后运行 vagrant box add hashicorp/precise64 添加 Vagrant 官方的 box 镜像。这时将从官网下载名为 hashicorp/precise64 的 box,可能需要等待一段时间。

如果你要其他系统的镜像,可以来这里查询下载:https://atlas.hashicorp.com/b...

提示:如果你因为网络原因添加不了上面的镜像,可以用工具将这些 box 下载下来(下载地址),参照后文的“打包分发”部分进行添加。

3. 初始化开发环境

创建一个开发目录(比如:~/dev),你也可以使用已有的目录,切换到开发目录里,用 hashicorp/precise64 镜像初始化当前目录的环境:

$ cd ~/dev  # 切换目录
$ vagrant init hashicorp/precise64  # 用 hashicorp/precise64 进行 box 初始化
$ vagrant up  # 启动环境

你会看到终端显示了启动过程,启动完成后,我们就可以用 SSH 登录虚拟机了,剩下的步骤就是在虚拟机里配置你要运行的各种环境和参数了。

$ vagrant ssh  # SSH 登录
$ cd /vagrant  # 切换到开发目录,也就是宿主机上的 `~/dev`

~/dev 目录对应虚拟机中的目录是 /vagrant

Windows 用户注意:Windows 终端并不支持 ssh,所以需要安装第三方 SSH 客户端,比如:Putty、Cygwin 等。

其他设置

Vagrant 初始化成功后,会在初始化的目录里生成一个 Vagrantfile 的配置文件,可以修改配置文件进行个性化的定制。

Vagrant 默认是使用端口映射方式将虚拟机的端口映射本地从而实现类似 http://localhost:80 这种访问方式,这种方式比较麻烦,新开和修改端口的时候都得编辑。相比较而言,host-only 模式显得方便多了。打开 Vagrantfile,将下面这行的注释去掉(移除 #)并保存:

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

重启虚拟机,这样我们就能用 192.168.33.10 访问这台机器了,你可以把 IP 改成其他地址,只要不产生冲突就行。

打包分发

当你配置好开发环境后,退出并关闭虚拟机。在终端里对开发环境进行打包:

$ vagrant package

打包完成后会在当前目录生成一个 package.box 的文件,将这个文件传给其他用户,其他用户只要添加这个 box 并用其初始化自己的开发目录就能得到一个一模一样的开发环境了。

添加方法:

假设我们拿到的 box 存放路径是 ~/box/package.box,在终端里输入:

$ vagrant box add hahaha ~/box/package.box  # 添加 package.box 镜像并命名为 hahaha
$ cd ~/dev  # 切换到项目目录
$ vagrant init hahaha  # 用 hahaha 镜像初始化。

集成预安装

从上面这条看下来,你会发现每次都修改了一点点内容,再打包分发给其他用户其实很麻烦。为此 Vagrant 还提供了更为便捷的预安装定制。打开 Vagrantfile 文件末尾处有下面被注释的代码:

config.vm.provision "shell", inline: <<-SHELL
   apt-get update
   apt-get install -y apache2
SHELL

没错,这段代码就是让你在初次运行 vagrant up 后,虚拟机创建过程众自动运行的初始化命令。 取消注释,把要预先安装的 php/mysql/redis 和配置之类的通通都写进去。初始化时这些程序都会根据你写好的方法安装并配置。

如果你不是初次运行,同时又修改了这里的命令,想让系统再次运行这里面的命令,你可以使用 vagrant reload --provision 进行重载。所以在这种情况下,你只要将 Vagrantfile 共享给团队的其他成员就可以了,其他成员运行相同的命令即可,是不是比打包分发要方便许多。

你还可以把要运行的命令单独写在一个文件里存放在相同的目录下,比如 bootstrap.sh

#!/usr/bin/env bash

apt-get update
apt-get install -y apache2
if ! [ -L /var/www ]; then
  rm -rf /var/www
  ln -fs /vagrant /var/www
fi

然后在 Vagrantfile 里这样添加:

Vagrant.configure("2") do |config|
  config.vm.box = "hashicorp/precise64"
  ...

  config.vm.provision "shell", path: "bootstrap.sh"  # 添加这行
end

效果和直接写在 Vagrantfile 是一样的。

常用命令

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

更多内容请查阅官方文档 https://www.vagrantup.com/doc...

注意事项

使用 Apache/Nginx 时会出现诸如图片修改后但页面刷新仍然是旧文件的情况,是由于静态文件缓存造成的。需要对虚拟机里的 Apache/Nginx 配置文件进行修改:

# Apache 配置(httpd.conf 或者 apache.conf)添加:
EnableSendfile off

# Nginx 配置(nginx.conf)添加:
sendfile off;

SegmentFault 团队就是用这种方式统一开发环境的
本篇文章所用程序版本 VirtualBox 5.0.*Vagrant 1.8.*

这有一份我的配置示例,供参考 https://github.com/fenbox/Vag...
如果你有任何疑问,可以在 vagrant 标签下提问:https://segmentfault.com/t/va...

延伸阅读:

如果觉得我的文章对你有用,请随意赞赏
已赞赏

你可能感兴趣的文章

76 条评论
skey · 2013年08月16日

昨天看到教程今天在公司推行了一下vagrant,遇到一个很大的坑,用nginx+php的同学要注意了,一定要把 nginx.conf 里的 sendfile off; 否则静态文件会缓存,具体可以看这里 http://stackoverflow.com/questions/9479117/vagrant-virtualbox-apache2-strange-cache-behaviour

+7 回复

yanyaoer · 2013年08月14日

来试试 docker

+1 回复

jawa · 2014年10月16日

补充(2014/10/14) ,是内存问题,内存跑满了会导致被OS kill掉,加到32G以后问题消失,但是在高IO情况下,还是会造成宿主机down掉。解决中。。。。。

+1 回复

update · 2015年04月17日

vagrant主要配置:

----------------------------------------
  config.vm.provider :virtualbox do |vb|
    #vb.gui = true
    vb.customize ["modifyvm", :id, "--natdnshostresolver1", "on"]
    vb.customize ["modifyvm", :id, "--natdnsproxy1", "on"]
  end
 config.vm.network :private_network, ip: "192.168.10.10"
 config.vm.synced_folder ".", "/vagrant", type: "nfs"
----------------------------------------

reload时候报错:

----------------------------------------
==> default: Machine booted and ready!
==> default: Checking for guest additions in VM...
==> default: Configuring and enabling network interfaces...
==> default: Exporting NFS shared folders...
==> default: Preparing to edit /etc/exports. Administrator privileges will be required...
Password:
==> default: Mounting NFS shared folders...
The following SSH command responded with a non-zero exit status.
Vagrant assumes that this means the command failed!

mount -o 'vers=3,udp' 192.168.10.1:'/Volumes/Data/vagrant-lnmp' /vagrant

Stdout from the command:

Stderr from the command:

mount.nfs: rpc.statd is not running but is required for remote locking.
mount.nfs: Either use '-o nolock' to keep locks local, or start statd.
mount.nfs: an incorrect mount option was specified
----------------------------------------

请教下这个是啥原因 谢谢了

+1 回复

uyuyuy · 2015年06月09日

win7下报错,不知道怎么解决

E:\work\dev>vagrant up
Bringing machine 'default' up with 'virtualbox' provider...
There was an error while executing `VBoxManage`, a CLI used by Vagrant
for controlling VirtualBox. The command and stderr is shown below.

Command: ["list", "hostonlyifs"]

Stderr: VBoxManage.exe: error: Failed to create the VirtualBox object!
VBoxManage.exe: error: Code E_INVALIDARG (0x80070057) - One or more arguments ar
e invalid (extended info not available)
VBoxManage.exe: error: Most likely, the VirtualBox COM server is not running or
failed to start.

+1 回复

selfrebuild · 2015年08月14日

我的问题解决了...并不是vagrant的问题.
我的Mac机用户根目录 /Users/XXX/.ssh目录下,有个错误的config配置文件.(该配置文件,我也不记得是怎么遗留出来的.)
/Users/XXX/.ssh $ ls
authorized_keys iKey id_boot2docker.pub id_rsa.pub
config id_boot2docker id_rsa known_hosts

而该无效的config文件内容如下:

$ cat config
Host 127.0.0.1
hostname ubuntu
user root

这里不小心把hostname改成ubuntu.导致和vagrant ssh 命令冲突.
之前的报错一直是:

$ vagrant ssh
ssh: Could not resolve hostname ubuntu: nodename nor servname provided, or not known

====================================

解决办法:
删除该config文件,就可以正常使用vagrant ssh连入虚拟机.

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

 * Documentation:  https://help.ubuntu.com/
Last login: Thu Feb 12 10:37:57 2015 from 10.0.2.2
vagrant@vagrant:~$ ls
setuptools-12.1.zip

====================================

faint.
这个问题,恐怕会坑死无数人.不记得当初为何配置这个config了.

以后配置vagrant,一定要特别注意检查自己的/Users/XXX/.ssh目录,是否有无效的SSH配置文件.
记得删 删 删 ! ! !

+1 回复

fenbox 作者 · 2013年08月14日

哥,来写篇 docker 的教程如何?

回复

yanyaoer · 2013年08月14日

我就在mac上跑了下教程 =.= 没敢用到生产环境

回复

fenbox 作者 · 2013年08月16日

嗯,我也是这么解决的

回复

skey · 2013年08月16日

@fenbox 抱歉没有仔细看到最后的注意事项,目前我们团队已经用上Vagrant了,针对目前遇到更新配置的问题,期待再讲一课主讲puppet配合Vagrant进行使用的教程

回复

lidashuang · 2013年08月23日

我在win下用VirtualBox,感觉磁盘io很慢

回复

fenbox 作者 · 2013年08月23日

Windows 下不知道有没有开启 NFS 的方法,官方文档说好像不行 http://docs.vagrantup.com/v2/synced-folders/nfs.html

回复

KK_Zhang · 2013年09月09日

在虚拟机里跑,也可以走断点吗(´・_・`)

回复

fenbox 作者 · 2013年09月09日

有些 IDE,比如 phpstorm,pycharm 这种专门提供了 vagrant 的配置,支持断点

回复

KK_Zhang · 2013年09月09日

原来如此,解惑了,谢谢

回复

zealinux · 2013年09月11日

如果队友需要改动box, 比如安装服务器软件, 那么这个重新分发的过程是什么样子的? 你么是用什么方式来使得每个人手上的box是一致的。

回复

fenbox 作者 · 2013年09月11日

如果改动了 box,那就将改动好的 box 得重新打包,其他人用新打包的 box 重定义自己的开发目录即可

回复

ikbear · 2013年09月25日

厨子,厉害啊!

回复

byends · 2013年11月05日

fenbox 大大,我遇到很奇怪的问题,求解答: 我把环境配好,然后 vagrant package 打包,此时的包已经1.46G,原来干净的是310M。 当我把这包拷到别的机器,vagrant box add ... up.. init 后,配置的环境都没了,连安装包都没了,这是为什么呢?

回复

cfanbo · 2013年11月12日

安装好了,但vagrant ssh的时候,总是提示超时被拒绝,连接不上.怎么回事?

回复

载入中...
fenbox fenbox

5.6k 声望

发布于专栏

F3NB0X

在跟谁谁谁谈笑风生呢

42 人关注