使用Vagrant在Windows下部署开发环境

做Web开发少不了要在本地搭建好开发环境，虽然说目前各种脚本都有对应的Windows版，甚至是一键安装包，但很多时候和Windows环境的相性并不是那么好，各麻烦的问题是实际部署的环境通常是Linux，常常还要面临着开发和部署环境不一致，上线前还要大量的调试。更要命的是，如果有很多机器需要装的话，那就真是一个灾难了。

Windows下玩Linux少不了虚拟机，但装系统依旧是相当费事。在现在什么都在自动化的今天，Vagrant就是这么一个神器，基于Ruby开发，使用开源 VirtualBox 作为虚拟化支持，可以轻松的跨平台部署。

今天试着把几台机器的环境都换成Vagrant，很爽很顺畅，于是就试着整理了一下使用小结：

目前所选用的是当前的最新版本Vagrant 1.2.7 （对应的Vagrantfile V2版），VirtualBox 使用的是 4.2.16

准备工作：

下载安装 VirtualBox ：https://www.virtualbox.org/

下载安装 Vagrant ：http://www.vagrantup.com/

下载需要使用的 box ：

官方提供的范例：http://files.vagrantup.com/precise32.box

还可以在 http://www.vagrantbox.es/ 这里下载更多不同系统甚至是已经配置好环境直接可以用的box，虽然可以直接在Vagrant直接使用网址，由Vagrant自动下载安装，但是考虑到网络情况，还是建议自行先下载好。

由于习惯用CentOS，于是我就下了CentOS 6.3 x86_64 minimal，这个Box根据个人情况进行选择即可。

设置环境：

安装完成并且重启好系统之后就可以开始设置环境了。

首先在本地创建好工作目录，并在命令行下切换到对应目录

vagrant box add base CentOS-6.3-x86_64-minimal.box

base 表示指定默认的box，也可以为box指定名称，比如 centos63 ，使用base时，之后可以直接使用 vagrant init 进行初始化，如果自行指定名称，则初始化的时候需要指定box的名称。

CentOS-6.3-x86_64-minimal.box 是box对应的文件名，这里可以是本地保存box的路径，也可以是可以下载box的网址，如果是网址的话，Vagrant会自动启动下载。

[vagrant] Downloading with Vagrant::Downloaders::File...
[vagrant] Copying box to temporary location...
[vagrant] Extracting box...
[vagrant] Verifying box...
[vagrant] Cleaning up downloaded box...

设置好box之后，在当前工作目录运行

vagrant init

生成对应的Vagrantfile。通过文本编辑器打开Vagrantfile可以进行一些进一步的常用配置：

网络配置：

Vagrant的网络有三种模式

1、较为常用是端口映射，就是将虚拟机中的端口映射到宿主机对应的端口直接使用 ，在Vagrantfile中配置：

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

guest: 80 表示虚拟机中的80端口， host: 8080 表示映射到宿主机的8080端口。

2、如果需要自己自由的访问虚拟机，但是别人不需要访问虚拟机，可以使用private_network，并为虚拟机设置IP ，在Vagrantfile中配置：

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

192.168.1.104 表示虚拟机的IP，多台虚拟机的话需要互相访问的话，设置在相同网段即可

3、如果需要将虚拟机作为当前局域网中的一台计算机，由局域网进行DHCP，那么在Vagrantfile中配置：

config.vm.network :public_network

目录映射：

既然是开发环境，那么开发工作肯定还是需要在本地完成，而不是都要进到虚拟机中去完成，虚拟机就好好在后台运行服务就好了，不然就本末倒置了，所以这里就需要使用目录映射功能，将本地的目录映射到虚拟机的对应目录。

默认情况下，当前的工作目录，会被映射到虚拟机的 /vagrant 目录，当前目录下的文件可以直接在 /vagrant 下进行访问，当然也可以在通过 ln 创建软连接，如

ln -fs /vagrant/wwwroot /var/www

来进行目录映射，当然，从自动化配置的角度，能不进系统就不需要进系统，所以在Vagrant也可以进行目录映射的操作：

config.vm.synced_folder "wwwroot/", "/var/www"

前面的参数 “wwwroot/”  表示的是本地的路径，这里使用对于工作目录的相对路径，这里也可以使用绝对路径，比如： “d:/www/”

后面的参数 “/var/www” 表示虚拟机中对应映射的目录。

运行脚本：

虽然不是必须，但是如果有需要在启动时运行一些脚本（环境的安装或者有些服务的启动需要在完成目录映射之后进行），可以编辑脚本，类似如下（摘自Vagrant Document）：

#!/usr/bin/env bash

apt-get update
apt-get install -y apache2
rm -rf /var/www
ln -fs /vagrant /var/www

保存在和Vagrantfile相同目录，文件名自取（如 boot.sh），然后在Vagrantfile中添加：

config.vm.provision :shell, :path => "boot.sh"

 当初次使用基本的设置都完成则之后，则可以使用 vagrant up 启动虚拟机


Bringing machine 'default' up with 'virtualbox' provider...
[default] Setting the name of the VM...
[default] Clearing any previously set forwarded ports...
[default] Creating shared folders metadata...
[default] Clearing any previously set network interfaces...
[default] Preparing network interfaces based on configuration...
[default] You are trying to forward to privileged ports (ports < = 1024). Most operating systems restrict this to only privileged process (typicallyprocesses running as an administrative user). This is a warning in case
the port forwarding doesn't work. If any problems occur, please try a port higher than 1024.
&#91;default&#93; Forwarding ports...
&#91;default&#93; -- 22 => <strong>2222</strong> (adapter 1)
[default] -- 80 => 8080 (adapter 1)
[default] Booting VM...
[default] Waiting for VM to boot. This can take a few minutes.
[default] VM booted and ready for use!
[default] The guest additions on this VM do not match the installed version of VirtualBox! In most cases this is fine, but in rare cases it can cause things such as shared folders to not work properly. If you see shared folder errors, please update the guest additions within the virtual machine and reload your VM.

Guest Additions Version: 4.1.18
VirtualBox Version: 4.2
[default] Mounting shared folders...
[default] -- /var/www
[default] -- /vagrant
[default] Running provisioner: shell...

虚拟机启动之后则可以通过 vagrant ssh 联入虚拟机进行进一步的环境配置，或者软件安装相关的工作，在Windows系统下，并不能直接通过 vagrant ssh 连到虚拟机，需要使用 Putty，Xshell 等第三方工具进行连接

连接的IP和端口根据网络环境配置的不同有所不同，如果是默认使用端口映射的话，一般是连接 本地的2222端口。

登录的帐号密码均为 vagrant ，登录之后如果需要 su root ，密码也是 vagrant

注：使用 vagrant ssh 时，会提示可以使用密钥进行登录，如果需要使用putty进行密钥登录的话，需要下载 puttygen 将 ssh 的密钥转换为 ppk 文件才能使用。

登录ssh完成环境的配置，如果在开发环境中使用webserver（nginx/apache）为了避免一些静态文件处理的问题，可能还需要进行一些额外的配置：Vagrant下共享目录静态文件(js/jpg/png等）“缓存”问题

在不进入虚拟机的情况下，还可以使用下面的命令对 虚拟机进行管理：

vagrant up （启动虚拟机）
vagrant halt （关闭虚拟机——对应就是关机）
vagrant suspend （暂停虚拟机——只是暂停，虚拟机内存等信息将以状态文件的方式保存在本地，可以执行恢复操作后继续使用）
vagrant resume （恢复虚拟机 —— 与前面的暂停相对应）
vagrant destroy （删除虚拟机，删除后在当前虚拟机所做进行的除开Vagrantfile中的配置都不会保留）

当在启动Vagrant后，对于虚拟机有进行过安装环境相关的配置，如果并不希望写在Vagrant的启动shell里面每次都重新安装配置一遍，可以将当前配置好的虚拟机打包成box，

vagrant package --output NAME --vagrantfile FILE

可选参数：

--output NAME ： （可选）设置通过NAME来指定输出的文件名

--vagrantfile FILE：（可选）可以将Vagrantfile直接封进box中

注：如果网络模式中使用 private_network 的话，在打包之前需要清除一下private_network的设置，避免不必要的错误：

sudo rm -f /etc/udev/rule.d/70-persistent-net.rules

制作完成之后直接将box文件拿到其他计算机上配置即可使用。

 更多信息可以参考官方文档：http://docs.vagrantup.com/v2/

《使用Vagrant在Windows下部署开发环境》上有20条评论

  4. Linux 学习了一段。。我记的命令太多。。。郁闷。。。要经常用其平台才可以记住。。要不然就要死记硬背了~

    回复

  5. 我想问，1、VirtualBox 直说安装，没讲怎么用？2、使用您的教程中的方法安装vagrant的时候，虚拟机始终无法启动，提示如下：
    ————–
    The guest machine entered an invalid state while waiting for it
    to boot. Valid states are ‘starting, running’. The machine is in the
    ‘poweroff’ state. Please verify everything is configured
    properly and try again.

    If the provider you’re using has a GUI that comes with it,
    it is often helpful to open that and watch the machine, since the
    GUI often has more helpful error messages than Vagrant can retrieve.
    For example, if you’re using VirtualBox, run `vagrant up` while the
    VirtualBox GUI is open.
    ———————————————————–
    感谢回答！

    回复

    1. 因为VirtualBox是Vagrant默认的Provider，所以安装了之后Vagrant就会调用，不需要对VirtualBox进行额外的操作。
      我记述的只是按照我所使用的软件版本和对应的box进行操作之后，能够正常的使用。
      我不太确定是否是因为你所使用的VirtualBox、Vagrant的版本，或者你使用了其他的box，
      建议你按照vagrant的提示，打开VirtualBox的GUI，然后运行vagrant up，查看虚拟机启动具体是在什么时候出现的问题

      回复

  6. D:\vagrant>vagrant up
    Bringing machine ‘default’ up with ‘virtualbox’ provider…
    ==> default: Clearing any previously set network interfaces…
    ==> default: Preparing network interfaces based on configuration…
    default: Adapter 1: nat
    ==> default: Forwarding ports…
    default: 80 => 1234 (adapter 1)
    default: 22 => 2222 (adapter 1)
    ==> default: Booting VM…
    ==> default: Waiting for machine to boot. This may take a few minutes…
    default: SSH address: 127.0.0.1:2222
    default: SSH username: vagrant
    default: SSH auth method: private key
    default: Warning: Connection timeout. Retrying…
    default: Warning: Connection timeout. Retrying…
    default: Warning: Connection timeout. Retrying…
    default: Warning: Connection timeout. Retrying…
    default: Warning: Connection timeout. Retrying…
    default: Warning: Connection timeout. Retrying…
    default: Warning: Connection timeout. Retrying…
    default: Warning: Connection timeout. Retrying…
    我在windows的cmd里执行vagrant up的时候，ssh连不上，我用xshell连的时候输出是下面这样的，然后敲什么都没有反应:
    Connecting to 127.0.0.1:2222…
    Connection established.
    Escape character is ‘^@]’.

    回复

  7. D:\work\vagrant\Homestead>vagrant up
    Bringing machine ‘default’ up with ‘virtualbox’ provider…
    ==> default: Checking if box ‘laravel/homestead’ is up to date…
    ==> default: Clearing any previously set forwarded ports…
    ==> default: Clearing any previously set network interfaces…
    ==> default: Preparing network interfaces based on configuration…
    default: Adapter 1: nat
    default: Adapter 2: hostonly
    ==> default: Forwarding ports…
    default: 80 => 8000 (adapter 1)
    default: 3306 => 33060 (adapter 1)
    default: 5432 => 54320 (adapter 1)
    default: 22 => 2222 (adapter 1)
    ==> default: Running ‘pre-boot’ VM customizations…
    ==> default: Booting VM…
    ==> default: Waiting for machine to boot. This may take a few minutes…
    default: SSH address: 127.0.0.1:2222
    default: SSH username: vagrant
    default: SSH auth method: private key
    default: Warning: Connection timeout. Retrying…
    default: Warning: Connection timeout. Retrying…
    default: Warning: Connection timeout. Retrying…
    default: Warning: Connection timeout. Retrying…
    default: Warning: Connection timeout. Retrying…
    default: Warning: Connection timeout. Retrying…
    default: Warning: Connection timeout. Retrying…
    default: Warning: Connection timeout. Retrying…
    default: Warning: Connection timeout. Retrying…
    default: Warning: Connection timeout. Retrying…
    default: Warning: Connection timeout. Retrying…
    default: Warning: Connection timeout. Retrying…
    default: Warning: Connection timeout. Retrying…
    default: Warning: Connection timeout. Retrying…
    default: Warning: Connection timeout. Retrying…
    default: Warning: Connection timeout. Retrying…
    default: Warning: Connection timeout. Retrying…
    default: Warning: Connection timeout. Retrying…
    default: Warning: Connection timeout. Retrying…
    Timed out while waiting for the machine to boot. This means that
    Vagrant was unable to communicate with the guest machine within
    the configured (“config.vm.boot_timeout” value) time period.

    If you look above, you should be able to see the error(s) that
    Vagrant had when attempting to connect to the machine. These errors
    are usually good hints as to what may be wrong.

    If you’re using a custom box, make sure that networking is properly
    working and you’re able to connect to the machine. It is a common
    problem that networking isn’t setup properly in these boxes.
    Verify that authentication configurations are also setup properly,
    as well.

    If the box appears to be booting properly, you may want to increase
    the timeout (“config.vm.boot_timeout”) value.

    在windows的cmd里执行vagrant up的时候，ssh连不上
    开了“gui”，黑屏.从box查看，也只有一个box，请指点，谢谢

    回复

  8. xp下使用vagrant加载box总是失败

    E:\ubuntu>vagrant box add base precise32.box
    ==> box: Adding box ‘base’ (v0) for provider:
    box: Downloading: file://E:/ubuntu/precise32.box
    box: Progress: 100% (Rate: 27.4M/s, Estimated time remaining: –:–:–)
    The box failed to unpackage properly. Please verify that the box
    file you’re trying to add is not corrupted and try again. The
    output from attempting to unpackage (if any):

    回复
  10. Pingback： 使用Vagrant在Windows下部署开发环境[转] | 学习笔记
  12. Pingback： Vagrant、virtualbox搭建linux开发环境 – 爱游人

  13. 你好。。我网络模式选择了public ，，装了nginx。访问不了。一直拒绝链接，，ssh可以登录上。。遇到过么

    回复

  15. 应该是 bug, 在 stackoverflow 上看了好多解答，最后都没有解决问题。换了 vagrant 最新的版本 ( 1.9.3)后，报错消失了。

    回复

发表回复

您的电子邮箱地址不会被公开。 必填项已用 * 标注