Vagrant 是一个可创建轻便、可复用的虚拟开发环境的跨平台工具,通过打包分可使所有开发成员使用统一的开发环境。

下面是我自己记录配置 Vagrant 的过程。

1、安装 VirtualBox

略。(Vagrant 也支持 VMware,不过需要收费)

2、安装 Vagrant

略。安装完成后在 CMD 输入 vagrant --version 可输出版本。

* 更改 Vagrant Box 镜像存储位置

当镜像文件较多或C盘空间较少时,就需要更改它的存放位置。默认存放在 C:\User\%USERNAME%\.vagrant.d

将 .vagrant.d 移到新位置,打开 CMD,输入

setx VAGRANT_HOME "X:/your/path/to/.vagrant.d"

将 VAGRANT_HOME 添加到用户环境变量。如果要对所有用户生效,那么可以添加到系统环境变量,在末尾加 /M 参数。

重新打开 CMD,输入 echo %VAGRANT_HOME%,将输出设置好的路径。

另外 VirtualBox 虚拟机文件默认也保存在系统盘,可以在 VirtualBox 设置中更改路径。

这里要区分两个概念:Box(镜像) 和 Machine(虚拟机)。他们的关系如同类与对象之间的关系,前者是模板,后者是实例。

3、下载 Box 镜像

我们需要一个基础 Box 镜像来构建 Vagrant 开发环境。

在这里查找你需要的系统镜像:https://atlas.hashicorp.com/boxes/search

我选择的是 ubuntu/trusty64,在 CMD 输入 vagrant box add ubuntu/trusty64 即可下载。

由于某些网络环境因素,下载速度可能很慢,可以选择搭梯子或到这里(https://github.com/chef/bento)用下载工具下载。

下载完成后,导入下载好的 Box 镜像到 Vagrant,等待一段时间。

vagrant box add ubuntu14. K:\YourPath\ubuntu-14.04.box

这里的 ubuntu14.04 是 Box 名称,配置 Vagrantfile 要用到。

输入 vagrant box list 可列出已导入的 Box 镜像。

4、初始化开发环境

新建一个虚拟开发环境的工作目录,CMD 切换到该路径(当没有切换路径时,部分 Vagrant CLI 命令需要附加虚拟机 ID 或 Name)。输入

vagrant init

将在文件夹下创建一个 Vagrantfile,是一个配置文件,用文本编辑器打开。

Vagrantfile 是用 Ruby 写的,不过我们没必要专门去了解它的语法知识,要修改的只是一些简单的变量赋值语句。

简单说明一下其中一些参数。

config.vm.box: Box 名称,必须是一个已导入的 Box 或公共 Box 镜像的简称。

config.vm.hostname: 虚拟机的主机名,注意命名规范。

config.vm.synced_folder: 主机与虚拟机的同步目录,可以共享文件。

config.vm.synced_folder "./data", "/vagrant_data"

第一个参数是主机的目录路径,这里是相对路径。第二个是虚拟机的目录路径,必须是绝对路径。

config.vm.network: 网络相关设置,主要有三种方式:端口映射(FORWARDED PORTS),私有网络(PRIVATE NETWORKS),公共网络(PUBLIC NETWORKS)。详细信息参见 Vagrant 文档。

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

表示将虚拟机的80端口映射到宿主机的8080端口。

配置完成后,用 vagrant up 启动虚拟机。

注意输出信息中有一行:

default:  (guest) =>  (host) (adapter )

表示将虚拟机的 22 端口映射到宿主机的 2222 端口,这个是 SSH 连接的端口号。这个端口号可以在 Vagrantfile 中配置。

最后找个ssh客户端连接到虚拟机:

vagrant halt 关闭虚拟机。

5、日常使用

打开 CMD,任意目录下输入 vagrant global-status 即可列出所有虚拟机。

>vagrant global-status
id name provider state directory
-------------------------------------------------------------------------
3d51pc7 default virtualbox poweroff K:/YourPath/ubuntu14.04

启动输入 vagrant up 虚拟机id

id 不必完整,但要求标识有唯一性,类似 git 的 commit id 的作用。由于我只有一个虚拟机,所以 id 部分输入 3d 即可。

>vagrant up 3d
Bringing machine 'default' up with 'virtualbox' provider...
==> default: Clearing any previously set forwarded ports...
==> default: Clearing any previously set network interfaces...
==> default: Preparing network interfaces based on configuration...
(后面省略)

日常使用时,慎用 apt-get update、yum update 等更新系统,可能会导致无法挂载共享文件夹,需重装 VirtualBox Guest Additions 。

05-07 15:47