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 时会出现诸如图片修改后但页面刷新仍然是旧文件的情况,是由于 VirtualBox 的一个 BUG 造成的。需要对虚拟机里的 Apache/Nginx 配置文件进行修改:
- # Apache 配置(httpd.conf 或者 apache.conf)修改:
- EnableSendfile off
- # Nginx 配置(nginx.conf)修改:
- sendfile off;