vagrant box命令

vagrant box命令

用于管理boxes的命令，比如添加、删除等等。

此命令的功能主要通过以下子命令完成：

• add
• list
• outdated
• prune
• remove
• repackage
• update

Box Add

用法：vargant box add ADDRESS

通过地址添加一个vagrant box，地址可是如下几咱：

• 来自可用Vagrant镜像公共目录中的速记名。
• 文件路径或者可用Vagrant镜像公共目录中提供的URL。
• 一个直接指向box的URL，此种情况下，需要指定–name标志，另处版本管理与升级服务将不可用。

如果在下载过程中出现了错误或者通过Ctrl C出现了中断，下次请求时Vagrant会继续下载，仅在最初下载后24小时之内有效。

Options：

• –box-version VALUE：想要添加的box版本，默认情况下添加最新版本。可以是明确的版本号，也可以是一种比如“>=1.0,<2.0”这样的区间集。
• –cacert CERTFILE：指定用于CA认证的证书，此选项在远程端不是使用标准CA的情况下使用。
• –capath CERTDIR：指定用于CA认证的证书所在的目录，同样用于远程端不是使用标准CA的情况下。
• –cert CERTFILE：当下载时如果需要，指定一个客户端证书。
• –clean：如果使用，Vagrant将会删除原先使用相同URL下载的老的临时文件。此选项在你不想继续原来的下载（比如原先下载的资源内容改变了）时非常有用。
• –force：如果使用，将覆盖存在的同名的box。
• –insecure：如果使用，使用HTTPS的URL时，不验证SSL证书。
• –provider PROVIDER：如果使用，Vagrant将验证你要添加的box的提供者，默认情况下，Vagrant自动检测合适的提供者使用。

Box List

用法：vagrant add list

展示所有安装到Vagrant的boxes。

Box Outdated

用法：vagrant box outdated

此命令告知你你当前所使用的box是否需要更新。如果在其后面添加–global选项，将会检查所有已安装box是否需要更新。

此命令需要网络连接。

Box Prune

用法：vagrant box prune

此命令用于删除已安装box的老旧版本，如果是正在使用的则提示是否确定删除。

可用选项：

• –provider PROVIDER：通过指定提供者删除。
• –dry-run：打印将被删除的boxes。
• –name NAME：指令检查老旧版本的box名称。
• –force：强制删除，正在使用也不提示。

Box Remove

用法：vagrant box remove NAME

从Vagrant中删除匹配指定名字的box。

如果一个box有多个providers，需要使用–provider明确指定提供者。如果一个box有多个版本，可以通过使用–box-version指定要删除的版本，也可以使用–all删除所有。

可用选项：

• –box-version VALUE：指定要删除的box版本。
• –all：表示要删除box的所有版本。
• –force：强制删除，正在使用也不提示。
• –provider VALUE：删除指定提供者对应的box。

Box Repackage

用法：vagrant box repackage NAME PROVIDER VERSION

打包指定的box到当前文件夹，可用于重新发布。指定box的名字、提供者、版本号需要可通过vagrant box list命令检索到。

当你添加一个box时，Vagrant会打开它并内部存储，原始的.box文件是不被保留的。此命令是用于将已安装的box重新打包为.box文件。

Box Update

用法：vagrant box update

此命令用于存在可用更新时更新当前Vagrant环境中的box，也可以通过–box指定单独要更新的box。

如果你只是想查看可用更新，使用 box outdated命令。

可用选项：

• –box VALUE：指定要更新box的名称。
• –provider VALUE：如果使用了–box，此选项控制更新指定提供者的box。只用多个提供者时才使用，不使用–box时此选项无效。