百科.dev
全部条目在线工具AI 编程趋势榜开源项目技术资讯提交条目
登录
< 返回工具列表
V

vagrant-mutate

> 编程语言
开源

将 vagrant 容器转换为与不同提供商兼容

281 stars0 点赞2 次浏览
访问官网GitHub

工具介绍

将 vagrant 容器转换为与不同提供商兼容

Vagrant-Mutate

Vagrant-mutate is a vagrant plugin to convert vagrant boxes to work with different providers.

Maintenance Notice

I am no longer actively maintaining vagrant-mutate. If you are interested in taking over, let me know.

Supported Conversions

  • Virtualbox to kvm
  • Virtualbox to libvirt
  • Virtualbox to bhyve
  • Libvirt to kvm
  • Kvm to libvirt

Compatibility

Vagrant-mutate 0.3 and later requires Vagrant 1.5. If you are using an older vagrant, install vagrant-mutate version 0.2.6.

Installation

qemu-img and libvirt development

First, you must install qemu-img and the libvirt development libraries. Information on supported versions is listed at QEMU Version Compatibility.

Debian and derivatives

apt-get install qemu-utils libvirt-dev ruby-dev

Red Hat and derivatives

bash
yum install qemu-img libvirt-devel rubygem-ruby-libvirt ruby-devel redhat-rpm-config

OS X

QEMU and libvirt are available from homebrew

Windows

Download and install it from Stefan Weil or compile it yourself.

vagrant-mutate

Now you're ready to install vagrant-mutate. To install the latest released version simply run

vagrant plugin install vagrant-mutate

To install from source, clone the repository and run rake build. That will produce a gem file in the pkg directory which you can then install with vagrant plugin install.

Usage

The basic usage is

vagrant mutate box-name-or-file-or-url output-provider

For example, if you wanted to download a box created for virtualbox and add it to vagrant for libvirt

vagrant mutate http://files.vagrantup.com/precise32.box libvirt

Or if you had already downloaded it

vagrant mutate precise32.box libvirt

Or if you had already added the box to vagrant and now want to use it with libvirt

vagrant mutate precise32 libvirt

The latter syntax works for boxes you added from Vagrant Cloud or Atlas too. If you have installed multiple versions of these boxes, vagrant-mutate will always use the latest one.

$ vagrant box list
hashicorp/precise64  (virtualbox, 1.1.0)
$ vagrant mutate hashicorp/precise32 libvirt

If you have a box for multiple providers, you must specify the provider to use for input using the --input-provider option, e.g.

$ vagrant box list
precise32  (kvm)
precise32  (virtualbox)
$ vagrant mutate --input-provider=virtualbox precise32 libvirt

To export a box you created with vagrant mutate, just repackage it, e.g.

vagrant box repackage precise32 libvirt

If you want to force the output box to use virtio for the disk interface, no matter what interface the input box used, use the --force-virtio option.

Debugging

vagrant and vagrant-mutate will output lots of information as they run if you set the VAGRANT_LOG environment variable to INFO. See here for information on how to do that on your operating system.

If you experience any problems, please open an issue on github.

Contributing

Contributions are welcome! I'd especially like to see support for converting between more providers added.

To contribute, follow the standard flow of

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Make sure the acceptance tests pass (ruby test/test.rb)
  5. Push to the branch (git push origin my-new-feature)
  6. Create new Pull Request

Even if you can't contribute code, if you have an idea for an improvement please open an issue.

Issues· 21 开放

查看全部 Issues在 GitHub 打开

暂无开放 Issues,或尚未同步最近议题。

> 标签

Ruby

暂无评论,来聊聊你的看法吧

> 工具信息

发布日期2026年8月1日
最后更新2026年9月18日
分类编程语言
定价开源

> 相关工具

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言