❤️《Vagrant官方中文文档》❤️ ⑤ 命令行界面之 Plugin（插件）

Posted 2021-09-07 Lucifer三思而后行

以下为个人翻译，包含个人一些截图，本打算自用，现分享给大家，欢迎👏🏻纠错~

Vagrant中文文档

• Plugin
• • Plugin Expunge
  • Plugin Install
  • Plugin License
  • Plugin List
  • Plugin Repair
  • Plugin Uninstall
  • Plugin Update

Plugin

命令： vagrant plugin

用于管理插件的命令。

此命令的主要功能通过子命令来使用：

• expunge
• install
• license
• list
• repair
• uninstall
• update

Plugin Expunge

命令： vagrant plugin expunge

这将删除所有用户安装的插件信息。 删除所有插件 gem、它们的依赖项和 plugins.json 文件。 此命令提供了一种简单的机制来完全删除所有用户安装的自定义插件。

升级 Vagrant 时，由于内部不兼容，可能需要重新安装插件。expunge 命令可以通过尝试自动重新安装当前配置的插件来帮助简化该过程：

# Delete all plugins and reinstall
$ vagrant plugin expunge --reinstall

子命令选项：

• --force： 删除前不提示确认
• --global-only： 只删除全局插件
• --local： 在本地项目中包含的插件
• --local-only： 只删除本地项目插件
• --reinstall： 删除后尝试重新安装插件

Plugin Install

命令：vagrant plugin install <name>...

该命令将安装具有给定名称或文件路径的插件。 如果名称不是文件的路径，则插件是从远程存储库安装的，通常是 RubyGems。 如果插件已经安装，此命令还将更新插件，但您也可以使用 vagrant 插件更新。

# Installing a plugin from a known gem source
vagrant plugin install my-plugin

# Installing a plugin from a local file source
vagrant plugin install /path/to/my-plugin.gem

如果指定多个名称，将安装多个插件。 如果下面给出了标志，则这些标志将应用于当前命令调用正在安装的所有插件。

如果插件已安装，此命令将使用可用的最新版本重新安装它。

子命令选项：

• --entry-point ENTRYPOINT： 默认情况下，通过加载与插件同名的初始化文件在内部加载已安装的插件。大多数时候，这是正确的。如果您正在安装的插件有另一个入口点，则可以使用此标志来指定它。
• --local： 仅将插件安装到本地 Vagrant 项目。
• --plugin-clean-sources： 清除目前已定义的所有源。这是一个高级功能。该用例主要用于阻止访问 RubyGems.org 的公司防火墙。
• --plugin-source SOURCE： 添加从中获取插件的源。请注意，这不仅会影响正在安装的单个插件，还会影响所有未来的插件。这是 Vagrant 使用的底层插件安装程序的限制。
• --plugin-version VERSION： 要安装的插件版本。默认情况下，此命令将安装最新版本。您可以使用此标志限制版本。您可以将其设置为特定版本，例如“1.2.3”，也可以将其设置为版本约束，例如“> 1.0.2”。您可以通过逗号分隔多个约束将其设置为更复杂的约束："> 1.0.2, < 1.1.0"（不要忘记在命令行中引用这些）。

Plugin License

命令：vagrant plugin license <name> <license-file>

此命令为专有 Vagrant 插件（例如 VMware Fusion 提供程序）安装许可证。

Plugin List

命令： vagrant plugin list

这列出了所有已安装的插件及其各自安装的版本。 如果在安装插件时为插件指定了版本约束，则该约束也将被列出。 也可能会显示其他特定于插件的信息。

子命令选项：

• --local： 显示本地项目插件。

Plugin Repair

Vagrant 可能无法正确初始化用户安装的自定义插件。 这可能是由于我的插件安装/删除不正确，或者是手动操作插件相关文件（如 plugins.json 数据文件）造成的。 Vagrant 可以尝试自动修复问题。

如果自动修复不成功，参考expunge命令：

• --local： 修复本地项目插件。

Plugin Uninstall

命令：vagrant plugin uninstall <name> [<name2> <name3> ...]

这将卸载具有给定名称的插件。 假设没有其他插件需要它们，插件的任何依赖项也将被卸载。

如果提供了多个插件，则会卸载多个插件。

子命令选项：

• --local： 从本地项目卸载插件。

Plugin Update

命令：vagrant plugin update [<name>]

该命令会更新安装在 Vagrant 中的插件。 如果您在安装插件时指定了版本约束，则此命令将遵守这些约束。 如果要更改版本约束，请使用 vagrant plugin install 重新安装插件。

如果指定了名称，则只会更新该单个插件。 如果指定了未安装插件的名称，则此命令将不会安装它。

子命令选项：

• --local： 从本地项目更新插件。

---

本次分享到此结束啦~

如果觉得文章对你有帮助，点赞、收藏、关注、评论，一键四连支持，你的支持就是我创作最大的动力。