vagrant box

这是用于管理(添加、删除等)boxes的命令。

box 是一个打包好的操作系统，是一个后缀名为 .box 的文件，其实是一个压缩包，里面包含了 Vagrant 的配置信息和 VirtualBox 的虚拟机镜像文件

查看现在本机上所拥有的box：

userdeMBP:~ user$ vagrant box listhashicorp/precise64 (virtualbox, 1.1.0)

 现在本机上有hashicorp/precise64这个box

查看命令vagrant box下的子命令有：

https://www.vagrantup.com/docs/cli/box.html

 

1》add

格式：

vagrant box add [options] 
     

添加一个box到本地

userdeMBP:~ user$ vagrant box add -hUsage: vagrant box add [options] 
     
      Options:    -c, --clean                      Clean any temporary download files清除任何临时下载文件    -f, --force                      Overwrite an existing box if it exists如果存在，覆盖现有的box        --insecure Do not validate SSL certificates 不验证SSL证书 --cacert FILE CA certificate for SSL download 用于SSL下载的CA证书 --capath DIR CA certificate directory for SSL download 用于SSL下载的CA证书目录 --cert FILE A client SSL cert, if needed 如果需要，客户端SSL证书 --location-trusted Trust 'Location' header from HTTP redirects and use the same credentials for subsequent urls as for the initial one HTTP重定向的可信“Location”头，并对后续url使用与初始url相同的凭据 --provider PROVIDER Provider the box should satisfy box满意的Provider，即使用的Provider --box-version VERSION Constrain version of the added box 约束添加的box的版本 The box descriptor can be the name of a box on HashiCorp's Vagrant Cloud,or a URL, or a local .box file, or a local .json file containing the catalog metadata. box描述符，即
      
        可以是HashiCorp vagrant云上的一个box的名称、URL、本地 .box文件或包含目录元数据的本地 .json 文件 The options below only apply if you're adding a box file directly, and not using a Vagrant server or a box structured like 'user/box': 以下选项只适用于你直接添加一个box文件，而不是使用一个vagrant服务器或一个结构类似“user/box”的box: --checksum CHECKSUM Checksum for the box box的校验和 --checksum-type TYPE Checksum type (md5, sha1, sha256) 校验和类型 --name BOX Name of the box 为box起的名字 -h, --help Print this help 打印帮助
      
     

⚠️校验和：

Checksums for versioned boxes or boxes from HashiCorp's Vagrant Cloud: For boxes from HashiCorp's Vagrant Cloud, the checksums are embedded in the metadata of the box. The metadata itself is served over TLS and its format is validated

对于版本化的box或来自HashiCorp vagrant云的box的校验和:

对于来自HashiCorp vagrant云的box，校验和嵌入在box的元数据中。元数据本身是通过TLS提供的，它的格式是经过验证的

 

2》list

格式：

vagrant box list [options]

这个命令列出了安装到Vagrant中的所有boxes

userdeMBP:~ user$ vagrant box list -hUsage: vagrant box list [options]Options:    -i, --box-info                   Displays additional information about the boxes 显示关于这些boxes的其他信息    -h, --help                       Print this help 打印帮助信息

 

3》outdated

格式：

vagrant box outdated [options]

检查正在使用的box是否有可用的新版本。如果传入--global标志，将检查所有boxes是否有更新

检查更新涉及刷新与某个box关联的元数据。这通常需要网络连接

userdeMBP:~ user$ vagrant box outdated -hUsage: vagrant box outdated [options]Checks if there is a new version available for the box that are you are using. If you pass in the --global flag, all boxes will be checked for updates. 检查正在使用的box是否有可用的新版本。如果传入--global标志，将检查所有boxes是否有更新 Options: --global Check all boxes installed 检查所有已安装的boxes --insecure Do not validate SSL certificates 不验证SSL证书 --cacert FILE CA certificate for SSL download 用于SSL下载的CA证书 --capath DIR CA certificate directory for SSL download 用于SSL下载的CA证书目录 --cert FILE A client SSL cert, if needed 如果需要，使用的客户端SSL证书 -h, --help Print this help 打印帮助信息

 

4》prune

格式：

vagrant box prune [options]

此命令删除已安装框的旧版本。如果该箱子目前正在使用，vagrant将要求确认

userdeMBP:~ user$ vagrant box prune -hUsage: vagrant box prune [options]Options:    -p, --provider PROVIDER          The specific provider type for the boxes to destroy. 要销毁的指定提供provider类型的boxes    -n, --dry-run                    Only print the boxes that would be removed. 只打印要删除的boxes        --name NAME                  The specific box name to check for outdated versions. 要检查的指定过时版本的box名字 -f, --force Destroy without confirmation even when box is in use. 即使box在使用中，也要在未经确认的情况下销毁。即强制销毁 -h, --help Print this help 打印帮助信息

 

5》remove

格式：

vagrant box remove 
     

此命令从vagrant中删除与给定名称匹配的box

如果一个box有多个providers，必须要使用--provider标签指定确切的provider；如果一个box有多个版本，你可以使用--box-version标签选择你要删除的版本，或者使用--all标签删除所有版本

userdeMBP:~ user$ vagrant box remove -hUsage: vagrant box remove 
     
      Options:    -f, --force                      Remove without confirmation. 强制删除        --provider PROVIDER          The specific provider type for the box to remove 要删除该指定provider类型的box        --box-version VERSION The specific version of the box to remove 删除该指定版本的box --all Remove all available versions of the box 删除box的所有可用版本 -h, --help Print this help 打印帮助信息
     

 

6》repackage

格式：

vagrant box repackage 
      
       
       
      
     

这个命令重新打包给定的box，并将其放到当前目录中，以便你可以重新分发它。可以使用vagrant box list命令检索该box的名称、provider和版本。

当你添加一个box时，Vagrant会将其解包并存储在内部。原来的*.box文件不保存。这个命令对于从安装的vagrant box 回收*.box文件非常有用。

只有-h,--help 这个option

 

7》update

格式：

 

vagrant box update [options]

如果在当前vagrant环境下有可用的更新，此命令将对box进行更新。该命令还可以通过指定--box标志更新特定的框(在活动的vagrant环境之外)。

请注意，更新此box不会更新已经运行的vagrant机器。为了反映box里的变化，你必须摧毁并重新启动这台vagrant机器

如果你只是想检查是否有可用的更新，请使用vagrant box outdated命令

userdeMBP:~ user$ vagrant box update -hUsage: vagrant box update [options]Updates the box that is in use in the current Vagrant environment,if there any updates available. This does not destroy/recreate the machine, so you'll have to do that to see changes.如果有可用的更新，则更新当前vagrant环境中使用的box。这不会破坏/重新创建机器，所以你必须这样做才能看到更改。To update a specific box (not tied to a Vagrant environment), use the --box flag.要更新特定的框(不绑定到vagrant环境)，请使用--box标志Options:        --box BOX                    Update a specific box 更新指定的box        --provider PROVIDER          Update box with specific provider 更新指定provider的box    -f, --force                      Overwrite an existing box if it exists 只要存在就强制复写该存在的box        --insecure                   Do not validate SSL certificates 不验证SSL证书        --cacert FILE                CA certificate for SSL download 用于SSL下载的CA证书        --capath DIR                 CA certificate directory for SSL download 用于SSL下载的CA证书目录        --cert FILE                  A client SSL cert, if needed 如果需要，使用的客户端SSL证书    -h, --help                       Print this help 打印帮助信息