vagrant 添加带版本号的 box

摘要：为什么一定要强调版本号呢如果使用过的朋友们，那么你就会知道其中的酸爽。注意着的版本号为，下面我们会用到。那么我们该怎么做才能添加正确的版本号呢有两种方案从上面的基础上进行修改通过方式推荐。

众所周知，vagrant 添加 box 需要访问国外的服务器，然而国外的服务器总是那么的慢慢慢.....但是那个速度真的是不想吐槽。所以就有了本地添加 box 的需求，所以就有了以下的内容。

为什么一定要强调版本号呢？如果使用过 Homestead 的朋友们，那么你就会知道其中的酸爽。

以下内容完全从零开始的，如果只是特定问题，可直接跳过会的内容，从问题出看起。

该文章最终的目标是添加一个带版本号的box，效果如下：

初始化一个虚拟机

获取对应的 box 下载地址

使用下载工具下载该 box

初始化一个虚拟机

在 https://app.vagrantup.com 中有很多的 box 可供我们下载使用，你可以搜索你想要的 box，我这里使用的是 centos/7。

$ vagrant init centos/7

在执行上面的目录处会多以下文件：

Vagrantfile 就是 vagrant 的配置文件，我们也可以直接配置该文件对虚拟机进行初始化。

获取对应的 box 下载地址

$ vagrant up 

以上命令用于启动虚拟机，如果你的PC上没有安装过 centos/7（可以通过 vagrant box list 命令查看是否安装过），就会从 https://vagrantcloud.com 去下载 centos/7 ，如果有 centos/7 就会从本机获取。

执行完上面的命令后，会出现以下内容：

Bringing machine "default" up with "virtualbox" provider...
==> default: Box "centos/7" could not be found. Attempting to find and install...
    default: Box Provider: virtualbox
    default: Box Version: >= 0
==> default: Loading metadata for box "centos/7"
    default: URL: https://vagrantcloud.com/centos/7
==> default: Adding box "centos/7" (v1809.01) for provider: virtualbox
    default: Downloading: https://vagrantcloud.com/centos/boxes/7/versions/1809.01/providers/virtualbox.box
    default: Download redirected to host: cloud.centos.org
    default:

注意上面的 default: Downloading ... 后面紧跟着有一个 url 地址，那个就是 centos/7 box的下载地址。

注意着的版本号为： v1809.01，下面我们会用到。

使用下载工具下载该 box

作者这里使用的是：迅雷极速版。当然你们也可以使用其他的下载工具。

在vagrant的命令中，我们可以知道vagrant box add [options] 这个一个命令。我们

进入到 virtualbox.box 下载目录，并执行以下内容：

vagrant box add centos/7 ./virtualbox.box

然后我们使用以下命令查看：

$ vagrant box list
centos/7          (virtualbox, 0)

我们可以看到 centos/7 已经添加到了本地，那么这个有什么问题呢？

问题

注意到 (virtualbox, 0)，这个 0 就是指的版本号，这跟它真是的版本号不符。

那么我们该怎么做才能添加正确的版本号呢？有两种方案：

从上面的基础上进行修改；

通过 metadata.json 方式（推荐）。

作者使用的是 win10操作系统，对使用 Mac OS的朋友们的情况不是很清楚。

打开 资源管理器 （俗称我的电脑），在你的 C 盘下的用户名下有一个 .vagrant.d/boxes 目录，添加的 box 会加载到这来，结果如下：

这里的 centos-VAGRANTSLASH-7 就是我们刚才添加的 box，打开目录：

这里的 0 就是版本号，我将它修改为： 1809.01 （上面有记载），然后使用命令查看：

$ vagrant box list
centos/7          (virtualbox, 1809.01)

注意到上面的版本号，就由原来的 0 变成了现在的 1809.01。

如果执行过 常规方案 的，使用以下方式清除 box：
$ vagrant box remove centos/7

首先进入到 box 的下载目录，新建一个文件 metadata.json：

{
    "name": "centos/7",
    "versions": [{
        "version": "1809.01",
        "providers": [{
            "name": "virtualbox",
            "url": "./virtualbox.box"
        }]
    }]
}

name添加的box名字

version：版本号

providers.name：虚拟主机类型

providers.url：box地址

metadata.json准备完成后，执行以下命令添加：

$ vagrant box add metadata.json

输出以下结果：

==> box: Loading metadata for box "metadata.json"
    box: URL: file://D:/vagrant/box/metadata.json
==> box: Adding box "centos/7" (v1809.01) for provider: virtualbox
    box: Downloading: ./centos7.box
    box:
==> box: Successfully added box "centos/7" (v1809.01) for "virtualbox"!

查看添加的 box 列表：

$ vagrant box list
centos/7          (virtualbox, 1809.01)

就此，整篇文档就到此结束了，我们总结下要领：

使用常规方法添加时，需要正确的找到 .vagrant.d/boxes ，并确认刚才添加的 box，最后进行版本修改；

使用metadata.json方式，注意整个 metadata.json 中不能有注释的内容，注意各个参数的准确性。